acl.html

API資料大全

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="setName(java.security.Principal, java.lang.String)"><!-- --></A><H3>
setName</H3>
<PRE>
public void <B>setName</B>(<A HREF="../../../java/security/Principal.html">Principal</A>&nbsp;caller,
                    <A HREF="../../../java/lang/String.html">String</A>&nbsp;name)
             throws <A HREF="../../../java/security/acl/NotOwnerException.html">NotOwnerException</A></PRE>
<DL>
<DD>Sets the name of this ACL.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>caller</CODE> - the principal invoking this method. It must be an
 owner of this ACL.<DD><CODE>name</CODE> - the name to be given to this ACL.<DT><B>Throws:</B><DD><CODE><A HREF="../../../java/security/acl/NotOwnerException.html">NotOwnerException</A></CODE> - if the caller principal
 is not an owner of this ACL.</DL>
</DD>
</DL>
<HR>

<A NAME="getName()"><!-- --></A><H3>
getName</H3>
<PRE>
public <A HREF="../../../java/lang/String.html">String</A> <B>getName</B>()</PRE>
<DL>
<DD>Returns the name of this ACL.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>the name of this ACL.</DL>
</DD>
</DL>
<HR>

<A NAME="addEntry(java.security.Principal, java.security.acl.AclEntry)"><!-- --></A><H3>
addEntry</H3>
<PRE>
public boolean <B>addEntry</B>(<A HREF="../../../java/security/Principal.html">Principal</A>&nbsp;caller,
                        <A HREF="../../../java/security/acl/AclEntry.html">AclEntry</A>&nbsp;entry)
                 throws <A HREF="../../../java/security/acl/NotOwnerException.html">NotOwnerException</A></PRE>
<DL>
<DD>Adds an ACL entry to this ACL. An entry associates a principal
 (e.g., an individual or a group) with a set of
 permissions. Each principal can have at most one positive ACL
 entry (specifying permissions to be granted to the principal)
 and one negative ACL entry (specifying permissions to be
 denied). If there is already an ACL entry of the same type
 (negative or positive) already in the ACL, false is returned.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>caller</CODE> - the principal invoking this method. It must be an
 owner of this ACL.<DD><CODE>entry</CODE> - the ACL entry to be added to this ACL.<DT><B>Returns:</B><DD>true on success, false if an entry of the same type
 (positive or negative) for the same principal is already
 present in this ACL.<DT><B>Throws:</B><DD><CODE><A HREF="../../../java/security/acl/NotOwnerException.html">NotOwnerException</A></CODE> - if the caller principal
  is not an owner of this ACL.</DL>
</DD>
</DL>
<HR>

<A NAME="removeEntry(java.security.Principal, java.security.acl.AclEntry)"><!-- --></A><H3>
removeEntry</H3>
<PRE>
public boolean <B>removeEntry</B>(<A HREF="../../../java/security/Principal.html">Principal</A>&nbsp;caller,
                           <A HREF="../../../java/security/acl/AclEntry.html">AclEntry</A>&nbsp;entry)
                    throws <A HREF="../../../java/security/acl/NotOwnerException.html">NotOwnerException</A></PRE>
<DL>
<DD>Removes an ACL entry from this ACL.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>caller</CODE> - the principal invoking this method. It must be an
 owner of this ACL.<DD><CODE>entry</CODE> - the ACL entry to be removed from this ACL.<DT><B>Returns:</B><DD>true on success, false if the entry is not part of this ACL.<DT><B>Throws:</B><DD><CODE><A HREF="../../../java/security/acl/NotOwnerException.html">NotOwnerException</A></CODE> - if the caller principal is not
 an owner of this Acl.</DL>
</DD>
</DL>
<HR>

