モジュール java.xml.bind
パッケージ javax.xml.bind.util

クラスJAXBResult

  • すべての実装されたインタフェース:
    Result
    public class JAXBResult
extends SAXResult
    JAXBオブジェクトを非整列化するJAXP Result実装です。

    このユーティリティ・クラスは、ほかのJava/XMLテクノロジとJAXBを結合させる上で役立ちます。

    次の例は、XSLT変換の結果である文書をJAXBを使用して非整列化する方法を示します。 

           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

    • コンストラクタの詳細

      • JAXBResult

        public JAXBResult​(JAXBContext context)
           throws JAXBException
        非整列化するために指定されたJAXBContextを使用した新しいインスタンスを作成します。
        パラメータ:
        context - 必要なUnmarshallerの作成に使用されるJAXBContext。 このパラメータはnullであってはならない。
        例外:
        JAXBException - JAXBResultの作成中にエラーが発生した場合、またはcontextパラメータがnullの場合。

      • JAXBResult

        public JAXBResult​(Unmarshaller _unmarshaller)
           throws JAXBException
        オブジェクトを非整列化するために指定されたUnmarshallerを使用した新しいインスタンスを作成します。

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

        このメソッドの主な目的は、クライアントがUnmarshallerを設定できるようにすることです。 明確な目的がある場合を除き、JAXBContextを渡す方がより簡単で安全です。

        パラメータ:
        _unmarshaller - unmarshaller。 このパラメータはnullであってはならない。
        例外:
        JAXBException - JAXBResultの作成中にエラーが発生した場合、またはUnmarshallerパラメータがnullの場合。

    • メソッドの詳細

      • getResult

        public Object getResult()
                 throws JAXBException
        変換によって作成された非整列化済みオブジェクトを取得します。
        戻り値:
        常にnull以外のオブジェクトを返す。
        例外:
        IllegalStateException - オブジェクトが非整列化される前にこのメソッドが呼び出された場合。
        JAXBException - 非整列化エラーが存在する場合。 この実装は、構文解析中にエラーを検出した場合、SAXExceptionをスローすることを許可されている。