モジュール 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()を使用して、ノードの名前を変更します。

    • フィールドの詳細

      • 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。