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