compact1, compact2, compact3

java.nio.file.attribute

Interface AclFileAttributeView

All Superinterfaces:

AttributeView， FileAttributeView， FileOwnerAttributeView

public interface AclFileAttributeView
extends FileOwnerAttributeView

一个支持读取或更新文件的访问控制列表（ACL）或文件属性查看文件的所有者属性。

ACL是用于指定文件系统对象的访问权限。ACL是access-control-entries有序列表，每个指定UserPrincipal和为用户主体的访问级别。这个文件属性视图定义getAcl，和setAcl方法读写基于指定的RFC 3530: Network File System (NFS) version 4 Protocol ACL ACL模型。这个文件的属性视图是用于文件系统的实现，支持NFSv4 ACL模型或定义一个NFSv4 ACL模型和文件系统所使用的ACL模型之间的映射。这种映射的细节是依赖于实现的，因此未指定。

这个类也延伸FileOwnerAttributeView以定义的方法来获取和设置文件的所有者。

文件系统提供了一套file-systems不均匀的只有一些文件系统可以支持的时候。的supportsFileAttributeView方法可以用来测试是否有文件系统支持的ACL。

互操作性

RFC 3530允许特殊用户身份被用来支持平台上定义的访问权限的POSIX。特殊用户的身份是“ OWNER@”、“ GROUP@”、和“ EVERYONE@”。当两 AclFileAttributeView和 PosixFileAttributeView支持这些特殊用户的身份可能包括在ACL entries，读或写。文件系统的 UserPrincipalLookupService可以用来获得一个 UserPrincipal借用 lookupPrincipalByName方法表示这些特殊身份。

使用示例：假设我们希望添加一个条目到一个现有的ACL授予“乔”访问：

/ /查找“乔”UserPrincipal乔=文件。getfilesystem()。getuserprincipallookupservice()lookupprincipalbyname（“乔”）；/获得视图aclfileattributeview观=文件。getfileattributeview（文件，aclfileattributeview。类）；/创建王牌给“乔”读访问aclentry入门= aclentry。newbuilder()。设备（aclentrytype。允许）setprincipal（乔）。（aclentrypermission.read_data。时设置权限，aclentrypermission。read_attributes）build()；/ /读ACL，ACL插入ACE，重新写< > ACL列表aclentry getacl() =视图；ACL。添加（0，录入）；//前插入任何否认条目setacl（ACL）的观点；

动态访问

当需要动态访问文件属性时，此属性视图支持的属性如下：

Name	Type
"acl"	List<AclEntry>
"owner"	UserPrincipal

的getAttribute方法可以用来读取ACL或所有者属性，如果通过调用getAcl或getOwner方法。

的setAttribute方法可用于更新ACL或所有者属性，如果通过调用setAcl或setOwner方法。

设置ACL创建文件时

实现支持这个属性视图还可以支持设置初始ACL创建一个文件或目录的时候。最初的ACL可以提供方法如createFile或createDirectory与name "acl:acl"和value是AclEntry对象列表中的一个FileAttribute。

在一个实施支持ACL模型不同于NFSv4 ACL模型定义并设置初始ACL创建文件时，必须将ACL的文件系统支持的模型。方法创建一个文件应该拒绝（投掷IOException）任何试图创建一个文件，将作为结果的翻译更不安全。

从以下版本开始：

一点七

方法摘要

Modifier and Type	Method and Description
List<AclEntry>	getAcl() 读取访问控制列表。
String	name() 返回属性视图的名称。
void	setAcl(List<AclEntry> acl) 更新（替换）访问控制列表。

Methods inherited from interface java.nio.file.attribute.FileOwnerAttributeView

getOwner, setOwner

方法详细信息

name

String name()

返回属性视图的名称。这种类型的属性的名称 "acl"观点。

Specified by:

name 接口 AttributeView

Specified by:

name 接口 FileOwnerAttributeView

结果

属性视图的名称

getAcl

List<AclEntry> getAcl()
               throws IOException

读取访问控制列表。

当文件系统使用一个ACL模型不同于NFSv4 ACL模型定义，那么这个方法返回一个ACL，ACL的NFSv4 ACL模型的翻译。

返回的列表是可变的，方便修改现有的ACL。的setAcl方法用于更新文件的ACL属性。

结果

对 entries代表ACL的有序列表

异常

IOException如果I/O错误发生

SecurityException在默认提供程序的情况下，安装安全管理器，它否认 RuntimePermission ("accessUserInformation")或其 checkRead法否认对文件的读访问。

setAcl

void setAcl(List<AclEntry> acl)
     throws IOException

更新（替换）访问控制列表。

在文件系统支持访问控制列表，并使用ACL模型不同于nfsv4定义ACL模型，此方法必须将ACL的文件系统支持的模型。这种方法应该拒绝（投掷IOException）任何试图写一个ACL，似乎使文件更安全的情况要比如果ACL进行更新。在一个实现不支持一个AclEntryType.AUDIT或AclEntryType.ALARM条目映射，则此方法忽略这些条目写ACL时。

如果一个ACL条目包含一个user-principal不同供应商联系该属性视图然后ProviderMismatchException抛出。额外的验证，如果有的话，是依赖于实现的。

如果文件系统支持其他与安全相关的文件属性（例如一个文件access-permissions），更新访问控制列表也可能导致这些安全相关的属性被更新。

参数

acl -新的访问控制列表

异常

IOException -如果发生I/O错误或ACL是无效的

SecurityException在默认提供程序的情况下，安装安全管理器，它否认 RuntimePermission ("accessUserInformation")或其 checkWrite方法拒绝写访问文件。