Interface: java.security.acl.AclEntry

  • public interface AclEntry
  • extends Cloneable
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 setNegativePermissions method is called on it.

Authors:
@author Satish Dharmaraj
See:
@see java.security.acl.Acl

Inheritance

Implements:

Methods

  • addPermissiontop

    public boolean addPermission(Permission permission)
    Adds the specified permission to this ACL entry. Note: An entry can have multiple permissions.
    Parameters:
    @param permission the permission to be associated with the principal in this entry.
    Return:
    @return true if the permission was added, false if the permission was already part of this entry's permission set.
    Related Links:
    Google Code Search
    Stack Overflow

  • checkPermissiontop

    public boolean checkPermission(Permission permission)
    Checks if the specified permission is part of the permission set in this entry.
    Parameters:
    @param permission the permission to be checked for.
    Return:
    @return true if the permission is part of the permission set in this entry, false otherwise.
    Related Links:
    Google Code Search
    Stack Overflow

  • clonetop

    public Object clone()
    Clones this ACL entry.
    Return:
    @return a clone of this ACL entry.
    Related Links:
    Google Code Search
    Stack Overflow

  • getPrincipaltop

    public Principal getPrincipal()
    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.
    Return:
    @return the principal associated with this entry.
    See:
    @see java.security.acl.AclEntry.setPrincipal(java.security.Principal)
    Related Links:
    Google Code Search
    Stack Overflow

  • isNegativetop

    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.
    Return:
    @return true if this is a negative ACL entry, false if it's not.
    Related Links:
    Google Code Search
    Stack Overflow

  • permissionstop

    public Enumeration<Permission> permissions()
    Returns an enumeration of the permissions in this ACL entry.
    Return:
    @return an enumeration of the permissions in this ACL entry.
    Related Links:
    Google Code Search
    Stack Overflow

  • removePermissiontop

    public boolean removePermission(Permission permission)
    Removes the specified permission from this ACL entry.
    Parameters:
    @param permission the permission to be removed from this entry.
    Return:
    @return true if the permission is removed, false if the permission was not part of this entry's permission set.
    Related Links:
    Google Code Search
    Stack Overflow

  • setNegativePermissionstop

    public void setNegativePermissions()
    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.
    Related Links:
    Google Code Search
    Stack Overflow

  • setPrincipaltop

    public boolean setPrincipal(Principal user)
    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:
    @param user the principal to be set for this entry.
    Return:
    @return true if the principal is set, false if there was already a principal set for this entry.
    See:
    @see java.security.acl.AclEntry.getPrincipal()
    Related Links:
    Google Code Search
    Stack Overflow

  • toStringtop

    public String toString()
    Returns a string representation of the contents of this ACL entry.
    Return:
    @return a string representation of the contents.
    Related Links:
    Google Code Search
    Stack Overflow