Added in API level 1
Deprecated in API level 33

Owner

public interface Owner

java.security.acl.Owner


This interface was deprecated in API level 33.
This class is deprecated and subject to removal in a future version of Java SE. It has been replaced by java.security.Policy and related classes since 1.2.

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:

Summary

Public methods

abstract boolean addOwner(Principal caller, Principal owner)

Adds an owner.

abstract boolean deleteOwner(Principal caller, Principal owner)

Deletes an owner.

abstract boolean isOwner(Principal owner)

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

Public methods

addOwner

Added in API level 1
public abstract boolean addOwner (Principal caller, 
                Principal owner)

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 Principal: the principal invoking this method. It must be an owner of the ACL.

owner Principal: the owner that should be added to the list of owners.

Returns
boolean true if successful, false if owner is already an owner.

Throws
NotOwnerException if the caller principal is not an owner of the ACL.

deleteOwner

Added in API level 1
public abstract boolean deleteOwner (Principal caller, 
                Principal owner)

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 Principal: the principal invoking this method. It must be an owner of the ACL.

owner Principal: the owner to be removed from the list of owners.

Returns
boolean 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.
LastOwnerException if there is only one owner left, so that deleteOwner would leave the ACL owner-less.

isOwner

Added in API level 1
public abstract boolean isOwner (Principal owner)

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

Parameters
owner Principal: the principal to be checked to determine whether or not it is an owner.

Returns
boolean true if the passed principal is in the list of owners, false if not.