模块 java.base
包 java.nio.file

接口 Watchable

所有已知的子接口：
Path
public interface Watchable
一个可以注册到监视服务的对象，以便它可以 watched 用于更改和事件。

这个接口定义了register 方法来注册对象，一个WatchService 返回一个WatchKey 代表注册。一个对象可以注册多个监视服务。通过调用密钥的 cancel 方法取消手表服务的注册。

自从：
1.7
参见：

  • 方法详情

    • register

      WatchKey  register(WatchService  watcher, WatchEvent.Kind <?>[] events, WatchEvent.Modifier ... modifiers) throws IOException
      向监视服务注册对象。

      如果此对象标识的文件系统对象当前已向监视服务注册，则在将事件集或修饰符更改为 events 和 modifiers 参数指定的事件集或修饰符后，将返回代表该注册的监视键。更改事件集不会导致对象的未决事件被丢弃。对象自动注册为 OVERFLOW 事件。该事件不需要出现在事件数组中。

      否则，文件系统对象尚未注册到给定的监视服务，因此它已注册并返回生成的新密钥。

      此接口的实现应指定它们支持的事件。

      参数：
      watcher - 此对象要注册到的监视服务
      events - 该对象应注册的事件
      modifiers - 修改对象注册方式的修饰符（如果有）
      返回：
      表示此对象向给定监视服务注册的键
      抛出：
      UnsupportedOperationException - 如果指定了不支持的事件或修饰符
      IllegalArgumentException - 如果指定了无效的事件组合修饰符
      ClosedWatchServiceException - 如果手表服务关闭
      IOException - 如果发生 I/O 错误
      SecurityException - 如果安装了安全管理器并且它拒绝监视此对象所需的未指定权限。此接口的实现应指定权限检查。

    • register

      WatchKey  register(WatchService  watcher, WatchEvent.Kind <?>... events) throws IOException
      向监视服务注册对象。

      此方法的调用与调用的行为完全相同

         watchable.register (watcher, events, new WatchEvent.Modifier[0]);
      参数：
      watcher - 此对象要注册到的监视服务
      events - 该对象应注册的事件
      返回：
      表示此对象向给定监视服务注册的键
      抛出：
      UnsupportedOperationException - 如果指定了不支持的事件
      IllegalArgumentException - 如果指定了无效的事件组合
      ClosedWatchServiceException - 如果手表服务关闭
      IOException - 如果发生 I/O 错误
      SecurityException - 如果安装了安全管理器并且它拒绝监视此对象所需的未指定权限。此接口的实现应指定权限检查。