AclEntry

public final class AclEntry extends Object

An entry in an access control list (ACL).

The ACL entry represented by this class is based on the ACL model specified in RFC 3530: Network File System (NFS) version 4 Protocol. Each entry has four components as follows:

1. The type component determines if the entry grants or denies access.

2. The principal component, sometimes called the "who" component, is a UserPrincipal corresponding to the identity that the entry grants or denies access

3. The permissions component is a set of permissions

4. The flags component is a set of flags to indicate how entries are inherited and propagated

ACL entries are created using an associated AclEntry.Builder object by invoking its build method.

ACL entries are immutable and are safe for use by multiple concurrent threads.

Nested Class Summary

class

AclEntry.Builder

A builder of AclEntry objects.

Public Method Summary

boolean	equals(Object ob) Compares the specified object with this ACL entry for equality.
Set<AclEntryFlag>	flags() Returns a copy of the flags component.
int	hashCode() Returns the hash-code value for this ACL entry.
static AclEntry.Builder	newBuilder(AclEntry entry) Constructs a new builder with the components of an existing ACL entry.
static AclEntry.Builder	newBuilder() Constructs a new builder.
Set<AclEntryPermission>	permissions() Returns a copy of the permissions component.
UserPrincipal	principal() Returns the principal component.
String	toString() Returns the string representation of this ACL entry.
AclEntryType	type() Returns the ACL entry type.

Inherited Method Summary

From class java.lang.Object

Object	clone() Creates and returns a copy of this Object.
boolean	equals(Object obj) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of Class that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait(long timeout, int nanos) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.
final void	wait(long timeout) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.
final void	wait() Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object.

Public Methods

public boolean equals (Object ob)

Compares the specified object with this ACL entry for equality.

If the given object is not an AclEntry then this method immediately returns false.

For two ACL entries to be considered equals requires that they are both the same type, their who components are equal, their permissions components are equal, and their flags components are equal.

This method satisfies the general contract of the Object.equals method.

Parameters

ob	the object to which this object is to be compared

Returns

• true if, and only if, the given object is an AclEntry that is identical to this AclEntry

public Set<AclEntryFlag> flags ()

Returns a copy of the flags component.

The returned set is a modifiable copy of the flags.

Returns

• the flags component

public int hashCode ()

Returns the hash-code value for this ACL entry.

This method satisfies the general contract of the Object.hashCode() method.

Returns

• this object's hash code.

public static AclEntry.Builder newBuilder (AclEntry entry)

Constructs a new builder with the components of an existing ACL entry.

Parameters

entry	an ACL entry

Returns

• a new builder

public static AclEntry.Builder newBuilder ()

Constructs a new builder. The initial value of the type and who components is null. The initial value of the permissions and flags components is the empty set.

Returns

• a new builder

public Set<AclEntryPermission> permissions ()

Returns a copy of the permissions component.

The returned set is a modifiable copy of the permissions.

Returns

• the permissions component

public UserPrincipal principal ()

Returns the principal component.

Returns

• the principal component

public String toString ()

Returns the string representation of this ACL entry.

Returns

• the string representation of this entry

public AclEntryType type ()

Returns the ACL entry type.

Returns

• the ACL entry type