Интерфейс 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/nio/file/Watchable.html