Module java.base
Package java.nio.file.attribute

Class AclEntry.Builder

  • Enclosing class:
    AclEntry

    public static final class AclEntry.Builder
extends Object
    A builder of AclEntry objects.

    A Builder object is obtained by invoking one of the newBuilder methods defined by the AclEntry class.

    Builder objects are mutable and are not safe for use by multiple concurrent threads without appropriate synchronization.

    Since:
    1.7

    • Method Detail

      • build

        public AclEntry build​()
        Constructs an AclEntry from the components of this builder. The type and who components are required to have been set in order to construct an AclEntry.
        Returns:
        a new ACL entry
        Throws:
        IllegalStateException - if the type or who component have not been set

      • setType

        public AclEntry.Builder setType​(AclEntryType type)
        Sets the type component of this builder.
        Parameters:
        type - the component type
        Returns:
        this builder

      • setPrincipal

        public AclEntry.Builder setPrincipal​(UserPrincipal who)
        Sets the principal component of this builder.
        Parameters:
        who - the principal component
        Returns:
        this builder

      • setPermissions

        public AclEntry.Builder setPermissions​(Set<AclEntryPermission> perms)
        Sets the permissions component of this builder. On return, the permissions component of this builder is a copy of the given set.
        Parameters:
        perms - the permissions component
        Returns:
        this builder
        Throws:
        ClassCastException - if the set contains elements that are not of type AclEntryPermission

      • setPermissions

        public AclEntry.Builder setPermissions​(AclEntryPermission... perms)
        Sets the permissions component of this builder. On return, the permissions component of this builder is a copy of the permissions in the given array.
        Parameters:
        perms - the permissions component
        Returns:
        this builder

      • setFlags

        public AclEntry.Builder setFlags​(Set<AclEntryFlag> flags)
        Sets the flags component of this builder. On return, the flags component of this builder is a copy of the given set.
        Parameters:
        flags - the flags component
        Returns:
        this builder
        Throws:
        ClassCastException - if the set contains elements that are not of type AclEntryFlag

      • setFlags

        public AclEntry.Builder setFlags​(AclEntryFlag... flags)
        Sets the flags component of this builder. On return, the flags component of this builder is a copy of the flags in the given array.
        Parameters:
        flags - the flags component
        Returns:
        this builder