详解 Java 7 中新的文件 API

新文件包的用途

Java 7 向语言中引入了一些有用的特性，其中包括一个新的 I/O 文件包。相对于老的 java.io 包，这个包针对文件系统——特别是基于 POSIX 的系统——提供了粒度更细的控制功能。本文首先介绍一下新的 API，之后通过一个基于 Web 的文件管理器项目 WebFolder 来详细探索这些 API。该项目提供了一种管理远程计算机上文件系统的机制。它支持文件系统的遍历以及文件的查看、重命名、复制和删除等操作。我们可以利用新的 I/O 文件包扩展该项目，使之能够操作 ZIP 文件的内容，并能监视修改操作。WebFolder 可以免费从 http://webfolder.sf.net 下载。

尽管基本文件操作 API 在不同版本之间的确也有些更新，但 Java 团队决定为 Java 7 提供一个新设计的替代包，以一种新的方式来涵盖文件系统操作。

基本文件操作 API 仍然位于 java.nio.file 包及其两个子包 java.nio.file.attribute 和 java.nio.file.spi 中。新 API 把文件相关的操作从 java.io 包中分离出来，而且为使文件系统的管理更为直观，还提供了一些额外的方法。概念上，新 API 构建为一组实体接口和操作类，其中实体接口包含的是一个文件系统中的基本对象，而操作类包含的是文件系统自身之上的操作。这一理念从 java.util 包继承而来，在 java.util 包中，像 Collections 和 Arrays 等类提供了很多操作，分别用于集合和数组等基本聚合数据结构。为避免混淆，尤其是要避免 java.io 包和 java.nio.file 一起使用时出现问题，新包中的基类和接口采取了不同的命名方法。

新包不仅重新组织了支持文件和文件系统操作的类，还扩展了 API 的功能，比如提供了更为简单的文件复制和移动方式。

常规文件操作与新文件操作相关类之对比

下表是这些包中基类和接口的简单概述：

Java < 7 java.io，javax.swing.filechooser Java >= 7 java.nio.file 注释 File Path 和 Files File 类同时提供了文件位置和文件系统操作，而新 API 将其分为两部分。Path 提供的只是一个文件位置，还支持与路径相关的额外操作；Files 支持文件操作，还提供了很多 File 类中没有的新功能，比如复制或读取整个文件的内容，或者设置文件属主。 FileSystemView FileSystem FileSystemView 类提供了底层文件系统的一个视图，仅用于 Swing 文件选择器的上下文中。FileSystem 类可以表示定义于本地、远程或其他可选存储机制（如 ISO 映像或 ZIP 归档）之上的不同文件系统。FileSystem 类包含了一些工厂，用于提供如 Path 等不同接口的具体实现。 没有类似的类 FileStore 表示文件存储相关的某些属性，如文件大小。可以从一个特定的 Path 或 FileSystem 类重新获取。除了对象和操作的组织方式不同之外，新文件系统 API 能够在大多数方法和构造器中利用相当新的 Java 特性，如自动装箱（autoboxing），因而新 API 用起来更整洁，也更容易。
下面几部分我们会更详细地看一下特定改进。

文件系统遍历与分组操作

新文件包引入了一种新的文件系统遍历方法，相比于之前基于数组和过滤器的版本，内存使用效率有所改进。此外，新方法也使深度遍历文件系统成为可能。新的实现使用了访问者设计模式。尽管可以模仿访问者模式，使用支持普通文件的过滤器来执行遍历操作，但要提供简单且内存高效的多层遍历算法会困难得多。

访问者模式是作为 FileVisitor 接口引入的。因为这是个泛型接口，你可能会认为可以使用基于 File 的实现来遍历文件系统，然而新 I/O 文件只支持实现了 Path 接口的对象。该接口声明了四个方法，SimpleFileVisitor 类是该接口的一个实现，开发者可以继承这个类，这样在给定情况下只需实现所需的任何方法即可。下表简要概述了 FileVisitor 的各个方法以及它们在 SimpleFileVisitor 类中的行为：

