コンストラクターの詳細

• W3CDomHandler

  public W3CDomHandler()

  デフォルトのコンストラクター。使用する DOM 実装またはその構成方法を決定するのは Jakarta XML Binding プロバイダー次第です。

• W3CDomHandler

  public W3CDomHandler​(DocumentBuilderSE builder)

  アプリケーションが使用する DOM 実装を指定できるようにするコンストラクター。

  パラメーター:

  builder - null であってはなりません。Jakarta XML Binding は、この DocumentBuilderSE を使用して新しい要素を作成します。

メソッドの詳細

• getBuilder

  public DocumentBuilderSE getBuilder()

• setBuilder

  public void setBuilder​(DocumentBuilderSE builder)

• createUnmarshaller

  public DOMResultSE createUnmarshaller​(ValidationEventHandler errorHandler)

  インターフェースからコピーされた説明: DomHandler
  Jakarta XML Binding プロバイダーは、ドキュメントの一部を情報セット表現にアンマーシャリングする必要がある場合、最初にこのメソッドを呼び出して ResultSE オブジェクトを作成します。

  次に、Jakarta XML Binding プロバイダーは、XML の一部を指定された結果に送信します。このような部分は常に、要素をルートとする XML ドキュメント全体のサブツリーを形成します。

  次で指定:

  インターフェース DomHandler<ElementSE,​DOMResultSE> 内の createUnmarshaller 

  パラメーター:

  errorHandler - このメソッドの呼び出しと DomHandler.getElement(Result) の呼び出しの間にエラーが発生した場合は、このハンドラーに報告する必要があります。呼び出し元は、null 以外のエラーハンドラーを提供する必要があります。このメソッドから作成された ResultSE オブジェクトは、このエラーハンドラーへの参照を保持している可能性があります。

  戻り値:

  操作が失敗した場合は null。エラーはエラーハンドラーに報告されている必要があります。

• getElement

  public ElementSE getElement​(DOMResultSE r)

  インターフェースからコピーされた説明: DomHandler
  部分が ResultSE に送信されたら。このメソッドは、マーシャリングされていない要素表現を取得するために Jakarta XML Binding プロバイダーによって呼び出されます。

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

  次で指定:

  インターフェース DomHandler<ElementSE,​DOMResultSE> 内の getElement 

  パラメーター:

  r - DomHandler.createUnmarshaller(ValidationEventHandler) によって作成された ResultSE オブジェクト。

  戻り値:

  操作が失敗した場合は null。エラーはエラーハンドラーに報告されている必要があります。

• marshal

  public SourceSE marshal​(ElementSE element,
                        ValidationEventHandler errorHandler)

  インターフェースからコピーされた説明: DomHandler
  このメソッドは、Jakarta XML Binding プロバイダーが要素を XML にマーシャリングする必要がある場合に呼び出されます。

  null 以外の場合、返される SourceSE には、1 つの要素をルートとするドキュメント全体が含まれている必要があります。このドキュメントは、Jakarta XML Binding プロバイダーがマーシャリングしているより大きなドキュメントに織り込まれます。

  次で指定:

  インターフェース DomHandler<ElementSE,​DOMResultSE> 内の marshal 

  errorHandler - 要素を SourceSE に変換するプロセス中に発生したエラーを受け取ります。呼び出し元は、null 以外のエラーハンドラーを提供する必要があります。

  戻り値:

  エラーがあった場合は null。エラーはハンドラーに報告されているはずです。