Интерфейс 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) любую попытку создания файла, которая привела бы к снижению безопасности в результате такого перевода.

String name()

List<AclEntry> getAcl()
               throws IOException

void setAcl(List<AclEntry> acl)
     throws IOException