方法名 用途 默认情况 visitFile 除非定义了过滤控制，否则会在遍历的每个普通文件（包括符号链接）上调用该方法。任何有意义的文件相关操作都可以在此处理，比如备份文件或查找文件内容。也可以在这里决定遍历是继续还是停止。该方法不会在目录上调用。 返回 CONTINUE preVisitDirectory 如果访问的项是目录而非文件，调用的将是该方法而非 visitFile。它支持跳过特定目录，也支持为复制操作在目标位置创建相应的目录。 返回 CONTINUE postVisitDirectory 该方法在整个目录的遍历已经完成时调用，可以方便地结束目录上的操作。比如，如果遍历的目的是删除所有文件，那么目录本身可以在该方法中删除。 返回 CONTINUE visitFileFailed 如果在文件系统遍历过程中出现任何未处理的异常，则会调用该方法。如果异常被重新抛出，那么所有遍历都将停止，而且异常会被传播到使用 Files.walkFileTree 启动文件系统遍历的代码处。可以在这里分析异常并决定是否继续遍历。 重新抛出 IOException 正如你所看到的，该接口非常强大，支持文件系统上的大部分习惯操作，包括归档、搜索、备份和删除文件。其异常处理也非常灵活。然而，如果只是需要获取某个目录的内容而无需深度遍历，使用老式的 File.list() 操作就很方便，新 IO 文件中也有一个类似的功能，不过返回的是一个集合而非纯数组。

java.io 包中没有的新特性

尽管新 IO 文件提供的文件系统遍历和分组操作确实非常有用，但标准的 java.io 包也支持这些操作。不过新 IO 文件提供了旧包所没有的特定于操作系统的功能。对链接和符号链接的支持就是一个重要例子，现在它们可以在任何文件系统遍历操作中创建或处理。当然，只有在支持链接和符号链接的文件系统中才能工作，否则会抛出 UnsupportedOperationException。另一个扩展是能够管理文件属性，如属主和权限。重复一下，如果底层文件系统不支持，会抛出 IOException 或 UnsupportedOperationException。下表是对链接和扩展文件属性相关操作的简要概述。所有这些操作都可以从 Files 类调用。

操作 用途 注释 createLink 创建映射到某个文件的硬连接 createSymbolicLink 创建映射到文件或目录的符号链接 getFileAttributeView 以特定于文件系统实现的 FileAttributeView 形式访问属性 虽然该方法带来了提供一组预定义属性集的灵活性，但使用的仍是具体实现类，因此限制了代码的可移植性 getOwner 获得文件属主 只能用于支持属主属性的文件系统 getPosixFilePermissions 获得文件权限 特定于 POSIX 系统 isSymbolicLink 判断给定路径是否为符号链接 特定文件系统 readSymbolicLink 读取符号链接的目标路径 特定文件系统 readAttributes 读取文件属性 该方法有两个以不同形式返回属性的变体 setAttribute 设置文件属性 属性名可能包含 FileAttributeView 限定词如果打算使用表中列出的操作，请参考新 IO 文件的文档。

监视

该 API 也提供了一种监视机制，因此可以针对事件（如创建、修改和删除）监视特定文件或目录的状态。遗憾的是，该 API 并不保证为监视事件采用推送模型，而且大部分情况下会使用轮询机制，在我看来，这降低了实现的吸引力。监视服务也依赖于系统，所以无法利用这种服务构建真正可移植的应用。有 5 个接口涵盖了该功能。下表是这些接口及其用法的简要概述。

接口 用途 用法 Watchable 这种类型的对象可以注册到监视服务中。注册后得到的 WatchKey 可用于监控事件修改。 必须通过该接口的某个具体实现来注册感兴趣的与对象关联的监视事件。请注意，Path 也扩展了 Watchable 接口。 WatchService 文件系统中用于注册 Watchable 对象的服务，使用 WatchKey 来监控修改。 WatchService 可以从 FileSytem 对象获得。 WatchKey 监视键是注册所得到的凭据，用于查询修改事件。 该对象可以保存下来，之后用于查询修改事件。当存在相关修改事件时，可以直接从 WatchService 获得 WatchKey 对象。 WatchEvent 携带监视事件。 WatchEvent 对象会被传给事件通知调用，可以从中获得事件种类和受影响对象的路径。 WatchEvent.Kind 携带监视事件的种类信息。 用于在注册 Watchable 对象时指定感兴趣的特定事件类型。在通知调用的 WatchEvent 中也有提供。这里强调两个可能会使用监视服务的场景。一个是，只需要监控特定对象的修改时。在这种情况下，Watchable 对象可以注册到监视服务中并获得监视键，监视键用于轮询修改事件。针对监视键的轮询机制不是阻塞的，因此即使未出现新事件，轮询仍然会获得一个空列表。为减轻轮询的负载，可以在两次轮询间引入一个延迟；作为代价，这会丢失一些通知事件发生时的精度。第二个场景利用了监视服务的监视机制，适于轮询与多个被监视对象相关的修改事件。和第一个场景一样，需要注册所有的 Watchable 对象，不过可以忽略返回的监视键。这里没有使用监视键的轮询机制，而是使用服务轮询机制来检索与所激发修改事件相关的监视键，然后使用针对监视键的轮询操作来处理事件。在这种情况下，监视键应保证指定了某些事件。可以使用一个线程来管理所有的监视键。监视服务的轮询机制更为灵活，因为它支持阻塞（blocking）、非阻塞（non-blocking）和带超时的阻塞（blocking with timeout）等操作。所以也能够更精确。后面我们会看一个有关第二个场景的例子，前面提到的 WebFolder 项目用到了它。

