This documentation differs from the official API. Jadeite adds extra features to the API including: variable font sizes, constructions examples, placeholders for classes and methods, and auto-generated “See Also” links. Additionally it is missing some items found in standard Javadoc documentation, including: generics type information, “Deprecated” tags and comments, “See Also” links, along with other minor differences. Please send any questions or feedback to bam@cs.cmu.edu.


java.security.acl
interface AclEntry

All Superinterfaces:
Cloneable

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 {@link #setNegativePermissions() setNegativePermissions} method is called on it.


Method Summary
 boolean

          Adds the specified permission to this ACL entry.
 boolean

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

          Clones this ACL entry.
 Principal

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

          Returns true if this is a negative ACL entry (one denying the associated principal the set of permissions in the entry), false otherwise.
 Enumeration

          Returns an enumeration of the permissions in this ACL entry.
 boolean

          Removes the specified permission from this ACL entry.
 void

          Sets this ACL entry to be a negative one.
 boolean

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

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

Method Detail

addPermission

public boolean addPermission(Permission permission)
Adds the specified permission to this ACL entry. Note: An entry can have multiple permissions.

Parameters:
permission - the permission to be associated with the principal in this entry.
Returns:
true if the permission was added, false if the permission was already part of this entry's permission set.

checkPermission

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.
Returns:
true if the permission is part of the permission set in this entry, false otherwise.

clone

public Object clone()
Clones this ACL entry.

Returns:
a clone of this ACL entry.

getPrincipal

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.

Returns:
the principal associated with this entry.

isNegative

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.

Returns:
true if this is a negative ACL entry, false if it's not.

permissions

public Enumeration permissions()
Returns an enumeration of the permissions in this ACL entry.

Returns:
an enumeration of the permissions in this ACL entry.

removePermission

public boolean removePermission(Permission permission)
Removes the specified permission from this ACL entry.

Parameters:
permission - the permission to be removed from this entry.
Returns:
true if the permission is removed, false if the permission was not part of this entry's permission set.

setNegativePermissions

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.


setPrincipal

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:
user - the principal to be set for this entry.
Returns:
true if the principal is set, false if there was already a principal set for this entry.

toString

public String toString()
Returns a string representation of the contents of this ACL entry.

Overrides:
toString in class Object
Returns:
a string representation of the contents.


This documentation differs from the official API. Jadeite adds extra features to the API including: variable font sizes, constructions examples, placeholders for classes and methods, and auto-generated “See Also” links. Additionally it is missing some items found in standard Javadoc documentation, including: generics type information, “Deprecated” tags and comments, “See Also” links, along with other minor differences. Please send any questions or feedback to bam@cs.cmu.edu.
This page displays the Jadeite version of the documention, which is derived from the offical documentation that contains this copyright notice:
Copyright 2008 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
The official Sun™ documentation can be found here at http://java.sun.com/javase/6/docs/api/.