Интерфейс 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, 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.xml/org/w3c/dom/UserDataHandler.html