Module java.xml

软件包 org.w3c.dom

Interface UserDataHandler

public interface UserDataHandler

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

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

从以下版本开始：

1.5，DOM 3级

Field Summary

Fields

Modifier and Type	Field	描述
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() 。

方法摘要

Modifier and Type	方法	描述
void	handle(short operation, String key, Object data, Node src, Node dst)	每当注册此处理程序的节点被导入或克隆时，都会调用此方法。

字段详细信息

NODE_CLONED

static final short NODE_CLONED

该节点被克隆，使用 Node.cloneNode() 。

另请参见：

Constant Field Values

NODE_IMPORTED

static final short NODE_IMPORTED

导入节点，使用 Document.importNode() 。

另请参见：

Constant Field Values

NODE_DELETED

static final short NODE_DELETED

节点被删除。

注意：这在某些环境中可能不受支持或可能不可靠，例如Java，其中实现对实际删除对象无实际控制。

另请参见：

Constant Field Values

NODE_RENAMED

static final short NODE_RENAMED

该节点被重命名，使用 Document.renameNode() 。

另请参见：

Constant Field Values

NODE_ADOPTED

static final short NODE_ADOPTED

采用节点，采用 Document.adoptNode() 。

另请参见：

Constant Field Values

方法详细信息

handle

void handle(short operation,
            String key,
            Object data,
            Node src,
            Node dst)

每当注册此处理程序的节点被导入或克隆时，都会调用此方法。
DOM应用程序不得在UserDataHandler引发异常。 从处理程序中抛出异常的效果是依赖于DOM实现的。

参数

operation - 指定在节点上执行的操作类型。

key - 指定要调用此处理程序的键。

data - 指定正在调用此处理程序的数据。

src - 指定要克隆，采用，导入或重命名的节点。 当节点被删除时，这是null 。

dst - 指定新创建的节点（如果有），或 null 。