Package java.security.acl

Interface AclEntry

All Superinterfaces:
Cloneable
public interface AclEntry
extends Cloneable
The Access Control List Entry interface definition.

An AclEntry is a list of the Permissions that are granted (positive) or denied (negative) to a Principal.

  • Method Details

    • setPrincipal

      boolean setPrincipal​(Principal user)
      Set the principal for this ACL entry.

      The principal for an ACL entry can only be set once.

      Parameters:
      user - the principal for this ACL entry.
      Returns:
      true on success, false if there is a principal already set for this entry.

    • getPrincipal

      Principal getPrincipal()
      Returns the principal of this ACL entry.
      Returns:
      the principal of this ACL entry, or null if none is set.

    • setNegativePermissions

      void setNegativePermissions()
      Sets this ACL entry to be negative.

      The permissions in this ACL entry will be denied to the principal associated with this entry.

      Note: An ACL entry is positive by default and can only become negative by calling this method.

    • isNegative

      boolean isNegative()
      Returns whether this ACL entry is negative.
      Returns:
      true if this ACL entry is negative, false if it's positive.

    • addPermission

      boolean addPermission​(Permission permission)
      Adds the specified permission to this ACL entry.
      Parameters:
      permission - the permission to be added.
      Returns:
      true if the specified permission is added, false if the permission was already in this entry.

    • removePermission

      boolean removePermission​(Permission permission)
      Removes the specified permission from this ACL entry.
      Parameters:
      permission - the permission to be removed.
      Returns:
      true if the permission is removed, false if the permission was not in this entry.

    • checkPermission

      boolean checkPermission​(Permission permission)
      Checks whether the specified permission is in this ACL entry.
      Parameters:
      permission - the permission to check.
      Returns:
      true if the permission is in this entry, otherwise false.

    • permissions

      Enumeration<Permission> permissions()
      Returns the list of permissions of this ACL entry.
      Returns:
      the list of permissions of this ACL entry,

    • toString

      String toString()
      Returns the string representation of this ACL entry.
      Overrides:
      toString in class Object
      Returns:
      the string representation of this ACL entry.

    • clone

      Object clone()
      Clones this ACL entry instance.
      Returns:
      a copy of this entry.