386. Java IO API - 监控目录变化386. Java IO API - 监控目录变化要实现文件变化通知

386. Java IO API - 监控目录变化

要实现文件变化通知，程序必须能够检测文件系统中相关目录的变化。传统的方法是通过轮询文件系统来查找变化，但这种方法效率较低，尤其是当需要监控大量文件或目录时，轮询的性能将迅速下降，不能满足高效、可扩展的需求。

Java java.nio.file 包提供了一个高效的文件变化通知机制——Watch Service API。这个 API 允许你注册一个或多个目录，一旦目录内有文件变化（如文件创建、删除或修改），系统会将事件通知到注册的处理程序。

Watch Service 概述

WatchService API 是相对底层的，你可以直接使用它，或者在此基础上构建更高层次的 API，以便更好地满足你的需求。

实现文件变化监控的基本步骤如下：

创建 WatchService 监听器：首先，你需要创建一个 WatchService 实例，它将监听文件系统中的变化。
注册目录：对于每个你想要监控的目录，都需要在 WatchService 中注册。在注册时，你可以指定希望监听的事件类型，比如文件创建、文件删除或文件修改。每注册一个目录，都会返回一个 WatchKey 实例，用于标识该目录。
处理事件：你需要实现一个无限循环来等待事件的发生。当某个事件发生时，WatchKey 被触发并放入监听队列。你可以通过获取该 WatchKey 来处理事件。
重置和等待新事件：每次事件处理完成后，必须重置 WatchKey，然后继续等待新的事件。
关闭服务：当线程退出或者调用 close() 方法时，监控服务将结束。

值得注意的是，WatchKey 是线程安全的，可以与 java.nio.concurrent 包一起使用，你可以为此任务专门创建一个线程池来处理事件。

示例：WatchDir

下面是一个简单的 WatchDir 示例，展示了如何使用 WatchService 来监听文件和目录的变化：

import java.nio.file.*;
import java.nio.file.attribute.*;
import java.util.*;

public class WatchDir {
    public static void main(String[] args) throws Exception {
        Path dir = Paths.get("test"); // 监控的目录
        WatchService watcher = FileSystems.getDefault().newWatchService();
        
        // 注册监控的事件类型：创建、删除、修改
        WatchKey key = dir.register(watcher, StandardWatchEventKinds.ENTRY_CREATE, 
                                        StandardWatchEventKinds.ENTRY_DELETE, 
                                        StandardWatchEventKinds.ENTRY_MODIFY);
        
        // 循环等待事件
        while (true) {
            WatchKey signal = watcher.take(); // 阻塞直到发生事件
            for (WatchEvent<?> event : signal.pollEvents()) {
                WatchEvent.Kind<?> kind = event.kind();
                Path filename = (Path) event.context();
                System.out.println("Event " + kind + " occurred on file " + filename);
            }
            boolean valid = signal.reset(); // 重置 WatchKey 以继续监听
            if (!valid) {
                break; // 如果目录被删除或无法访问，则退出循环
            }
        }
    }
}

这个例子展示了如何使用 WatchService 来监控文件的创建、删除和修改，并打印出相应的事件信息。

通过这些步骤和代码示例，你可以掌握如何在 Java 中使用 Watch Service API 来高效地监控文件和目录的变化。

为了帮助理解 WatchService 的使用，我们可以先进行一些实际操作。下载并编译 WatchDir 示例程序。然后创建一个测试目录并传递给 WatchDir 示例。程序会使用单个线程来处理所有事件，因此在等待事件时会阻塞键盘输入。你可以通过以下命令在后台运行该程序：

$ java WatchDir test &

在测试目录中进行文件的创建、删除或修改。当任何这些事件发生时，程序会在控制台打印出相应的信息。当你完成测试后，可以删除测试目录，程序将退出。如果你不想手动删除，可以直接结束进程。

递归监控文件树

如果你希望监控整个文件树中的所有目录，可以使用 -r 参数。通过该参数，WatchDir 将遍历整个文件树，并为每个目录注册一个事件监听器。

补充解释

WatchService 通过创建线程来异步处理目录的变化，这比轮询更加高效。
WatchKey 是标识已注册目录的键。你需要通过它来接收事件，并处理目录或文件变化。
你可以对文件创建、删除和修改等事件设置不同的响应，灵活性较高。