public interface DomHandler<ElementT,ResultT extends ResultSE>
このインターフェースの実装は、XmlAnyElement
アノテーションと組み合わせて使用され、XML の要素を W3CDOM などの情報セットの表現にマップします。
実装は、XML の一部がそのような DOM のような表現にどのように変換されるかを隠し、Jakarta XML Binding プロバイダーがそのような任意のライブラリを操作できるようにします。
このインターフェースは、ライブラリ作成者によって実装され、Jakarta XML Binding プロバイダーによって使用されることを目的としています。これらのメソッドはいずれも、アプリケーションから呼び出すことを目的としたものではありません。
修飾子と型 | メソッドと説明 |
---|---|
ResultT | createUnmarshaller(ValidationEventHandler errorHandler) Jakarta XML Binding プロバイダーは、ドキュメントの一部を情報セット表現にアンマーシャリングする必要がある場合、最初にこのメソッドを呼び出して Result SE オブジェクトを作成します。 |
ElementT | getElement(ResultT rt) 部分が Result SE に送信されたら。 |
SourceSE | marshal(ElementT n, ValidationEventHandler errorHandler) このメソッドは、Jakarta XML Binding プロバイダーが要素を XML にマーシャリングする必要がある場合に呼び出されます。 |
ResultT createUnmarshaller(ValidationEventHandler errorHandler)
Result
SE オブジェクトを作成します。次に、Jakarta XML Binding プロバイダーは、XML の一部を指定された結果に送信します。このような部分は常に、要素をルートとする XML ドキュメント全体のサブツリーを形成します。
errorHandler
- このメソッドの呼び出しと getElement(Result)
の呼び出しの間にエラーが発生した場合は、このハンドラーに報告する必要があります。呼び出し元は、null 以外のエラーハンドラーを提供する必要があります。このメソッドから作成された Result
SE オブジェクトは、このエラーハンドラーへの参照を保持している可能性があります。ElementT getElement(ResultT rt)
Result
SE に送信されたら。このメソッドは、マーシャリングされていない要素表現を取得するために Jakarta XML Binding プロバイダーによって呼び出されます。 このメソッドを複数回呼び出すと、異なるオブジェクトが返される場合があります。このメソッドは、サブツリー全体が Result
SE オブジェクトに供給される場合にのみ呼び出すことができます。
rt
- createUnmarshaller(ValidationEventHandler)
によって作成された Result
SE オブジェクト。SourceSE marshal(ElementT n, ValidationEventHandler errorHandler)
null 以外の場合、返される Source
SE には、1 つの要素をルートとするドキュメント全体が含まれている必要があります。このドキュメントは、Jakarta XML Binding プロバイダーがマーシャリングしているより大きなドキュメントに織り込まれます。
errorHandler
- 要素を Source
SE に変換するプロセス中に発生したエラーを受け取ります。呼び出し元は、null 以外のエラーハンドラーを提供する必要があります。Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.