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