java.nio.file.attribute

Class AclEntry

Contents

  • 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.

    Since:
    1.7

    • Method Detail

      • newBuilder

        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

      • newBuilder

        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

      • type

        public AclEntryType type()
        Returns the ACL entry type.

      • principal

        public UserPrincipal principal()
        Returns the principal component.

      • permissions

        public Set<AclEntryPermission> permissions()
        Returns a copy of the permissions component.

        The returned set is a modifiable copy of the permissions.

      • flags

        public Set<AclEntryFlag> flags()
        Returns a copy of the flags component.

        The returned set is a modifiable copy of the flags.

      • equals

        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.

        Overrides:
        equals in class Object
        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
        See Also:
        Object.hashCode(), HashMap

      • toString

        public String toString()
        Returns the string representation of this ACL entry.
        Overrides:
        toString in class Object
        Returns:
        the string representation of this entry

Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-java/nio/file/attribute/AclEntry.html

The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.

References

  1. View the html document Language of the document:fr Manuel PHP : https://docs.oracle.com

These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.

Contents Haut