Module java.xml
Package org.w3c.dom

Interface UserDataHandler

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

另请参阅文档对象模型（DOM）Level 3 核心规范。

自：
1.5，DOM Level 3

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    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()方法。

  • Method Summary

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

  • Field Details

    • 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()方法。
      另请参阅：

  • Method Details

    • handle

      void handle(short operation, String key, Object data, Node src, Node dst)
      每当注册了此处理程序的节点被导入或克隆时，将调用此方法。
      DOM应用程序不得在UserDataHandler中引发异常。从处理程序中抛出异常的影响取决于DOM实现。
      参数：
      operation - 指定正在对节点执行的操作类型。
      key - 指定调用此处理程序的键。
      data - 指定调用此处理程序的数据。
      src - 指定正在被克隆、采用、导入或重命名的节点。当节点被删除时，此值为null。
      dst - 指定新创建的节点（如果有），或null。