-
- All Superinterfaces:
-
AttributeView
,FileAttributeView
- All Known Subinterfaces:
-
DosFileAttributeView
,PosixFileAttributeView
public interface BasicFileAttributeView extends FileAttributeView
文件属性视图,提供许多文件系统通用的基本文件属性集的视图。 文件属性的基本集由2705655559529接口定义的强制和可选文件属性组成。通过调用
readAttributes
方法,通过批量操作从文件系统检索文件属性。 此类还定义了更新文件的时间属性的setTimes
方法。在需要动态访问文件属性的地方,此属性视图支持的属性具有以下名称和类型:
Name Type "lastModifiedTime" FileTime
"lastAccessTime" FileTime
"creationTime" FileTime
"size" Long
"isRegularFile" Boolean
"isDirectory" Boolean
"isSymbolicLink" Boolean
"isOther" Boolean
"fileKey" Object
getAttribute
方法可以用于通过调用readAttributes()
方法来读取任何这些属性。setAttribute
方法可以用于更新文件的最后修改时间,上次访问时间或创建时间属性,就好像通过调用setTimes
方法一样。- 从以下版本开始:
- 1.7
-
-
方法摘要
所有方法 接口方法 抽象方法 Modifier and Type 方法 描述 String
name()
返回属性视图的名称。BasicFileAttributes
readAttributes()
读取大量操作的基本文件属性。void
setTimes(FileTime lastModifiedTime, FileTime lastAccessTime, FileTime createTime)
更新文件的最后修改时间,上次访问时间和创建时间属性的任何或全部。
-
-
-
方法详细信息
-
name
String name()
返回属性视图的名称。 此类型的属性视图名称为"basic"
。- Specified by:
-
name
在接口AttributeView
- 结果
- 属性视图的名称
-
readAttributes
BasicFileAttributes readAttributes() throws IOException
读取大量操作的基本文件属性。如果所有文件属性都被读取为相对于其他文件系统操作的原子操作,则是实现特定的。
- 结果
- 文件属性
- 异常
-
IOException
- 如果发生I / O错误 -
SecurityException
- 在默认提供程序的情况下,安装了一个安全管理器,它的checkRead
方法被调用来检查对该文件的读访问
-
setTimes
void setTimes(FileTime lastModifiedTime, FileTime lastAccessTime, FileTime createTime) throws IOException
更新文件的最后修改时间,上次访问时间和创建时间属性的任何或全部。此方法更新文件的时间戳属性。 这些值被转换为文件系统支持的时代和精度。 从精细到粗粒度的转换会导致精度损失。 尝试设置不支持的时间戳或超出底层文件存储区支持范围的值时,此方法的行为未定义。 投掷
IOException
可能会失败。如果任何的
lastModifiedTime
,lastAccessTime
,或createTime
参数具有值null
那么相应的时间戳没有改变。 当仅更新时间戳属性的一些但不是全部时,实现可能需要读取文件属性的现有值。 因此,该方法可能不是关于其他文件系统操作的原子操作。 读取和重写现有值也可能导致精度损失。 如果所有的lastModifiedTime
,lastAccessTime
和createTime
参数为null
,则此方法没有任何效果。使用示例:假设我们要更改文件的最后访问时间。
Path path = ... FileTime time = ... Files.getFileAttributeView(path, BasicFileAttributeView.class).setTimes(null, time, null);
- 参数
-
lastModifiedTime
- 新上次修改的时间,或null
不更改值 -
lastAccessTime
- 最后访问时间,或null
不更改值 -
createTime
- 文件的创建时间,或null
不更改值 - 异常
-
IOException
- 如果发生I / O错误 -
SecurityException
- 在默认提供程序的情况下,安装了安全管理器,调用其checkWrite
方法来检查对该文件的写入访问 - 另请参见:
-
Files.setLastModifiedTime(java.nio.file.Path, java.nio.file.attribute.FileTime)
-
-