Интерфейс AclFileAttributeView

public interface AclFileAttributeView extends FileOwnerAttributeView

Представление атрибутов файла, поддерживающее чтение или обновление списков управления доступом (ACL) файла или атрибутов владельца файла.

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

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

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

Взаимодействие

RFC 3530 допускает использование специальных идентификаторов пользователей на платформах, поддерживающих права доступа, определенные POSIX. Специальные идентификаторы пользователей — это "OWNER@", "GROUP@" и "EVERYONE@". Когда поддерживаются как AclFileAttributeView, так и PosixFileAttributeView, то эти специальные идентификаторы пользователей могут быть включены в ACL entries, которые читаются или записываются. Служба поиска субъектов файловой системы UserPrincipalLookupService может быть использована для получения UserPrincipal для представления этих специальных идентификаторов путём вызова метода lookupPrincipalByName.

Пример использования: Предположим, что нам нужно добавить запись в существующий 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, отличающуюся от определённой в NFSv4, установка начального ACL при создании файла должна перевести ACL в модель, поддерживаемую файловой системой. Методы, создающие файл, должны отклонить (бросив IOException) любую попытку создать файл, который будет менее безопасным в результате преобразования.