模块 java.xml

软件包 org.w3c.dom

Interface UserDataHandler

public interface UserDataHandler

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

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

从以下版本开始：

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 。