Интерфейс Watchable

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

public interface Watchable

Объект, который можно зарегистрировать в службе наблюдения, чтобы отслеживать его изменения и события.

Этот интерфейс определяет метод register для регистрации объекта в WatchService, возвращающий WatchKey, представляющий регистрацию. Объект можно зарегистрировать в нескольких службах наблюдения. Регистрация в службе наблюдения отменяется вызовом метода cancel ключа.

Начиная с:

1.7

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`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 — если произошла ошибка ввода-вывода

register

WatchKey register(WatchService watcher, WatchEvent.Kind<?>... events) throws IOException

Регистрирует объект в службе наблюдения.

Вызов этого метода действует точно так же, как вызов

    register.watcher, events, new WatchEvent.Modifier[0]);

Параметры:: watcher — служба наблюдения, в которой регистрируется этот объект; events — события, для которых следует зарегистрировать этот объект
Возвращает:: ключ, представляющий регистрацию этого объекта в указанной службе наблюдения
Вызывает исключение:: UnsupportedOperationException — если указаны неподдерживаемые события; IllegalArgumentException — если указана недопустимая комбинация событий; ClosedWatchServiceException — если служба наблюдения закрыта; IOException — если произошла ошибка ввода-вывода

© 1993, 2025, 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/nio/file/Watchable.html