编辑“︁Java文件监视（Java File Watch）”︁（章节）

== 基本用法 ==
以下是一个简单的Java文件监视示例，展示如何监听目录中的文件变化：

<syntaxhighlight lang="java">
import java.nio.file.*;
import java.io.IOException;

public class FileWatcherExample {
    public static void main(String[] args) throws IOException, InterruptedException {
        // 1. 获取WatchService实例
        WatchService watchService = FileSystems.getDefault().newWatchService();

        // 2. 注册要监视的目录和事件类型
        Path dir = Paths.get("C:/watch_dir");
        dir.register(watchService, 
            StandardWatchEventKinds.ENTRY_CREATE,
            StandardWatchEventKinds.ENTRY_MODIFY,
            StandardWatchEventKinds.ENTRY_DELETE);

        System.out.println("开始监视目录: " + dir);

        // 3. 无限循环等待事件
        while (true) {
            WatchKey key = watchService.take(); // 阻塞直到事件发生

            // 4. 处理事件
            for (WatchEvent<?> event : key.pollEvents()) {
                WatchEvent.Kind<?> kind = event.kind();

                if (kind == StandardWatchEventKinds.OVERFLOW) {
                    continue; // 忽略溢出事件
                }

                // 获取触发事件的文件名
                WatchEvent<Path> ev = (WatchEvent<Path>) event;
                Path filename = ev.context();

                System.out.printf("事件类型: %s, 文件名: %s%n", kind.name(), filename);
            }

            // 5. 重置key，继续监听
            boolean valid = key.reset();
            if (!valid) {
                break; // 如果目录不再可访问，退出循环
            }
        }
    }
}
</syntaxhighlight>

'''输出示例：'''
<pre>
开始监视目录: C:\watch_dir
事件类型: ENTRY_CREATE, 文件名: test.txt
事件类型: ENTRY_MODIFY, 文件名: test.txt
事件类型: ENTRY_DELETE, 文件名: test.txt
</pre>