模块 java.base

包 java.nio.file.attribute

包java.nio.file.attribute

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

属性视图

属性视图	Description
AttributeView	可以读取或更新与文件系统中的对象关联的非不透明值
FileAttributeView	可以读取或更新文件属性
BasicFileAttributeView	可以读取或更新一组基本的文件属性
PosixFileAttributeView	可以读取或更新 POSIX 定义的文件属性
DosFileAttributeView	可以读取或更新 FAT 文件属性
FileOwnerAttributeView	可以读取或更新文件的所有者
AclFileAttributeView	可以读取或更新访问控制列表
UserDefinedFileAttributeView	可以读取或更新用户定义的文件属性
FileStoreAttributeView	可以读取或更新文件系统属性

属性视图提供与文件系统中的对象关联的非不透明值或 metadata 的只读或可更新视图。 FileAttributeView 接口由几个其他接口扩展，这些接口提供特定文件属性集的视图。 FileAttributeViews 是通过调用带有 type-token 的 Files.getFileAttributeView(java.nio.file.Path, java.lang.Class<V>, java.nio.file.LinkOption...) 方法来识别所需视图的。视图也可以通过名称来标识。 FileStoreAttributeView 接口提供对文件存储属性的访问。给定类型的 FileStoreAttributeView 是通过调用 FileStore.getFileStoreAttributeView(java.lang.Class<V>) 方法获得的。

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

PosixFileAttributeView 接口通过定义方法来扩展 BasicFileAttributeView 以访问实现可移植操作系统接口 (POSIX) 系列标准的文件系统和操作系统常用的文件属性。

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

AclFileAttributeView 类定义了读取和写入访问控制列表 (ACL) 文件属性的方法。此文件属性视图使用的 ACL 模型基于 RFC 3530：网络文件系统 (NFS) 版本 4 协议 定义的模型。

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

• UserPrincipal 和 GroupPrincipal 接口表示身份或组身份。
• UserPrincipalLookupService 接口定义了查找用户或组主体的方法。
• FileAttribute 接口表示属性值，用于在文件系统中创建对象时需要自动设置属性值的情况。

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

自从：

1.7

相关包

包	描述
java.nio.file	定义Java虚拟机访问文件、文件属性和文件系统的接口和类。
java.nio.file.spi	java.nio.file 包的服务提供商类。

类	描述
AclEntry	访问控制列表 (ACL) 中的条目。
AclEntry.Builder	AclEntry 对象的生成器。
AclEntryFlag	定义 ACL entry 的标志组件使用的标志。
AclEntryPermission	定义与 ACL entry 的权限组件一起使用的权限。
AclEntryType	访问控制条目类型的类型安全枚举。
AclFileAttributeView	支持读取或更新文件的访问控制列表 (ACL) 或文件所有者属性的文件属性视图。
AttributeView	提供与文件系统中对象关联的非不透明值的只读或可更新 view 的对象。
BasicFileAttributes	与文件系统中的文件关联的基本属性。
BasicFileAttributeView	一个文件属性视图，提供许多文件系统共有的文件属性视图。
DosFileAttributes	与支持传统“DOS”属性的文件系统中的文件关联的文件属性。
DosFileAttributeView	提供旧“DOS”文件属性视图的文件属性视图。
FileAttribute <T>	封装文件属性值的对象，可以在创建新文件或目录时通过调用 createFile 或 createDirectory 方法自动设置。
FileAttributeView	一种属性视图，它是与文件系统中的文件关联的非不透明值的只读或可更新视图。
FileOwnerAttributeView	支持读取或更新文件所有者的文件属性视图。
FileStoreAttributeView	一个属性视图，它是 FileStore 的属性的只读或可更新视图。
FileTime	表示文件时间戳属性的值。
GroupPrincipal	UserPrincipal 表示 group identity ，用于确定对文件系统中对象的访问权限。
PosixFileAttributes	与实现可移植操作系统接口 (POSIX) 系列标准的操作系统所使用的文件系统上的文件关联的文件属性。
PosixFileAttributeView	一种文件属性视图，提供通常与文件系统上的文件关联的文件属性视图，这些文件系统由实现可移植操作系统接口 (POSIX) 系列标准的操作系统使用。
PosixFilePermission	定义用于 permissions 属性的位。
PosixFilePermissions	此类仅包含对 PosixFilePermission 对象集进行操作的静态方法。
UserDefinedFileAttributeView	提供文件的用户定义属性视图的文件属性视图，有时称为 extended attributes 。
UserPrincipal	Principal 表示用于确定对文件系统中对象的访问权限的标识。
UserPrincipalLookupService	按名称查找用户和组主体的对象。
UserPrincipalNotFoundException	当查找 UserPrincipal 失败时抛出检查异常，因为委托人不存在。