クラス W3CDomHandler
- java.lang.ObjectSE
-
- jakarta.xml.bind.annotation.W3CDomHandler
- 実装されたすべてのインターフェース:
DomHandler<ElementSE,DOMResultSE>
public class W3CDomHandler extends ObjectSE implements DomHandler<ElementSE,DOMResultSE>
W3CDOM のDomHandler
実装 (org.w3c.dom
パッケージ。)- 導入:
- 1.6、JAXB 2.0
- 作成者:
- Kohsuke Kawaguchi
コンストラクターのサマリー
コンストラクター コンストラクター 説明 W3CDomHandler()
デフォルトコンストラクター。W3CDomHandler(DocumentBuilderSE builder)
アプリケーションが使用する DOM 実装を指定できるようにするコンストラクター。
メソッドのサマリー
すべてのメソッド インスタンスメソッド 具象メソッド 修飾子と型 メソッド 説明 DOMResultSE
createUnmarshaller(ValidationEventHandler errorHandler)
Jakarta XML Binding プロバイダーは、ドキュメントの一部を情報セット表現にアンマーシャリングする必要がある場合、最初にこのメソッドを呼び出してResult
SE オブジェクトを作成します。DocumentBuilderSE
getBuilder()
ElementSE
getElement(DOMResultSE r)
部分がResult
SE に送信されたら。SourceSE
marshal(ElementSE element, ValidationEventHandler errorHandler)
このメソッドは、Jakarta XML Binding プロバイダーが要素を XML にマーシャリングする必要がある場合に呼び出されます。void
setBuilder(DocumentBuilderSE builder)
コンストラクターの詳細
W3CDomHandler
public W3CDomHandler()
デフォルトのコンストラクター。使用する DOM 実装またはその構成方法を決定するのは Jakarta XML Binding プロバイダー次第です。
W3CDomHandler
public W3CDomHandler(DocumentBuilderSE builder)
アプリケーションが使用する DOM 実装を指定できるようにするコンストラクター。- パラメーター:
builder
- null であってはなりません。Jakarta XML Binding は、このDocumentBuilder
SE を使用して新しい要素を作成します。
メソッドの詳細
getBuilder
public DocumentBuilderSE getBuilder()
setBuilder
public void setBuilder(DocumentBuilderSE builder)
createUnmarshaller
public DOMResultSE createUnmarshaller(ValidationEventHandler errorHandler)
インターフェースからコピーされた説明:DomHandler
Jakarta XML Binding プロバイダーは、ドキュメントの一部を情報セット表現にアンマーシャリングする必要がある場合、最初にこのメソッドを呼び出してResult
SE オブジェクトを作成します。次に、Jakarta XML Binding プロバイダーは、XML の一部を指定された結果に送信します。このような部分は常に、要素をルートとする XML ドキュメント全体のサブツリーを形成します。
- 次で指定:
- インターフェース
DomHandler<ElementSE,DOMResultSE>
のcreateUnmarshaller
- パラメーター:
errorHandler
- このメソッドの呼び出しとDomHandler.getElement(Result)
の呼び出しの間にエラーが発生した場合は、このハンドラーに報告する必要があります。呼び出し元は、null 以外のエラーハンドラーを提供する必要があります。このメソッドから作成されたResult
SE オブジェクトは、このエラーハンドラーへの参照を保持している可能性があります。- 戻り値:
- 操作が失敗した場合は null。エラーはエラーハンドラーに報告されている必要があります。
getElement
public ElementSE getElement(DOMResultSE r)
インターフェースからコピーされた説明:DomHandler
部分がResult
SE に送信されたら。このメソッドは、マーシャリングされていない要素表現を取得するために Jakarta XML Binding プロバイダーによって呼び出されます。このメソッドを複数回呼び出すと、異なるオブジェクトが返される場合があります。このメソッドは、サブツリー全体が
Result
SE オブジェクトに供給される場合にのみ呼び出すことができます。- 次で指定:
- インターフェース
DomHandler<ElementSE,DOMResultSE>
のgetElement
- パラメーター:
r
-DomHandler.createUnmarshaller(ValidationEventHandler)
によって作成されたResult
SE オブジェクト。- 戻り値:
- 操作が失敗した場合は null。エラーはエラーハンドラーに報告されている必要があります。
marshal
public SourceSE marshal(ElementSE element, ValidationEventHandler errorHandler)
インターフェースからコピーされた説明:DomHandler
このメソッドは、Jakarta XML Binding プロバイダーが要素を XML にマーシャリングする必要がある場合に呼び出されます。null 以外の場合、返される
Source
SE には、1 つの要素をルートとするドキュメント全体が含まれている必要があります。このドキュメントは、Jakarta XML Binding プロバイダーがマーシャリングしているより大きなドキュメントに織り込まれます。- 次で指定:
- インターフェース
DomHandler<ElementSE,DOMResultSE>
のmarshal
errorHandler
- 要素をSource
SE に変換するプロセス中に発生したエラーを受け取ります。呼び出し元は、null 以外のエラーハンドラーを提供する必要があります。- 戻り値:
- エラーがあった場合は null。エラーはハンドラーに報告されているはずです。