org.w3c.dom

インタフェース UserDataHandler

public interface UserDataHandler

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

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

導入されたバージョン:

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

メソッドのサマリー

メソッド

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