模块  java.xml
软件包  org.w3c.dom

Interface UserDataHandler


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

    另见Document Object Model (DOM) Level 3 Core Specification

    从以下版本开始:
    1.5,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()重命名该节点。
    • 字段详细信息

      • 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