Интерфейс AclFileAttributeView

ACL используются для указания прав доступа к объектам файловой системы. ACL представляет собой упорядоченный список access-control-entries, каждая из которых задаёт UserPrincipal и уровень доступа для этого субъекта-пользователя. Это представление атрибутов файла определяет методы getAcl и setAcl для чтения и записи ACL в соответствии с моделью ACL, указанной в RFC 3530: протокол сетевой файловой системы (NFS) версии 4. Это представление атрибутов файла предназначено для реализаций файловых систем, поддерживающих модель ACL NFSv4 или имеющих чётко определённое соответствие между моделью ACL NFSv4 и моделью ACL, используемой файловой системой. Детали такого соответствия зависят от реализации и поэтому не определены.

Этот класс также расширяет FileOwnerAttributeView, определяя методы получения и задания владельца файла.

Когда файловая система предоставляет доступ к набору file-systems, которые не являются однородными, только некоторые файловые системы могут поддерживать ACL. Для проверки поддержки ACL файловой системой можно использовать метод supportsFileAttributeView.

Совместимость

Пример использования: Предположим, что мы хотим добавить запись в существующую ACL, чтобы предоставить доступ пользователю «joe»:

    // lookup "joe"
    UserPrincipal joe = file.getFileSystem().getUserPrincipalLookupService()
        .lookupPrincipalByName("joe");

    // get view
    AclFileAttributeView view = Files.getFileAttributeView(file, AclFileAttributeView.class);

    // create ACE to give "joe" read access
    AclEntry entry = AclEntry.newBuilder()
        .setType(AclEntryType.ALLOW)
        .setPrincipal(joe)
        .setPermissions(AclEntryPermission.READ_DATA, AclEntryPermission.READ_ATTRIBUTES)
        .build();

    // read ACL, insert ACE, re-write ACL
    List<AclEntry> acl = view.getAcl();
    acl.add(0, entry);   // insert before any DENY entries
    view.setAcl(acl);

Динамический доступ

Если требуется динамический доступ к атрибутам файла, это представление атрибутов поддерживает следующие атрибуты:

Поддерживаемые атрибуты

Имя	Тип
"acl"	List<AclEntry>
"owner"	UserPrincipal

Метод getAttribute можно использовать для чтения атрибутов ACL или владельца так, как если бы были вызваны методы getAcl или getOwner.

Метод setAttribute можно использовать для обновления атрибутов ACL или владельца так, как если бы были вызваны методы setAcl или setOwner.

Задание ACL при создании файла

Реализации, поддерживающие это представление атрибутов, могут также поддерживать задание начальной ACL при создании файла или каталога. Начальную ACL можно передать таким методам, как createFile или createDirectory, в виде FileAttribute с name "acl:acl" и value, представляющим собой список объектов AclEntry.

Если реализация поддерживает модель ACL, отличную от модели ACL, определённой NFSv4, при задании начальной ACL во время создания файла ACL должна быть преобразована в модель, поддерживаемую файловой системой. Методы создания файла должны отклонять (выбрасывая IOException) любую попытку создать файл, который после преобразования окажется менее защищённым.