モジュール java.xml
パッケージ org.w3c.dom

インタフェースUserDataHandler

public interface UserDataHandler
Node.setUserData()を使用してノードのキーにオブジェクトを関連付けると、アプリケーションでは、そのオブジェクトが関連付けられているノードが複製、インポート、または名前変更されるときに呼び出されるハンドラを提供できます。 アプリケーションでは、このハンドラを使用して、DOMノードに関連させるデータに関するさまざまな動作を実装できます。 このインタフェースは、このようなハンドラを定義します。

「Document Object Model (DOM) Level 3 Core Specification」も参照してください。

導入されたバージョン:
1.5、DOMレベル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()を使用して、ノードの名前を変更します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    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。