Added in API level 1
Deprecated in API level 33

AclEntry

public interface AclEntry
implements Cloneable

java.security.acl.AclEntry


This interface was deprecated in API level 33.
This class is deprecated and subject to removal in a future version of Java SE. It has been replaced by java.security.Policy and related classes since 1.2.

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.

See also:

Summary

Public methods

abstract boolean addPermission(Permission permission)

Adds the specified permission to this ACL entry.

abstract boolean checkPermission(Permission permission)

Checks if the specified permission is part of the permission set in this entry.

abstract Object clone()

Clones this ACL entry.

abstract Principal getPrincipal()

Returns the principal for which permissions are granted or denied by this ACL entry.

abstract 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.

abstract Enumeration<Permission> permissions()

Returns an enumeration of the permissions in this ACL entry.

abstract boolean removePermission(Permission permission)

Removes the specified permission from this ACL entry.

abstract void setNegativePermissions()

Sets this ACL entry to be a negative one.

abstract boolean setPrincipal(Principal user)

Specifies the principal for which permissions are granted or denied by this ACL entry.

abstract String toString()

Returns a string representation of the contents of this ACL entry.