public interface UserDataHandler
当使用 Node.setUserData()
将一个对象与节点上的键相关联时,当克隆、导入或重命名该对象关联的节点时应用程序可以提供调用的处理程序。应用程序可以使用此方法实现与它与 DOM 节点相关联的数据有关的各种行为。此接口定义该处理程序。
另请参见 Document Object Model (DOM) Level 3 Core Specification。
字段摘要 | |
---|---|
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) 每当导入或克隆为其注册此处理程序的节点时,调用此方法。 |
字段详细信息 |
---|
static final short NODE_CLONED
Node.cloneNode()
克隆节点。
static final short NODE_IMPORTED
Document.importNode()
导入节点。
static final short NODE_DELETED
注:在某些环境(如 Java)中,此方法可能不被支持或可能不可靠,在此情况下,实现不具备真正控制何时实际删除对象。
static final short NODE_RENAMED
Document.renameNode()
重命名节点。
static final short NODE_ADOPTED
Document.adoptNode()
采用节点。
方法详细信息 |
---|
void handle(short operation, String key, Object data, Node src, Node dst)
UserDataHandler
中引发异常。从处理程序抛出异常所产生的影响与 DOM 实现有关。
operation
- 指定在节点上正在执行的操作的类型。
key
- 指定正在为其调用此处理程序的键。
data
- 指定正在为其调用此处理程序的数据。
src
- 指定正在被克隆、采用、导入或重命名的节点。正在删除节点时,这为
null
。
dst
- 指定新创建的节点(如果有),或
null
。