Интерфейс UserDataHandler

public interface UserDataHandler

При связывании объекта с ключом на узле с помощью Node.setUserData(), приложение может предоставить обработчик, который вызывается, когда узел, к которому связан объект, клонируется, импортируется или переименовывается. Это позволяет приложению реализовать различные действия, связанные с данными, которые оно связывает с узлами DOM. Этот интерфейс определяет этот обработчик.

См. также Спецификацию Document Object Model (DOM) Level 3 Core.

Since:: 1.5, DOM Level 3

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final short`	`NODE_ADOPTED`	Узел принимается с помощью `Document.adoptNode()`.
`static final short`	`NODE_CLONED`	Узел клонируется с помощью `Node.cloneNode()`.
`static final short`	`NODE_DELETED`	Узел удаляется.
`static final short`	`NODE_IMPORTED`	Узел импортируется с помощью `Document.importNode()`.
`static final short`	`NODE_RENAMED`	Узел переименовывается с помощью `Document.renameNode()`.

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

Модификатор и тип	Метод	Описание
`void`	`handle(short operation, String key, Object data, Node src, Node dst)`	Этот метод вызывается всякий раз, когда узел, для которого зарегистрирован этот обработчик, импортируется или клонируется.

Подробное описание полей

NODE_CLONED

static final short NODE_CLONED

Узел клонируется с помощью Node.cloneNode().

См. также:

NODE_IMPORTED

static final short NODE_IMPORTED

Узел импортируется с помощью Document.importNode().

См. также:

NODE_DELETED

static final short NODE_DELETED

Узел удаляется.

Примечание: Эта возможность может быть не поддерживается или может не работать надёжно в некоторых средах, таких как Java, где реализация не имеет реального контроля над временем фактического удаления объектов.

См. также:

NODE_RENAMED

static final short NODE_RENAMED

Узел переименовывается с помощью Document.renameNode().

См. также:

NODE_ADOPTED

static final short NODE_ADOPTED

Узел принимается с помощью Document.adoptNode().

См. также:

Подробное описание методов

handle

void handle(short operation, String key, Object data, Node src, Node dst)

Этот метод вызывается всякий раз, когда узел, для которого зарегистрирован этот обработчик, импортируется или клонируется.
Приложения DOM не должны генерировать исключения в UserDataHandler. Последствия генерации исключений обработчиком зависят от реализации DOM.

Параметры:: operation - Указывает тип операции, выполняемой над узлом.; key - Указывает ключ, для которого вызывается этот обработчик.; data - Указывает данные, для которых вызывается этот обработчик.; src - Указывает узел, который клонируется, принимается, импортируется или переименовывается. Он равен null, когда узел удаляется.; dst - Указывает новый созданный узел, если он есть, или null.

© 1993, 2023, 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/21/docs/api/java.xml/org/w3c/dom/UserDataHandler.html