|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
public interface Acl
A Java access control list (ACL) is a group of individual ACL entries.
These entries consist of a Principal and a list of
permissions this Principal is either granted or denied.
A given Principal can have at most one positive ACL entry
(i.e., one that grants permissions) and one negative ACL entry (i.e., one
that denies permissions). If a given permission is both granted and
denied, the ACL treats it as if it were never granted or denied. If
both a Principal and a Group to which the
Principal belongs have an ACL entry, the permissions for
the individual Principal take precedence over the
permissions of the Group if there is a conflict.
Additionally, the ACL interface extends the Owner interface
and so an ACL has owners. Actions which modify the ACL are restricted
to owners.
| Method Summary | |
|---|---|
boolean |
addEntry(Principal caller,
AclEntry entry)
This method adds the specified entry to the ACL |
boolean |
checkPermission(Principal user,
Permission perm)
This method tests whether or not the specified Principal
has the specified Permission |
Enumeration<AclEntry> |
entries()
This method returns a list of all the entries in the ACL as an Enumeration. |
String |
getName()
This method returns the name of this ACL. |
Enumeration<Permission> |
getPermissions(Principal user)
This method returns a list of Permission's that are granted
to a particular Principal. |
boolean |
removeEntry(Principal caller,
AclEntry entry)
This method delets the specified entry from the ACL |
void |
setName(Principal caller,
String name)
This method sets the name of the ACL |
String |
toString()
This method returns the ACL as a String |
| Methods inherited from interface java.security.acl.Owner |
|---|
addOwner, deleteOwner, isOwner |
| Method Detail |
|---|
String getName()
void setName(Principal caller,
String name)
throws NotOwnerException
caller - The Principal requesting the action.name - The new name for this ACL.
NotOwnerException - If the caller is not an owner of this ACL.
boolean addEntry(Principal caller,
AclEntry entry)
throws NotOwnerException
caller - The Principal requesting the additionentry - The ACL entry to add
true if the entry was added, false
if there is already an entry of the same type for the
Principal.
NotOwnerException - If the caller is not an owner of this ACL.
boolean removeEntry(Principal caller,
AclEntry entry)
throws NotOwnerException
caller - The Principal requesting the deletion.entry - The ACL entry to delete
true if the entry was deleted, or false
if this entry was not part of the ACL to begin with
NotOwnerException - If the caller is not an owner of this ACL.Enumeration<AclEntry> entries()
Enumeration.
boolean checkPermission(Principal user,
Permission perm)
Principal
has the specified Permission
user - The Principal to testperm - The Permission to test for
true if the user has been granted the permission,
false otherwiseEnumeration<Permission> getPermissions(Principal user)
Permission's that are granted
to a particular Principal. This includes any permissions
that are granted to Group's to which the Principal
belongs unless they are overridden by a negative ACL. This permission
list is returned as an Enumeration.
user - The Principal to retrieve permissions for.
Principal.String toString()
String
toString in class ObjectString representation of this ACLObject.getClass(),
Object.hashCode(),
Class.getName(),
Integer.toHexString(int)
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||