模块  java.base
软件包  java.nio.file

Interface Watchable

    • 方法详细信息

      • register

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

        如果此对象标识的文件系统对象当前已向监视服务注册,则在将事件集或修饰符更改为eventsmodifiers参数指定的事件集后,将返回表示该注册的监视键。 更改事件集不会导致丢弃对象的挂起事件。 对象会自动注册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.