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

メソッドのサマリー

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