Интерфейс Watchable

Все известные подинтерфейсы:: Путь

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

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.