compact1, compact2, compact3

java.nio.file

Interface WatchService

All Superinterfaces:

AutoCloseable， Closeable

public interface WatchService
extends Closeable

手表的服务，手表注册的对象的变化和事件。例如，一个文件管理器可以使用一个监视服务来监视一个目录，以便它可以在创建或删除文件时更新它的文件列表的显示。

一个Watchable对象是通过调用其方法register手表服务注册，返回一个WatchKey代表注册。当某个对象的事件检测的关键信号，如果没有信号，这是排队观看服务，则可以通过消费者调用poll或take方法检索键和处理事件。一旦事件已处理消费者调用关键的reset方法重置键可发出信号并重新排队进一步事件的关键。

一个手表服务注册是通过调用关键的cancel方法取消。一个键，在它被取消的时间在队列中保持在队列中，直到检索到它为止。根据对象，一个键可以自动取消。例如，假设一个目录被监视，而监视服务检测到它已被删除或它的文件系统不再访问。当一个键被取消，以这种方式，它是信号和排队，如果没有目前的信号。为确保消费者通知返回值从reset方法表明如果是有效的。

手表服务是安全的，使用多个并发的消费者。确保只有一个消费过程的事件为一个特定的对象，在任何时间，并应注意确保关键的reset方法只被调用后，事件已处理。的close方法可以在任何时候调用关闭造成任何线程等待取回钥匙的服务，把ClosedWatchServiceException。

文件系统可以更快地报告事件比它们可以被检索或处理和实现可能会对它可能积累的事件的数量施加一个未指定的限制。在一个实施故意丢弃事件，然后安排关键的pollEvents方法返回与OVERFLOW事件类型的一个元素。这个事件可以由消费者作为一个触发重新审视对象的状态。

当一个事件被报告表明在一个被监视的目录中的文件被修改，那么有没有保证的程序（或程序），已修改的文件已经完成。应注意协调与可能更新文件的其他程序的访问权限。类定义的FileChannel锁定与其他程序访问文件区域的方法。

平台依赖性

从文件系统中观察事件的实现，目的是直接映射到可用的本地文件事件通知设施，或使用一个原始的机制，如轮询，当一个本地设备不可用。因此，许多事件是如何被检测的细节，他们的及时性，以及他们的顺序是否被保存是高度实施的具体。例如，当在看目录修改文件时就可能导致一个ENTRY_MODIFY事件在一些实现中的几个事件，但是其他的实现。短寿命的文件（指被创建后很快被删除的文件）可能不会被原始的实现，定期轮询的文件系统检测到的变化。

如果一个监视文件不位于本地存储设备上，则它是实现特定的，如果对文件的更改可以被检测到。特别是，它不需要进行远程系统上的文件的更改进行检测。

从以下版本开始：

一点七

另请参见：

FileSystem.newWatchService()

方法摘要

Modifier and Type	Method and Description
void	close() 关闭此表服务。
WatchKey	poll() 检索和删除下一个关注的关键，如果不存在或 null。
WatchKey	poll(long timeout, TimeUnit unit) 检索和删除下一个表键，如果需要的话，等待指定的等待时间，如果没有仍然存在。
WatchKey	take() 检索和删除下一个表键，等待如果没有仍然存在。

方法详细信息

close

void close()
    throws IOException

关闭此表服务。

如果一个线程当前被阻塞在take或poll方法等进行排队，然后立即接收ClosedWatchServiceException关键。任何与此相关的有效键invalidated看服务。

在看服务是封闭的，任何试图调用操作上会把ClosedWatchServiceException。如果此表服务已关闭，则调用此方法没有任何效果。

Specified by:

close 接口 AutoCloseable

Specified by:

close 接口 Closeable

异常

IOException如果I/O错误发生

poll

WatchKey poll()

检索和删除下一个关注的关键，如果不存在或 null。

结果

下一个关注的关键，或 null

异常

ClosedWatchServiceException -如果这手表服务关闭

poll

WatchKey poll(long timeout,
              TimeUnit unit)
       throws InterruptedException

检索和删除下一个表键，如果需要的话，等待指定的等待时间，如果没有仍然存在。

参数

timeout -如何在放弃之前等待，在单位的单位

unit - TimeUnit确定如何解释超时参数

结果

下一个关注的关键，或 null

异常

ClosedWatchServiceException -如果这手表服务关闭，或是关闭，等待下一次按键

InterruptedException如果中断等待

take

WatchKey take()
       throws InterruptedException

检索和删除下一个表键，等待如果没有仍然存在。

结果

下一个观看键

异常

ClosedWatchServiceException -如果这手表服务关闭，或是关闭，等待下一次按键

InterruptedException如果中断等待