368. Java IO API - 基本文件属性

368. Java IO API - 基本文件属性

在文件操作中，经常需要读取文件的基本属性，例如创建时间、最后修改时间、文件大小等。Java 提供了Files.readAttributes()方法，允许你一次性读取多个基本文件属性，这样可以有效提高性能，避免多次访问文件系统。

🛠️ 使用Files.readAttributes()读取基本文件属性

Files.readAttributes()方法返回BasicFileAttributes类的实例，该类包含了多个常用的文件属性，如：

• creationTime：文件的创建时间。
• lastModifiedTime：文件的最后修改时间。
• lastAccessTime：文件的最后访问时间。
• isDirectory()：文件是否为目录。
• isRegularFile()：文件是否为常规文件。
• isSymbolicLink()：文件是否为符号链接。
• size()：文件的大小（以字节为单位）。

使用Files.readAttributes()方法一次性获取这些属性比逐一获取每个属性要高效得多，尤其是在需要处理大量文件时。

示例：读取基本文件属性

importjava.nio.file.*;importjava.nio.file.attribute.*;importjava.io.IOException;publicclassBasicFileAttributesDemo{publicstaticvoidmain(String[]args){Pathfile=Paths.get("example.txt");try{BasicFileAttributesattr=Files.readAttributes(file,BasicFileAttributes.class);// 输出文件的时间戳和基本属性System.out.println("创建时间: "+attr.creationTime());System.out.println("最后访问时间: "+attr.lastAccessTime());System.out.println("最后修改时间: "+attr.lastModifiedTime());System.out.println("是否是目录: "+attr.isDirectory());System.out.println("是否是常规文件: "+attr.isRegularFile());System.out.println("是否是符号链接: "+attr.isSymbolicLink());System.out.println("文件大小: "+attr.size()+" 字节");}catch(IOExceptione){System.err.println("读取文件属性失败: "+e.getMessage());}}}

• BasicFileAttributes类是一个包含文件基本属性的接口，常用的属性如创建时间、最后访问时间、文件大小等，可以通过Files.readAttributes()方法一次性读取。
• 注意：creationTime、lastModifiedTime和lastAccessTime这三个时间戳在某些文件系统实现中可能不被支持，返回的值会是实现特定的默认值。

⏳ 设置时间戳

在某些场景下，我们可能需要修改文件的时间戳，比如更新文件的最后修改时间。可以通过Files.setLastModifiedTime()方法来实现。

示例：设置文件的最后修改时间

importjava.nio.file.*;importjava.nio.file.attribute.*;importjava.io.IOException;publicclassSetFileTimeDemo{publicstaticvoidmain(String[]args){Pathfile=Paths.get("example.txt");try{// 获取当前时间并转换为 FileTimelongcurrentTime=System.currentTimeMillis();FileTimeft=FileTime.fromMillis(currentTime);// 设置文件的最后修改时间Files.setLastModifiedTime(file,ft);System.out.println("文件的最后修改时间已更新！");}catch(IOExceptione){System.err.println("设置文件修改时间失败: "+e.getMessage());}}}

• FileTime.fromMillis(long)方法允许你将当前的时间戳（以毫秒为单位）转换为FileTime对象，然后通过Files.setLastModifiedTime()方法将其设置到文件上。

⚠️ 关注符号链接

使用Files.readAttributes()方法时，若文件路径指向符号链接，默认会返回符号链接的属性。如果你不希望访问符号链接的目标文件，可以使用LinkOption.NOFOLLOW_LINKS参数来避免跟随符号链接。

示例：避免跟随符号链接

importjava.nio.file.*;importjava.nio.file.attribute.*;importjava.io.IOException;publicclassAvoidSymbolicLinkFollow{publicstaticvoidmain(String[]args){Pathfile=Paths.get("symlink.txt");try{BasicFileAttributesattr=Files.readAttributes(file,BasicFileAttributes.class,LinkOption.NOFOLLOW_LINKS);// 输出符号链接的属性System.out.println("是否是符号链接: "+attr.isSymbolicLink());}catch(IOExceptione){System.err.println("读取符号链接属性失败: "+e.getMessage());}}}

• LinkOption.NOFOLLOW_LINKS参数确保读取的是符号链接本身的属性，而不是它指向的目标文件的属性。

🏷️fileKey()方法

除了读取常见的属性，BasicFileAttributes还提供了fileKey()方法，用于获取文件的唯一标识符。这个标识符是与文件系统相关的，可以用来唯一标识文件。然而，并不是所有的文件系统都支持文件键，如果不可用，fileKey()将返回null。

示例：获取文件的唯一标识符

importjava.nio.file.*;importjava.nio.file.attribute.*;importjava.io.IOException;publicclassFileKeyDemo{publicstaticvoidmain(String[]args){Pathfile=Paths.get("example.txt");try{BasicFileAttributesattr=Files.readAttributes(file,BasicFileAttributes.class);ObjectfileKey=attr.fileKey();System.out.println("文件的唯一标识符: "+(fileKey!=null?fileKey:"无文件键"));}catch(IOExceptione){System.err.println("获取文件标识符失败: "+e.getMessage());}}}

• attr.fileKey()方法返回文件的唯一标识符，若文件系统不支持文件键，则返回null。

📝 总结

• Files.readAttributes()方法是高效读取文件基本属性的工具，可以批量获取文件的创建时间、修改时间、大小等常见属性。
• 时间戳（如创建时间、最后修改时间）可能会受到文件系统的支持限制。
• 符号链接的处理可以通过LinkOption.NOFOLLOW_LINKS来避免跟随符号链接。
• fileKey()方法提供了一个文件的唯一标识符，但并非所有文件系统都支持此功能。

通过这些方法，Java 提供了灵活高效的工具来管理文件属性，可以大大提高文件操作的性能和可用性。