java.security.acl

Interface Owner

public interface Owner

This interface provides a mechanism for maintaining a list of owners of an access control list (ACL). Since a Principal must be an owner in order to modify the owner list, a mechanism must be provided to specify the initial owner of the ACL. The proper way to do this is for the implementing class to specify the initial owner in the contructor for that class.
Method Summary
booleanaddOwner(Principal caller, Principal owner)
This method adds an owner to the access control list (ACL).
booleandeleteOwner(Principal caller, Principal owner)
This method delets an owner from the access control list (ACL).
booleanisOwner(Principal owner)
This method tests whether or not a given Principal is an owner of this access control list (ACL).

Method Detail

addOwner

public boolean addOwner(Principal caller, Principal owner)
This method adds an owner to the access control list (ACL). Only a Principal who is already an owner can perform this operation.

Parameters: caller The Principal who is requesting that an owner be added owner The Principal to add as a new owner true if the new owner was successfully added or false if the specified new owner is already an owner

Throws: NotOwnerException If the caller is not already an owner of this ACL

deleteOwner

public boolean deleteOwner(Principal caller, Principal owner)
This method delets an owner from the access control list (ACL). Only a Principal who is an owner can perform this operation. An owner can delete itself from the list. If there is only one owner remaining on this list, any attempt to delete it will throw an exception.

Parameters: caller The Principal who is requesting that an owner be deleted owner The Principal to delete as an owner true if the new owner was successfully deleted or false if the specified owner is not currently an owner

Throws: NotOwnerException If the caller is not already an owner of this ACL LastOwnerException If completing the operation would delete the last ACL owner

isOwner

public boolean isOwner(Principal owner)
This method tests whether or not a given Principal is an owner of this access control list (ACL).

Returns: true if the Principal is an owner, false otherwise