public interface UserDataHandler
| org.w3c.dom.UserDataHandler |
当使用Node.setUserData()将对象与节点上的键相关联时，应用程序可以提供一个处理程序，该程序在被克隆，导入或重命名与该对象关联的节点时被调用。 应用程序可以使用它来实现与其关联到DOM节点的数据有关的各种行为。 该接口定义了该处理程序。
另请参阅 Document Object Model (DOM) Level 3 Core Specification 。
Constants |
|
|---|---|
short |
NODE_ADOPTED 该节点被采用，使用 |
short |
NODE_CLONED 该节点被克隆，使用 |
short |
NODE_DELETED 节点被删除。 |
short |
NODE_IMPORTED 该节点是使用 |
short |
NODE_RENAMED 节点被重新命名，使用 |
Public methods |
|
|---|---|
abstract void |
handle(short operation, String key, Object data, Node src, Node dst) 只要导入或克隆此处理程序注册的节点，就会调用此方法。 |
short NODE_ADOPTED
采用该节点，使用 Document.adoptNode() 。
常量值：5（0x00000005）
short NODE_DELETED
节点被删除。
注意：这可能不被支持，或者在某些环境中可能不可靠，例如Java，其中实现无法真正控制何时实际删除对象。
常量值：3（0x00000003）
short NODE_IMPORTED
该节点是使用 Document.importNode()导入的。
常量值：2（0x00000002）
short NODE_RENAMED
节点重命名，使用 Document.renameNode() 。
常量值：4（0x00000004）
Android开发手册
void handle (short operation,
String key,
Object data,
Node src,
Node dst)
只要导入或克隆此处理程序注册的节点，就会调用此方法。
DOM应用程序不得在UserDataHandler引发异常。 从处理程序中抛出异常的效果依赖于DOM实现。
| Parameters | |
|---|---|
operation |
short: Specifies the type of operation that is being performed on the node. |
key |
String: Specifies the key for which this handler is being called. |
data |
Object: Specifies the data for which this handler is being called. |
src |
Node: Specifies the node being cloned, adopted, imported, or renamed. This is null when the node is being deleted. |
dst |
Node: Specifies the node newly created if any, or null. |