Интерфейс AclFileAttributeView

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 файловой системой.

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

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