java nio 的 watchservice 通过注册目录监听事件来监控文件变化,核心做法是调用 register() 方法并处理 watchkey。它会返回包含 standardwatcheventkinds 的事件列表,开发者需轮询获取这些事件以执行后续逻辑。

如何注册目录并启动监听循环
要开始监控,必须创建一个 WatchService 实例,并将目标目录作为 Path 对象注册到该服务中。注册时需指定感兴趣的事件类型,如创建、修改或删除。随后进入一个无限循环,不断调用 take() 或 poll() 获取 WatchKey,遍历其上的事件进行处理,并在处理完毕后调用 reset() 重置键以继续接收新事件。

import java.nio.file.*;
import java.nio.file.attribute.BasicFileAttributes;
import java.io.IOException;
public class FileMonitor {
public static void main(String[] args) throws Exception {
Path dir = Paths.get("./test_dir");
WatchService watcher = FileSystems.getDefault().newWatchService();
// 注册目录,监听所有标准事件
dir.register(watcher,
StandardWatchEventKinds.ENTRY_CREATE,
StandardWatchEventKinds.ENTRY_MODIFY,
StandardWatchEventKinds.ENTRY_DELETE);
System.out.println("Monitoring started...");
while (true) {
WatchKey key = watcher.take(); // 阻塞直到有事件
for (WatchEvent<?> event : key.pollEvents()) {
WatchEvent.Kind<?> kind = event.kind();
if (kind == StandardWatchEventKinds.OVERFLOW) continue;
WatchEvent<Path> pathEvent = (WatchEvent<Path>) event;
Path filename = pathEvent.context();
System.out.println(kind + " : " + filename);
}
boolean valid = key.reset();
if (!valid) break;
}
}
}如何处理并发与事件丢失问题
在实际应用中,直接调用 take() 可能会因为处理耗时导致事件堆积或丢失。最佳实践是将 WatchKey 放入队列或使用线程池异步处理。此外,WatchService 在某些文件系统(如 Windows)上可能无法区分文件的“修改”和“创建”,或者在大量文件变动时触发 OVERFLOW 事件。此时应检查事件类型,若为 OVERFLOW 则忽略或重新扫描目录状态,确保系统稳定性。
使用 Husky 将 pre-commit、pre-push 和 commit-msg 检查集成到仓库中,以便代理和开发人员在更改离开工作站之前运行相同的本地防护措施。
立即学习“Java免费学习笔记(深入)”;

// 伪代码:使用队列处理事件
BlockingQueue<WatchKey> queue = new LinkedBlockingQueue<>();
new Thread(() -> {
try {
while(true) {
WatchKey key = watcher.take();
queue.put(key); // 非阻塞放入队列
}
} catch (InterruptedException e) { ... }
}).start();
// 主线程或另一线程从队列取出处理
while(!queue.isEmpty()) {
WatchKey key = queue.poll();
if(key != null) processEvents(key);
}当发生 ENTRY_MODIFY 时如何判断文件是否已写入完成
ENTRY_MODIFY 事件仅在文件属性或内容发生变化时触发,但它不保证文件写入操作已完成。如果程序在收到该事件后立即读取文件,可能会读到不完整的数据。解决方法是引入简单的延迟重试机制或检查文件句柄占用情况。例如,尝试以独占模式打开文件,若成功则说明写入结束;或者捕获 IOException 并重试几次,直到能正常读取为止。

