工具操作

新 I/O 文件的下一个主要特性是一组工具方法。这组方法使新包成为自给自足的，因为大部分使用情况下都不需要调用标准 java.io 包中的功能。输入流、输出流和字节通道都可以直接使用 Files 类的方法获得。该 API 支持完整的操作，如复制或移动文件。此外，整个文件的内容可被当作字符串列表或字节数组读出。不过需要注意的是，因为没有大小控制参数，所以为避免可能出现的内存问题，必须添加获取文件大小的操作。

新 I/O 文件组织的更多信息

最后，文件系统与存储是新 I/O 文件包的主要部分。正如我们所看到的，文件位置是通过 Path 接口表示的，这是该包的关键要素。开发者需要利用 FileSystem 工厂获得该接口的具体实现，而文件系统工厂又必须通过 FileSystems 工厂获得。下表显示了新 I/O 关键要素之间的关系。

存储信息可以从文件系统上的特定文件（Path）获得。

使用文件系统

所有文件系统实现都由相应提供者负责支持，实现的基类定义在 java.nio.file.spi 包中。服务提供者的概念使开发者能够轻松地扩展到更多文件系统。有些有趣的文件系统提供者是包装过的，比如有的会变换 ZIP 文件的内容，支持如内容的遍历和文件的创建、删除及修改等功能。后面我们会看一个例子。

并发与原子操作

如果不提一下新 IO 文件对并发的支持，概述将是不完整的。新 IO 文件高度支持并发，因此大部分操作在并发环境中是安全的。移动文件也是原子的。通过获取 SecureDirectoryStream 接口的具体实现来操作目录内容也是安全的。在这种情况下，即使目录被外部攻击者移动或修改，所有目录相关操作仍然具有一致性。这里只接收相对路径。

实例

学习新东西最好的方法就是动手编程。上面提到的基于 Web 的文件管理器 WebFolder 最初是用 java.io 包开发的，因此我决定使用新 IO 文件来迁移一下该项目。如此将有助于更好地理解 I/O 文件中的概念，而且相对于其他更严肃的项目，我可以用特定应用来评估新的 API。这里我有意让示例代码小一些，完整的源代码可以从项目网站下载。

1. 获取一个目录下的内容

 
try (RequestTransalated rt = translateReq(getConfigValue("TOPFOLDER", File.separator),
req.getPathInfo());
 
   DirectoryStream<Path> stream = Files.newDirectoryStream(rt.transPath);) {
 
             for (Path entry : stream) {
 
                    result.add(new Webfile(entry, rt.reqPath)); // 添加目录
element info in model
 
             }
 
} catch (Exception ioe) {
 
   log("", ioe);
 
}  // 因为 API 支持 AutoCloseable 和新的 try 块语法，所以这里没有 finally 块

这个例子填充了一个将由页面视图绘制的目录模型。Files.newDirectoryStream 用于获取目录内容的迭代器。

2. 深度遍历

 
Path ffrom = ….
 
