javax.xml.bind.util

クラスJAXBSource

java.lang.Object

javax.xml.transform.sax.SAXSource

javax.xml.bind.util.JAXBSource

すべての実装されたインタフェース:

Source

public class JAXBSource
extends SAXSource

JAXB生成オブジェクトを整列化するJAXP Source実装です。

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

次の例は、JAXBを使用して文書を整列化し、XSLT変換を実行する方法を示します。

       MyObject o = // get JAXB content tree

       // jaxbContext is a JAXBContext object from which 'o' is created.
       JAXBSource source = new JAXBSource( jaxbContext, o );

       // set up XSLT transformation
       TransformerFactory tf = TransformerFactory.newInstance();
       Transformer t = tf.newTransformer(new StreamSource("test.xsl"));

       // run transformation
       t.transform(source,new StreamResult(System.out));
    

実装の詳細として、JAXBSourceはSAXSourceから派生しているという事実があります。そのため、アプリケーションでは一般的に、SAXSourceに定義されているメソッドにアクセスしないことを強くお勧めします。特に、setXMLReaderおよびsetInputSourceメソッドを呼び出さないでください。getXMLReaderメソッドによって取得したXMLReaderオブジェクトは、getInputSourceメソッドによって返されたInputSourceオブジェクトを解析するためにのみ使用しなくてはいけません。

同様に、getInputSourceメソッドによって取得したInputSourceオブジェクトは、getXMLReaderメソッドによって返されたXMLReaderオブジェクトによって解析されるためにのみ使用しなくてはいけません。

フィールドのサマリー

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

FEATURE

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

コンストラクタ

コンストラクタと説明
JAXBSource(JAXBContext context, Object contentObject) 指定されたコンテンツ・オブジェクトの新しいSourceを作成します。
JAXBSource(Marshaller marshaller, Object contentObject) 指定されたコンテンツ・オブジェクトの新しいSourceを作成します。

メソッドのサマリー

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

getInputSource, getSystemId, getXMLReader, setInputSource, setSystemId, setXMLReader, sourceToInputSource

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

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

コンストラクタの詳細

JAXBSource

public JAXBSource(JAXBContext context,
                  Object contentObject)
           throws JAXBException

指定されたコンテンツ・オブジェクトの新しいSourceを作成します。

パラメータ:

context - contentObjectの作成に使用されたJAXBContext。このコンテキストは新しいmarshallerインスタンスの作成に使用され、nullは指定不可。

contentObject - JAXB生成クラスのインスタンス。これは(それをXMLに整列化することによって)Sourceとして使用される。nullは指定不可。

例外:

JAXBException - JAXBSourceの作成中にエラーが発生した場合、またはいずれかのパラメータがnullの場合。

JAXBSource

public JAXBSource(Marshaller marshaller,
                  Object contentObject)
           throws JAXBException

指定されたコンテンツ・オブジェクトの新しいSourceを作成します。

パラメータ:

marshaller - contentObjectをXMLに整列化するために使用されるmarshallerインスタンス。これはcontentObjectの構築に使用されたJAXBContextから作成する必要があり、nullは指定不可。

contentObject - JAXB生成クラスのインスタンス。これは(それをXMLに整列化することによって)Sourceとして使用される。nullは指定不可。

例外:

JAXBException - JAXBSourceの作成中にエラーが発生した場合、またはいずれかのパラメータがnullの場合。