WatchService 直接映射到 native file event notification mechanism,如果原生文件时间通知机制不可用,默认实现就会使用 polling 方式。
1. JDK的实现风格,java.nio.file.Path接口对应一个java.nio.file.Paths静态方法工具类。Path接口定义了register()方法,接受WatchService object作为第一个参数,一个WatchEvent.Kind类型的可变参数作为第二个参数。总共有 4 种events,ENTRY_CREATE, ENTRY_DELETE, ENTRY_MODIFY, OVERFLOW。OVERFLOW表示 events may been lost or discarded。如下创建并使用WatchService,
import static java.nio.file.StandardWatchEventKinds.*;
Path path = Paths.get("/home");
WatchService watchService = FileSystems.getDefault().newWatchService();
WatchKey watchKey = path.register(watchService,ENTRY_CREATE,ENTRY_DELETE,ENTRY_MODIFY);
2. Path.register()返回一个WatchKey对象。有3种方式可使WatchKey的状态变为invalid,一是调用Watchkey.cancel(),二是被监控的目录不再有效,三是关闭WatchService object。有2种方式从队列中得到WatchKey,一是调用WatchService.poll(),
WatchKey watchKey = watchService.poll(60,TimeUnit.SECONDS);
二是调用WatchService.take(),
WatchKey key = watcherService.take();
3. 处理事件
public void handleEvents() throws InterruptedException
{
while (true)
{
WatchKey key = watcher.take();
for (WatchEvent<?> event : key.pollEvents())
{
Kind<?> kind = event.kind();
if (kind == OVERFLOW)
{// 事件可能lost or discarded
continue;
}
Path fileName = (Path) event.context();
System.out.printf("Event %s has happened,which fileName is %s%n", kind.name(), fileName);
}
if (!key.reset())
{
break;
}
}
}
代码中有一处调用了reset()方法,reset()方法把WatchKey state置回'ready'状态。如果有pending event,就立即re-queued WatchKey,如果没有,就保持ready state,知道新事件到来。
4. 一些问题,
a. WatchService被监控目录的子目录事件(重命名只会引发 ENTRY_MODIFY,而根目录会触发 ENTRY_DELETE 和 ENTRY_CREATE ),
b. 我们必须poll the WatchSercie for events,而不能接受asynchronous notification。