Files.walkFileTree(ffrom, EnumSet.of(FileVisitOption.FOLLOW_LINKS), Integer.MAX_VALUE,
 
        new SimpleFileVisitor<Path>() {
 
            @Override
 
            public FileVisitResult preVisitDirectory(Path dir,
 
BasicFileAttributes attrs)
 
                    throws IOException {
 
                Path targetdir =
fto.resolve(fto.getFileSystem().getPath(ffrom.relativize(dir).toString()));
 
                try {
 
                    Files.copy(dir, targetdir,
StandardCopyOption.COPY_ATTRIBUTES);
 
                } catch (FileAlreadyExistsException e) {
 
                    if (!Files.isDirectory(targetdir))
 
                        throw e;
 
                }
 
                return FileVisitResult.CONTINUE;
 
            }
 
            @Override
 
            public FileVisitResult visitFile(Path file, BasicFileAttributes
attrs) throws IOException {
 
                Path targetfile = fto.resolve(fto.getFileSystem()
 
       .getPath(ffrom.relativize(file).toString()));
 
                Files.copy(file, targetfile,
StandardCopyOption.COPY_ATTRIBUTES);
 
                return FileVisitResult.CONTINUE;
 
        }
 
});

这段代码将文件系统上一个目录的内容复制到另一个位置。preVisitDirectory 负责复制目录本身。因为目标可以是另一个文件系统，该例子既可以方便地在保存目录结构的同时提取 ZIP 归档文件的全部内容，也可以方便地将目录结构存入 ZIP 归档文件中。COPY_ATTRIBUTES 选项会把源文件的所有属性（包括时间戳）保存到目标文件中。

类似实现可用于删除一个目录的所有内容，在这种情况下必须实现 postVisitDirectory 方法，而不是 preVisitDirectory，因为删除内容之后才能删除目录本身。

 
@Override
 
public FileVisitResult postVisitDirectory(Path dir, IOException e) throws IOException {
 
    if (e == null) {        
 
        if (dir.getParent() != null) {
 
            Files.delete(dir);
 
            return FileVisitResult.CONTINUE;
 
        } else
 
            return FileVisitResult.TERMINATE;
 
    } else {
 
        // 目录迭代失败
 
        throw e;
 
    }
 
}

该例子在删除前会检查以确保目标并非根目录。所有可能的异常都会向上传播，由某个调用者处理。

3. 来自 ZIP 的文件系统

 
FileSystem fs = FileSystems.newFileSystem(zipPath, null);
 
Path zipRootPath = fs.getPath(fs.getSeparator());
 
….
 
Fs.close();

zipRootPath 可以随意遍历 ZIP 文件的内容。所得的文件系统功能全面，支持大部分操作（包括复制、移动和删除）。不过 ZIP 文件系统不能使用监视服务。还请注意，该文件系统用完后必须关闭。如果要在同一个 ZIP 上打开另一个文件系统，操作会失败，因此编写代码时请将这种可能性牢记在心。然而默认的文件系统无需关闭。看起来新 I/O 文件包只维护了一个文件系统实例，并负责处理并发。

4. 监视

监视服务有多种使用方法，这里会说明两种最常见的，前面也有所提及。

 
WatchService ws = dir.getFileSystem().newWatchService();
 
WatchKey wk = dir.register(ws,  StandardWatchEventKinds.ENTRY_CREATE,
StandardWatchEventKinds.ENTRY_DELETE, StandardWatchEventKinds.ENTRY_MODIFY);

获得监视键之后，可以将其传给监视线程来监控相关事件。

 
@Override
 
