模块 java.xml
包 org.w3c.dom

接口 UserDataHandler

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

另见 文档对象模型 (DOM) 级别 3 核心规范 。

自从：
1.5，DOM 级别 3

  • 字段摘要

    字段
    修饰符和类型
    Field
    描述
    static final short
    NODE_ADOPTED
    节点被采用，使用 Document.adoptNode() 。
    static final short
    NODE_CLONED
    使用 Node.cloneNode() 克隆节点。
    static final short
    NODE_DELETED
    节点被删除。
    static final short
    NODE_IMPORTED
    使用 Document.importNode() 导入节点。
    static final 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 。