Интерфейс AclFileAttributeView

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

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

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

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

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