Интерфейс UserDataHandler

public interface UserDataHandler

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

См. также Спецификацию базового уровня 3 объектной модели документа (DOM).

Начиная с:: 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://docs.oracle.com/en/java/javase/25/docs/api/java.xml/org/w3c/dom/UserDataHandler.html