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