Generated by
JDiff

java.security.acl Documentation Differences

This file contains all the changes in documentation in the package java.security.acl as colored differences. Deletions are shown like this, and additions are shown like this.
If no deletions or additions are shown in an entry, the HTML tags will be what has changed. The new HTML tags are shown in the differences. If no documentation existed, and then some was added in a later version, this change is noted in the appropriate class pages of differences, but the change is not shown on this page. Only changes in existing text are shown here. Similarly, documentation which was inherited from another class or interface is not shown here.
Note that an HTML error in the new documentation may cause the display of other documentation changes to be presented incorrectly. For instance, failure to close a <code> tag will cause all subsequent paragraphs to be displayed differently.

Class Acl

Interface representing an Access Control List (ACL). An Access Control List is a data structure used to guard access to resources.

An ACL can be thought of as a data structure with multiple ACL entries. Each ACL entry of interface type AclEntry 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.

The ACL Entries in each ACL observe the following rules:

The java.security.acl package provides the interfaces to the ACL and related data structures (ACL entries groups permissions etc.) and the sun.security.acl classes provide a default implementation of the interfaces. For example java.security.acl.Acl provides the interface to an ACL and the sun.security.acl.AclImpl class provides the default implementation of the interface.

The java.security.acl.Acl interface extends the java.security.acl.Owner interface. The Owner interface is used to maintain a list of owners for each ACL. Only owners are allowed to modify an ACL. For example only an owner can call the ACL's addEntry method to add a new ACL entry to the ACL. @see java.security.acl.AclEntry @see java.security.acl.Owner @see java.security.acl.Acl#getPermissions @version 1.18 0020 01/0212/0203 @author Satish Dharmaraj

Class Acl, String getName()

Returns the name of this ACL. @return the name of this ACL. @see #setName
Class Acl, void setName(Principal, String)

Sets the name of this ACL. @param caller the principal invoking this method. It must be an owner of this ACL. @param name the name to be given to this ACL. @exception NotOwnerException if the caller principal is not an owner of this ACL. @see #getName

Class AclEntry, 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 the principal associated with this entry. @see #setPrincipal
Class AclEntry, boolean setPrincipal(Principal)

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. @param user the principal to be set for this entry. @return true if the principal is set false if there was already a principal set for this entry. @see #getPrincipal