javax.xml.bind.util

クラスJAXBResult

java.lang.Object

javax.xml.transform.sax.SAXResult

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メソッドを呼び出さないでください。

フィールドのサマリー

クラス javax.xml.transform.sax.SAXResultから継承されたフィールド

FEATURE

インタフェース javax.xml.transform.Resultから継承されたフィールド

PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
JAXBResult(JAXBContext context) 非整列化するために指定されたJAXBContextを使用した新しいインスタンスを作成します。
JAXBResult(Unmarshaller _unmarshaller) オブジェクトを非整列化するために指定されたUnmarshallerを使用した新しいインスタンスを作成します。

メソッドのサマリー

修飾子と型	メソッドと説明
Object	getResult() 変換によって作成された非整列化済みオブジェクトを取得します。

クラス javax.xml.transform.sax.SAXResultから継承されたメソッド

getHandler, getLexicalHandler, getSystemId, setHandler, setLexicalHandler, setSystemId

クラス java.lang.Objectから継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

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をスローすることを許可されている。