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

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

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