compact1, compact2, compact3

java.nio.file

Interface WatchKey

public interface WatchKey

一个令牌代表一个 WatchService watchable对象登记。

一看关键时创建的一个值得注意的对象是一个手表服务注册。关键仍然valid直到：

1. 是取消、明确，通过调用其cancel方法，或
2. 取消隐式的，因为对象不再是可访问的，或
3. 通过closing手表服务。

一个手表键有一个状态。当最初创建的关键是说要准备好。当一个事件被检测到的关键信号和排队，可以通过调用监视服务的poll或take方法检索。一旦发出信号，关键仍然处于这种状态，直到它的reset方法调用返回到就绪状态的关键。检测到的事件，而关键是在信号状态中的队列，但不导致密钥重新排队，从手表服务的检索。事件被调用的关键的pollEvents方法检索。此方法检索和删除对象所累积的所有事件。当最初创建时，一个表键没有挂起的事件。通常情况下，事件被检索时，关键是在信号状态导致下面的成语：

为（；；）/检索键watchkey关键=守望者。take()；/ /处理事件对于（watchevent <？>事件：关键。pollevents()）{：}/重置键布尔有效=关键。reset()；如果（！有效）{不再注册的对象}}

观看键是安全的，使用多个并发线程。那里有几个线程检索表示钥匙手表服务则应注意确保reset方法只被调用后，该对象的事件已处理。这确保一个线程正在处理对象的事件在任何时间。

从以下版本开始：

一点七

方法摘要

Modifier and Type	Method and Description
void	cancel() 取消手表服务的注册。
boolean	isValid() 告诉是否这个表密钥是有效的。
List<WatchEvent<?>>	pollEvents() 检索并移除所有悬而未决的事件，这表键，返回 List撷取的事件。
boolean	reset() 重置该关注的关键。
Watchable	watchable() 返回创建此表键的对象。

方法详细信息

isValid

boolean isValid()

告诉是否这个表密钥是有效的。

手表键在创建和保留时有效，直到它被取消，或者它的监视服务关闭。

结果

true如果，如果，这只表是有效的

pollEvents

List<WatchEvent<?>> pollEvents()

检索并移除所有悬而未决的事件，这表键，返回 List撷取的事件。

请注意，此方法不等待是否有任何事件悬而未决。

结果

检索的事件的列表；可能是空的

reset

boolean reset()

重置该关注的关键。

如果此表键已被取消，或此表键已处于就绪状态，则调用此方法没有任何效果。否则，如果有挂起的事件的对象，然后这个表的关键是立即重新排队到手表服务。如果没有挂起的事件，则观看键进入准备状态，并将保持在该状态，直到检测到事件或观看键被取消。

结果

true如果手表的关键是有效的和已复位，并 false如果手表钥匙不能复位，因为它不再是 valid

cancel

void cancel()

取消手表服务的注册。返回时，观看键将无效。如果手表钥匙排队，等待从手表服务检索，然后它会停留在队列中直到它被删除。悬而未决的事件，如果有的话，仍然悬而未决，可以通过调用 pollEvents方法后关键是取消检索。

如果这个表键已经被取消，那么调用这个方法没有任何效果。一旦取消，一个表键仍然无效。

watchable

Watchable watchable()

返回创建此表键的对象。即使取消了密钥，这种方法也将继续返回该对象。

作为WatchService旨在直接映射到本地文件的事件通知机制（如适用）那么许多如何注册对象的细节看是高度的具体实施。当监视示例的目录更改时，文件系统中的目录被移动或重命名，没有保证表键将被取消，因此该方法返回的对象将不再是目录的有效路径。

结果

创建此表键的对象