java.security.acl
Interface Owner

All Known Subinterfaces:
Acl

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
 boolean addOwner(Principal caller, Principal owner)
          This method adds an owner to the access control list (ACL).
 boolean deleteOwner(Principal caller, Principal owner)
          This method delets an owner from the access control list (ACL).
 boolean isOwner(Principal owner)
          This method tests whether or not a given Principal is an owner of this access control list (ACL).
 

Method Detail

addOwner

boolean addOwner(Principal caller,
                 Principal owner)
                 throws NotOwnerException
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

boolean deleteOwner(Principal caller,
                    Principal owner)
                    throws NotOwnerException,
                           LastOwnerException
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

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