public void run() {
 
    for (;;) {
 
        if (watchKey != null) {
 
            for (WatchEvent<?> event : watchKey.pollEvents()) {
 
                updateScreen(event.kind(), event.context());
 
        }
 
        boolean valid = watchKey.reset();
 
        if (!valid) {
 
            break;
 
        }
 
   }
 
}

如果事件消耗速度不够快，则会收到 OVERFLOW 事件。如果对监视键的事件没有兴趣了，可以取消。监视服务也可以用完后关闭。还有一种方法是，在注册了多个被监视对象的情况下，使用监视服务方法来轮询修改事件。这种方法更适合 WebFolder 应用。

 
public void run() {
 
    for (;;) {
 
        try {
 
            WatchKey watchKey = watchService.take(); // poll(10, );
 
            processWatchKey(watchKey);
 
        } catch (InterruptedException ie) {
 
            break;
 
        }
 
    }
 
}

一个监视线程是为默认文件系统获取的，之后会用在一个单一的监控线程中。这里使用了 take 操作，因为它是阻塞的，所以不会浪费循环。为支持轮询，processWatchKey 方法的实现与上面类似，也关联了监视事件。不过，这里不需要额外的循环，因为从监视服务获得的键已经与事件关联了起来。

概括

新 I/O 文件提供的内容包括：

1. 强大的文件系统遍历机制，可以进行复杂的分组操作。
2. 可以操作具体的文件、文件系统对象及其属性（如链接、属主和权限）。
3. 用于处理整个文件内容的便捷的工具方法，如读取、复制和移动等。
4. 用于监控文件系统修改的监视服务。
5. 文件系统上的原子操作，提供了针对文件系统的进程同步。
6. 可以定制定义于特定文件组织形式（如归档文件）之上的文件系统。

迁移

之所以考虑将基于老式 I/O 包的系统迁移到新 I/O 包上，有如下四个原因：

• 用到复杂的文件遍历实现时，会发现内存问题
• 需要支持 ZIP 归档文件中的文件操作
• 需要细粒度地控制 POSIX 系统中的文件属性
• 需要监视服务

根据经验，如果有两项或两项以上适用于项目，迁移就是值得的，否则我建议仍使用当前实现。一个不迁移的理由是，新 I/O 文件实现并不能使代码更紧凑、可读性更好。另一方面，在第一次访问特定的运行时实现时，新的文件遍历操作性能可能稍显不好。看起来 Oracle 在 Windows 上的实现做了很多缓存，致使第一次访问消耗的时间比较显著。然而 Linux 上的 OpenJDK（IcedTea）实现就没有这种问题，所以该问题似乎依赖于具体的平台 / 实现。

如果决定迁移，下表提供了一些技巧：

当前实现 迁移后 注释 fileObj = new File(new File(pe1, pe2), pe3) pathObj = fsObj. getPath(pe1, pe2, pe3) fsObj 可以作为 FileSystems.getDefault() 的结果获得，因为文件系统保存在 Path 本身之中，所以该对象可以从来自同一文件系统的任何现有路径获得 fileObj.someOperation() Files.someOperation(pathObj) 尽管可以添加一些与链接和属性相关的额外参数，但大部分情况下操作名是相同的 fileObj.listFiles() Files.newDirectoryStream(pathObj) Files.walkFileTree 应该用于深度遍历 new FileInputStrean(file) Files.newInputStream(pathObj) 可以指定如何打开文件的额外选项 new FileOutputStream(file) Files.newOutputStream(pathObj) 可以指定如何打开文件的额外选项 new FileWriter(file) Files.newBufferedWriter(pathObj) 可以指定如何打开文件的额外选项 new FileReader(file) Files.newBufferedReader(pathObj) 可以指定如何打开文件的额外选项 new RandomAccessFile(file) Files.newByteChannel(pathObj) 可以指定打开选项和文件创建属性 File 类和 Path 接口之间有两种转换方法：pathObj.toFile() 和 fileObj.toPath()。这有助于减少迁移所需的努力，人们得以将精力集中在新 I/O 文件提供的新功能上。作为迁移过程的一部分，可以考虑用 Files.copy 替换定制的文件复制方式。Path 接口本身提供了很多便利方法，可以减少以前基于 File 对象编码时的代码量。因为新代码将运行于 Java 7 或更高版本之上，改进异常处理和资源释放是值得的。下面代码说明了旧的机制和新的机制：

 
ClosableResource resource = null;
 
try {
 
     Resource = new Resource(…);
 
// 资源处理
 
} catch(Exception e) {
 
} finally {
 
    if (resource != null)
 
        try {
 
               resource.close();
 
       }  catch(Exception e) {
 
       }
 
}

可以替换为下面更为紧凑的代码：

 
try (Resource = new Resource(…);) {
 
     // 资源处理
 
 
 
} catch(Exception e) {
 
}

Resource 必须实现 AutoCloseable 接口，所有来自 JRT 的标准资源都实现了该接口。

关于作者

Dmitriy Rogatkin 是 WikiOrgCharts 公司的 CTO，负责把握公司的技术方向。他之前主要从事企业级软件开发相关的技术：他在 MetricStream 这家领先的企业级 GRC 软件公司担任了十多年首席架构师。他喜欢通过创建开源软件（从多媒体桌面应用到框架，再到应用服务器）来检验不同的想法。在他的诸多项目当中，TJWS 是一个微型应用服务器，在完整的 Java EE Profile 应用服务器耗费太高时，可以将 TJWS 作为一种选择；而 TravelsPal 可以帮助人们在旅行和规划时间时联系彼此。
查看英文原文： A Detailed Look at The New File API in Java 7