Интерфейс UserDataHandler

public interface UserDataHandler

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

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

Since:: 1.5, DOM Level 3

Поля

Модификатор и тип	Поле	Описание
`static short`	`NODE_ADOPTED`	Узел принят с использованием `Document.adoptNode()`.
`static short`	`NODE_CLONED`	Узел клонирован с использованием `Node.cloneNode()`.
`static short`	`NODE_DELETED`	Узел удалён.
`static short`	`NODE_IMPORTED`	Узел импортирован с использованием `Document.importNode()`.
`static 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.