java.security.acl
Interface Acl
java.lang.Object
|
+--java.security.acl.Owner
|
+--java.security.acl.Acl
All Implemented Interfaces:
Owner
public interface
Aclimplements
Owner A Java access control list (ACL) is a group of individual ACL entries.
These entries consist of a
Principal
and a list of
permissions this
Principal
is either granted or denied.
A given
Principal
can have at most one positive ACL entry
(i.e., one that grants permissions) and one negative ACL entry (i.e., one
that denies permissions). If a given permission is both granted and
denied, the ACL treats it as if it were never granted or denied. If
both a
Principal
and a
Group
to which the
Principal
belongs have an ACL entry, the permissions for
the individual
Principal
take precedence over the
permissions of the
Group
if there is a conflict.
Owner interface
and so an ACL has owners. Actions which modify the ACL are restricted
to owners.
Author:- Aaron M. Renn (arenn@urbanophile.com)
addEntry
public boolean addEntry(java.security.Principal caller, java.security.acl.AclEntry entry)
This method adds the specified entry to the ACL
Parameters:
Returns:
true
if the entry was added, false
if there is already an entry of the same type for the Principal
.
Throws:
checkPermission
public boolean checkPermission(java.security.Principal user, java.security.acl.Permission perm)
This method tests whether or not the specified Principal
has the specified Permission
Parameters:
Returns:
true
if the user has been granted the permission, false
otherwise
entries
public Enumeration entries()
This method returns a list of all the entries in the ACL as an
Enumeration
.
Returns:
- An enumeration of the ACL entries
getName
public String getName()
This method returns the name of this ACL.
Returns:
getPermissions
public Enumeration getPermissions(java.security.Principal user)
This method returns a list of Permission
's that are granted
to a particular Principal
. This includes any permissions
that are granted to Group
's to which the Principal
belongs unless they are overridden by a negative ACL. This permission
list is returned as an Enumeration
.
Parameters:
Returns:
- A list of permissions for the
Principal
.
removeEntry
public boolean removeEntry(java.security.Principal caller, java.security.acl.AclEntry entry)
This method delets the specified entry from the ACL
Parameters:
Returns:
true
if the entry was deleted, or false
if this entry was not part of the ACL to begin with
Throws:
setName
public void setName(java.security.Principal caller, java.lang.String name)
This method sets the name of the ACL
Parameters:
Throws:
toString
public String toString()
This method returns the ACL as a String
Returns:
- A
String
representation of this ACL
Principal
and a list of permissions thisPrincipal
is either granted or denied. A givenPrincipal
can have at most one positive ACL entry (i.e., one that grants permissions) and one negative ACL entry (i.e., one that denies permissions). If a given permission is both granted and denied, the ACL treats it as if it were never granted or denied. If both aPrincipal
and aGroup
to which thePrincipal
belongs have an ACL entry, the permissions for the individualPrincipal
take precedence over the permissions of theGroup
if there is a conflict.Owner interface and so an ACL has owners. Actions which modify the ACL are restricted to owners.