| java.security.acl.AclEntry
| AclEntry | | public interface AclEntry extends Cloneable(Code) | | This is the interface used for representing one entry in an Access
Control List (ACL).
An ACL can be thought of as a data structure with multiple ACL entry
objects. Each ACL entry object contains a set of permissions associated
with a particular principal. (A principal represents an entity such as
an individual user or a group). Additionally, each ACL entry is specified
as being either positive or negative. If positive, the permissions are
to be granted to the associated principal. If negative, the permissions
are to be denied. Each principal can have at most one positive ACL entry
and one negative entry; that is, multiple positive or negative ACL
entries are not allowed for any principal.
Note: ACL entries are by default positive. An entry becomes a
negative entry only if the
AclEntry.setNegativePermissions() setNegativePermissions method is called on it.
See Also: java.security.acl.Acl
author:
Satish Dharmaraj |
| Method Summary | |
| public boolean | addPermission(Permission permission)
Adds the specified permission to this ACL entry. | | public boolean | checkPermission(Permission permission)
Checks if the specified permission is part of the
permission set in this entry.
Parameters:
permission - the permission to be checked for. | | public Object | clone()
Clones this ACL entry. | | public Principal | getPrincipal()
Returns the principal for which permissions are granted or denied by
this ACL entry. | | public boolean | isNegative()
Returns true if this is a negative ACL entry (one denying the
associated principal the set of permissions in the entry), false
otherwise. | | public Enumeration | permissions()
Returns an enumeration of the permissions in this ACL entry. | | public boolean | removePermission(Permission permission)
Removes the specified permission from this ACL entry.
Parameters:
permission - the permission to be removed from this entry. | | public void | setNegativePermissions()
Sets this ACL entry to be a negative one. | | public boolean | setPrincipal(Principal user)
Specifies the principal for which permissions are granted or denied
by this ACL entry. | | public String | toString()
Returns a string representation of the contents of this ACL entry. |
| addPermission | | public boolean addPermission(Permission permission)(Code) | | Adds the specified permission to this ACL entry. Note: An entry can
have multiple permissions.
Parameters:
permission - the permission to be associated withthe principal in this entry. true if the permission was added, false if thepermission was already part of this entry's permission set. |
| checkPermission | | public boolean checkPermission(Permission permission)(Code) | | Checks if the specified permission is part of the
permission set in this entry.
Parameters:
permission - the permission to be checked for. true if the permission is part of thepermission set in this entry, false otherwise. |
| clone | | public Object clone()(Code) | | Clones this ACL entry.
a clone of this ACL entry. |
| getPrincipal | | public Principal getPrincipal()(Code) | | Returns the principal for which permissions are granted or denied by
this ACL entry. Returns null if there is no principal set for this
entry yet.
the principal associated with this entry.
See Also: AclEntry.setPrincipal |
| isNegative | | public boolean isNegative()(Code) | | Returns true if this is a negative ACL entry (one denying the
associated principal the set of permissions in the entry), false
otherwise.
true if this is a negative ACL entry, false if it's not. |
| permissions | | public Enumeration permissions()(Code) | | Returns an enumeration of the permissions in this ACL entry.
an enumeration of the permissions in this ACL entry. |
| removePermission | | public boolean removePermission(Permission permission)(Code) | | Removes the specified permission from this ACL entry.
Parameters:
permission - the permission to be removed from this entry. true if the permission is removed, false if thepermission was not part of this entry's permission set. |
| setNegativePermissions | | public void setNegativePermissions()(Code) | | Sets this ACL entry to be a negative one. That is, the associated
principal (e.g., a user or a group) will be denied the permission set
specified in the entry.
Note: ACL entries are by default positive. An entry becomes a
negative entry only if this setNegativePermissions
method is called on it.
|
| setPrincipal | | public boolean setPrincipal(Principal user)(Code) | | Specifies the principal for which permissions are granted or denied
by this ACL entry. If a principal was already set for this ACL entry,
false is returned, otherwise true is returned.
Parameters:
user - the principal to be set for this entry. true if the principal is set, false if there wasalready a principal set for this entry.
See Also: AclEntry.getPrincipal |
| toString | | public String toString()(Code) | | Returns a string representation of the contents of this ACL entry.
a string representation of the contents. |
|
|