<A NAME="getPermissions(java.security.Principal)"><!-- --></A><H3>
getPermissions</H3>
<PRE>
public <A HREF="../../../java/util/Enumeration.html">Enumeration</A> <B>getPermissions</B>(<A HREF="../../../java/security/Principal.html">Principal</A>&nbsp;user)</PRE>
<DL>
<DD>Returns an enumeration for the set of allowed permissions for the 
 specified principal (representing an entity such as an individual or 
 a group). This set of allowed permissions is calculated as
 follows:<p>

 <ul>
  
 <li>If there is no entry in this Access Control List for the 
 specified principal, an empty permission set is returned.<p>
 
 <li>Otherwise, the principal's group permission sets are determined.
 (A principal can belong to one or more groups, where a group is a 
 group of principals, represented by the Group interface.)
 The group positive permission set is the union of all 
 the positive permissions of each group that the principal belongs to.
 The group negative permission set is the union of all 
 the negative permissions of each group that the principal belongs to.
 If there is a specific permission that occurs in both 
 the positive permission set and the negative permission set, 
 it is removed from both.<p>

 The individual positive and negative permission sets are also 
 determined. The positive permission set contains the permissions 
 specified in the positive ACL entry (if any) for the principal. 
 Similarly, the negative permission set contains the permissions
 specified in the negative ACL entry (if any) for the principal. 
 The individual positive (or negative) permission set is considered 
 to be null if there is not a positive (negative) ACL entry for the
 principal in this ACL.<p>

 The set of permissions granted to the principal is then calculated 
 using the simple rule that individual permissions always override 
 the group permissions. That is, the principal's individual negative
 permission set (specific denial of permissions) overrides the group 
 positive permission set, and the principal's individual positive 
 permission set overrides the group negative permission set. 
 
 </ul><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>user</CODE> - the principal whose permission set is to be returned.<DT><B>Returns:</B><DD>the permission set specifying the permissions the principal 
 is allowed.</DL>
</DD>
</DL>
<HR>

<A NAME="entries()"><!-- --></A><H3>
entries</H3>
<PRE>
public <A HREF="../../../java/util/Enumeration.html">Enumeration</A> <B>entries</B>()</PRE>
<DL>
<DD>Returns an enumeration of the entries in this ACL. Each element in 
 the enumeration is of type AclEntry.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>an enumeration of the entries in this ACL.</DL>
</DD>
</DL>
<HR>

<A NAME="checkPermission(java.security.Principal, java.security.acl.Permission)"><!-- --></A><H3>
checkPermission</H3>
<PRE>
public boolean <B>checkPermission</B>(<A HREF="../../../java/security/Principal.html">Principal</A>&nbsp;principal,
                               <A HREF="../../../java/security/acl/Permission.html">Permission</A>&nbsp;permission)</PRE>
<DL>
<DD>Checks whether or not the specified principal has the specified 
 permission. If it does, true is returned, otherwise false is returned.
 
 More specifically, this method checks whether the passed permission
 is a member of the allowed permission set of the specified principal.
 The allowed permission set is determined by the same algorithm as is 
 used by the <code>getPermissions</code> method.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>principal</CODE> - the principal, assumed to be a valid authenticated 
 Principal.<DD><CODE>permission</CODE> - the permission to be checked for.<DT><B>Returns:</B><DD>true if the principal has the specified permission, false 
 otherwise.<DT><B>See Also: </B><DD><A HREF="../../../java/security/acl/Acl.html#getPermissions(java.security.Principal)"><CODE>getPermissions(java.security.Principal)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="toString()"><!-- --></A><H3>
toString</H3>
<PRE>
public <A HREF="../../../java/lang/String.html">String</A> <B>toString</B>()</PRE>
<DL>
<DD>Returns a string representation of the 
 ACL contents.<DD><DL>
<DT><B>Overrides:</B><DD><CODE><A HREF="../../../java/lang/Object.html#toString()">toString</A></CODE> in class <CODE><A HREF="../../../java/lang/Object.html">Object</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>a string representation of the ACL contents.</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>

<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_bottom"><!-- --></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/Acl.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<b>Java<sup><font size=-2>TM</font></sup>&nbsp;2&nbsp;Platform<br>Std.&nbsp;Ed. v1.3</b></EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;PREV CLASS&nbsp;
&nbsp;<A HREF="../../../java/security/acl/AclEntry.html"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="Acl.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: &nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->

<HR>
<font size="-1"><a href="http://java.sun.com/cgi-bin/bugreport.cgi">Submit a bug or feature</a><br>For further API reference and developer documentation, see <a href="http://java.sun.com/products/jdk/1.3/devdocs-vs-specs.html">Java 2 SDK SE Developer Documentation</a>. That documentation  contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples. <p>Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.<br>Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road<br>Palo Alto, California, 94303, U.S.A.  All Rights Reserved.</font>
</BODY>
</HTML>