Интерфейс Watchable

Все известные подинтерфейсы:: 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...)

Методы

Модификатор и тип	Метод	Описание
`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 - если произошла ошибка ввода-вывода; 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 - если произошла ошибка ввода-вывода; SecurityException - если установлен менеджер безопасности и он запрещает неопределенное разрешение, необходимое для мониторинга этого объекта. Реализации этого интерфейса должны указать проверки разрешений.