JavaTM Platform
Standard Ed. 6

javax.xml.bind.annotation
インタフェース DomHandler<ElementT,ResultT extends Result>

既知の実装クラスの一覧:
W3CDomHandler

public interface DomHandler<ElementT,ResultT extends Result>

要素 (とその子孫) を DOM (または類似) 表現に、またはその逆方向に変換します。

XML の要素を W3C DOM などの情報セット表現にマップするために、このインタフェースの実装が XmlAnyElement 注釈と組み合わせて使用されます。

XML の一部を DOM 式の表現に変換する方法やその逆方向の変換方法は実装側が非表示にするため、JAXB プロバイダはこうした任意のライブラリを扱うことができます。

このインタフェースは、ライブラリ作成者によって実装され、JAXB プロバイダによって使用されることを意図しています。これらのメソッドは、アプリケーションから呼び出されることを想定していません。

導入されたバージョン:
JAXB2.0

メソッドの概要
 ResultT createUnmarshaller(ValidationEventHandler errorHandler)
          文書の一部を情報セット表現に非整列化する必要がある場合、JAXB プロバイダは最初にこのメソッドを呼び出して Result オブジェクトを作成します。
 ElementT getElement(ResultT rt)
          一部が Result に一度送信されたあとに使用されます。
 Source marshal(ElementT n, ValidationEventHandler errorHandler)
          JAXB プロバイダが要素を XML に整列化する必要がある場合、このメソッドは呼び出されます。
 

メソッドの詳細

createUnmarshaller

ResultT createUnmarshaller(ValidationEventHandler errorHandler)
文書の一部を情報セット表現に非整列化する必要がある場合、JAXB プロバイダは最初にこのメソッドを呼び出して Result オブジェクトを作成します。

その後、JAXB プロバイダは XML の一部を、与えられた結果内に送信します。こうした XML の一部は常に、ある要素をルートとする XML 文書全体のサブツリーを形成します。

パラメータ:
errorHandler - このメソッドの呼び出しと getElement(Result) の呼び出しの間にエラーが発生した場合、エラーがこのハンドラに報告される必要がある 呼び出し側は、null でないエラーハンドラを提供する必要があります。 このメソッドから作成された Result オブジェクトがこのエラーハンドラへの参照を保持する場合があります。
戻り値:
処理が失敗した場合、null。エラーはエラーハンドラに報告されている必要がある

getElement

ElementT getElement(ResultT rt)
一部が Result に一度送信されたあとに使用されます。このメソッドは、非整列化された要素表現を取得するために JAXB プロバイダによって呼び出されます。

このメソッドを複数回呼び出した場合、異なるオブジェクトが返される可能性があります。このメソッドは、サブツリー全体が Result オブジェクトに送られた場合のみ呼び出すことができます。

パラメータ:
rt - createUnmarshaller(ValidationEventHandler) で作成された Result オブジェクト
戻り値:
処理が失敗した場合、null。エラーはエラーハンドラに報告されている必要がある

marshal

Source marshal(ElementT n,
               ValidationEventHandler errorHandler)
JAXB プロバイダが要素を XML に整列化する必要がある場合、このメソッドは呼び出されます。

戻り値の Source が null 以外の場合、ある要素をルートとする文書全体を含むはずであり、後にそれは JAXB が整列化するより大きな文書内に組み込まれます。

パラメータ:
errorHandler - 要素を Source に変換している途中で発生したエラーを受け取る 呼び出し側は、null でないエラーハンドラを提供する必要があります。
戻り値:
エラーが発生した場合、null。エラーはエラーハンドラに報告されているはずである

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。