クラス W3CDomHandler

    • コンストラクターの詳細

      • W3CDomHandler

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

        public W3CDomHandler​(DocumentBuilderSE builder)
        アプリケーションが使用する DOM 実装を指定できるようにするコンストラクター。
        パラメーター:
        builder - null であってはなりません。Jakarta XML Binding は、この DocumentBuilderSE を使用して新しい要素を作成します。
    • メソッドの詳細

      • 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。エラーはハンドラーに報告されているはずです。