Module java.base

Package java.nio.file.attribute

提供访问文件和文件系统属性的接口和类。

Attribute views

Attribute views	描述
AttributeView	Can read or update non-opaque values associated with objects in a file system
FileAttributeView	Can read or update file attributes
BasicFileAttributeView	Can read or update a basic set of file attributes
PosixFileAttributeView	Can read or update POSIX defined file attributes
DosFileAttributeView	Can read or update FAT file attributes
FileOwnerAttributeView	Can read or update the owner of a file
AclFileAttributeView	Can read or update Access Control Lists
UserDefinedFileAttributeView	Can read or update user-defined file attributes
FileStoreAttributeView	Can read or update file system attributes

属性视图提供与文件系统中的对象相关联的非不透明值或元数据的只读或可更新视图。 FileAttributeView接口由几个其他接口扩展，提供对特定文件属性集的视图。 FileAttributeViews通过调用选择Files.getFileAttributeView(java.nio.file.Path, java.lang.Class<V>, java.nio.file.LinkOption...)与类型令牌的方法来确定所需的视图。 视图也可以通过名称来识别。 FileStoreAttributeView接口提供对文件存储属性的访问。 甲FileStoreAttributeView给定类型的通过调用得到FileStore.getFileStoreAttributeView(java.lang.Class<V>)方法。

BasicFileAttributeView类定义了读取和更新许多文件系统通用的基本文件属性集的方法。

PosixFileAttributeView接口通过定义方法来访问文件系统和实现便携式操作系统接口（POSIX）系列标准的操作系统通常使用的文件属性，扩展了BasicFileAttributeView 。

DosFileAttributeView类扩展了BasicFileAttributeView ，定义了访问文件系统（例如消费者设备中通常使用的文件分配表格（FAT））支持的传统“DOS”文件属性的方法。

AclFileAttributeView类定义了读取和写入访问控制列表（ACL）文件属性的方法。 此文件属性视图使用的ACL模型基于RFC 3530: Network File System (NFS) version 4 Protocol定义的模型。

除了属性视图，此包还定义了访问属性时使用的类和接口：

• UserPrincipal和GroupPrincipal接口表示身份或组标识。
• UserPrincipalLookupService界面定义了查找用户或组主体的方法。
• FileAttribute接口表示在文件系统中创建对象时需要将属性值设置为原子的情况下属性的值。

除非另有说明，否则将null参数传递给此程序包中任何类或接口中的构造函数或方法将导致抛出NullPointerException 。

从以下版本开始：

1.7

接口摘要

接口	描述
AclFileAttributeView	支持读取或更新文件的访问控制列表（ACL）或文件所有者属性的文件属性视图。
AttributeView	提供与文件系统中的对象相关联的非不透明值的只读或可更新 视图的对象。
BasicFileAttributes	与文件系统中的文件相关联的基本属性。
BasicFileAttributeView	文件属性视图，提供许多文件系统通用的 基本文件属性 集的视图。
DosFileAttributes	与支持旧版“DOS”属性的文件系统中的文件相关联的文件属性。
DosFileAttributeView	提供传统“DOS”文件属性视图的文件属性视图。
FileAttribute<T>	封装通过调用 createFile或 createDirectory方法创建新文件或目录时可以原子地设置的文件属性的值的对象。
FileAttributeView	属性视图，它是与文件系统中的文件相关联的非不透明值的只读或可更新视图。
FileOwnerAttributeView	支持阅读或更新文件所有者的文件属性视图。
FileStoreAttributeView	属性视图，它是FileStore的属性的只读或可更新视图。
GroupPrincipal	A UserPrincipal表示 组身份 ，用于确定文件系统中对象的访问权限。
PosixFileAttributes	与实现便携式操作系统接口（POSIX）系列标准的操作系统使用的文件系统上的文件相关联的文件属性。
PosixFileAttributeView	文件属性视图，提供通常与实现便携式操作系统接口（POSIX）系列标准的操作系统使用的文件系统上的文件关联的文件属性视图。
UserDefinedFileAttributeView	文件属性视图，提供文件的用户定义属性（有时称为 扩展属性）的视图。
UserPrincipal	A Principal表示用于确定对文件系统中的对象的访问权限的身份。

类摘要

Class	描述
AclEntry	访问控制列表（ACL）中的条目。
AclEntry.Builder	一个AclEntry对象的生成器。
FileTime	表示文件时间戳属性的值。
PosixFilePermissions	该类只包含对PosixFilePermission对象进行操作的静态方法。
UserPrincipalLookupService	按名称查找用户和组主体的对象。

枚举摘要

Enum	描述
AclEntryFlag	定义ACL entry的标志组件使用的标志。
AclEntryPermission	定义与ACL entry的权限组件一起使用的权限。
AclEntryType	访问控制条目类型的类型安全枚举。
PosixFilePermission	定义与 permissions属性一起使用的位。

异常摘要

异常	描述
UserPrincipalNotFoundException	当查询UserPrincipal失败，因为主体不存在时抛出的检查异常。