compact1, compact2, compact3

java.nio.file

Interface Watchable

All Known Subinterfaces:

Path

public interface Watchable

可以注册到手表服务的对象，以便可以观看更改和事件。

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

从以下版本开始：

1.7

另请参见：

Path.register(java.nio.file.WatchService, java.nio.file.WatchEvent.Kind<?>[], java.nio.file.WatchEvent.Modifier...)

方法摘要

Modifier and Type	Method and Description
WatchKey	register(WatchService watcher, WatchEvent.Kind<?>... events) 用手表服务注册一个对象。
WatchKey	register(WatchService watcher, WatchEvent.Kind<?>[] events, WatchEvent.Modifier... modifiers) 用手表服务注册一个对象。

方法详细信息

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 - if a security manager is installed and it denies an unspecified permission required to monitor this object. Implementations of this interface should specify the permission checks.