パッケージ jakarta.xml.bind.util

クラス JAXBResult

  • 実装されているすべてのインターフェース:
    ResultSE
    public class JAXBResult
extends SAXResultSE
    Jakarta XML Binding オブジェクトをアンマーシャリングする JAXP ResultSE 実装。

    このユーティリティクラスは、Jakarta XML Binding を他の Java/XML テクノロジと組み合わせるのに役立ちます。

    次の例は、Jakarta XML Binding を使用して、XSLT 変換の結果であるドキュメントをアンマーシャリングする方法を示しています。

           JAXBResult result = new JAXBResult(
         JAXBContext.newInstance("org.acme.foo") );
       
       // set up XSLT transformation
       TransformerFactory tf = TransformerFactory.newInstance();
       Transformer t = tf.newTransformer(new StreamSource("test.xsl"));
       
       // run transformation
       t.transform(new StreamSource("document.xml"),result);
 
       // obtain the unmarshalled content tree
       Object o = result.getResult();

    JAXBResult が SAXResult から派生しているという事実は、実装の詳細です。一般的に、アプリケーションは SAXResult で定義されたメソッドにアクセスすることを強くお勧めしません。

    特に、setHandler、setLexicalHandler、setSystemId メソッドを呼び出そうとすることは決してありません。

    導入:
    1.6
    作成者:
    Kohsuke Kawaguchi (kohsuke.kawaguchi@sun.com)

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

      • JAXBResult

        public JAXBResult​(JAXBContext context)
           throws JAXBException
        指定された JAXBContext を使用してアンマーシャリングする新しいインスタンスを作成します。
        パラメーター:
        context - 必要な Unmarshaller を作成するために使用される JAXBContext。このパラメーターは null であってはなりません。
        例外:
        JAXBException - JAXBResult の作成中にエラーが発生した場合、またはコンテキストパラメーターが null の場合。

      • JAXBResult

        public JAXBResult​(Unmarshaller _unmarshaller)
           throws JAXBException
        指定された Unmarshaller を使用してオブジェクトをアンマーシャリングする新しいインスタンスを作成します。

        この JAXBResult オブジェクトは、指定された Unmarshaller インスタンスを使用します。このオブジェクトによって使用されている間、同じ Unmarshaller を他の目的に使用しないことは呼び出し側の責任です。

        このメソッドの主な目的は、クライアントが Unmarshaller を構成できるようにすることです。自分が何をしているのかを知らない限り、JAXBContext を渡す方が簡単で安全です。

        パラメーター:
        _unmarshaller - アンマーシャラー。このパラメーターは null であってはなりません。
        例外:
        JAXBException - JAXBResult の作成中にエラーが発生した場合、または Unmarshaller パラメーターが null の場合。

    • メソッドの詳細

      • getResult

        public ObjectSE getResult()
                 throws JAXBException
        変換によって作成されたマーシャリングされていないオブジェクトを取得します。
        戻り値:
        常に null 以外のオブジェクトを返します。
        例外:
        IllegalStateExceptionSE - オブジェクトがマーシャリング解除される前にこのメソッドが呼び出された場合。
        JAXBException - マーシャリング解除エラーがある場合。実装は、エラーが見つかった場合、解析中に SAXException をスローできることに注意してください。