org.w3c.dom
接口 UserDataHandler

public interface UserDataHandler

当使用 Node.setUserData() 将一个对象与节点上的键相关联时，当克隆、导入或重命名该对象关联的节点时应用程序可以提供调用的处理程序。应用程序可以使用此方法实现与它与 DOM 节点相关联的数据有关的各种行为。此接口定义该处理程序。

另请参见 Document Object Model (DOM) Level 3 Core Specification。

从以下版本开始：

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。