Interface java.security.acl.Owner





All Packages Class Hierarchy This Package Previous Next Index


Interface java.security.acl.Owner


public interface Owner

Interface for managing owners of Access Control Lists (ACLs) or ACL
configurations. (Note that the Acl interface in the
java.security.acl package extends this Owner
interface.) The initial owner Principal should be specified as an
argument to the constructor of the class implementing this interface.


See Also:
Acl








addOwner(Principal, Principal)
Adds an owner.

deleteOwner(Principal, Principal)

Deletes an owner.

isOwner(Principal)
Returns true if the given principal is an owner of the ACL.






addOwner

public abstract boolean addOwner(Principal caller,
Principal owner) throws NotOwnerException


Adds an owner. Only owners can modify ACL contents. The caller
principal must be an owner of the ACL in order to invoke this method.
That is, only an owner can add another owner. The initial owner is
configured at ACL construction time.


Parameters:
caller - the principal invoking this method. It must be an owner
of the ACL.
owner - the owner that should be added to the list of owners.
Returns:
true if successful, false if owner is already an owner.
Throws: NotOwnerException
if the caller principal is not an owner
of the ACL.



deleteOwner

public abstract boolean deleteOwner(Principal caller,
Principal owner) throws NotOwnerException, LastOwnerException


Deletes an owner. If this is the last owner in the ACL, an exception is
raised.
The caller principal must be an owner of the ACL in order to invoke
this method.


Parameters:
caller - the principal invoking this method. It must be an owner
of the ACL.
owner - the owner to be removed from the list of owners.
Returns:
true if the owner is removed, false if the owner is not part
of the list of owners.
Throws: NotOwnerException
if the caller principal is not an owner
of the ACL.
Throws: LastOwnerException
if there is only one owner left, so that
deleteOwner would leave the ACL owner-less.



isOwner

public abstract boolean isOwner(Principal owner)


Returns true if the given principal is an owner of the ACL.


Parameters:
owner - the principal to be checked to determine whether or not
it is an owner.
Returns:
true if the passed principal is in the list of owners, false
if not.




All Packages Class Hierarchy This Package Previous Next Index

Submit a bug or feature - Version 1.1.7 of Java Platform API Specification
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1995-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.