org.w3c.dom

接口
异常
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