パッケージ jakarta.xml.bind.util

クラス JAXBSource

  • 実装されているすべてのインターフェース:
    SourceSE
    public class JAXBSource
extends SAXSourceSE
    Jakarta XML バインディングで生成されたオブジェクトをマーシャルする JAXP SourceSE 実装。

    このユーティリティクラスは、Jakarta XML Binding を他の Java/XML テクノロジと組み合わせるのに役立ちます。

    次の例は、Jakarta XML Binding を使用して、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 オブジェクトによって解析されるためにのみ使用されます。

    導入:
    1.6
    作成者:
    Kohsuke Kawaguchi (kohsuke.kawaguchi@sun.com)

    • コンストラクターの詳細

      • JAXBSource

        public JAXBSource​(JAXBContext context,
                  ObjectSE contentObject)
           throws JAXBException
        指定されたコンテンツオブジェクトの新しい SourceSE を作成します。
        パラメーター:
        context - contentObject の作成に使用された JAXBContext。このコンテキストは、マーシャラーの新しいインスタンスを作成するために使用され、null であってはなりません。
        contentObject - Jakarta XML バインディングで生成されたクラスのインスタンス。SourceSE として使用されます（XML にマーシャリングすることにより）。null であってはなりません。
        例外:
        JAXBException - JAXBSource の作成中にエラーが発生した場合、またはいずれかのパラメーターが null の場合。

      • JAXBSource

        public JAXBSource​(Marshaller marshaller,
                  ObjectSE contentObject)
           throws JAXBException
        指定されたコンテンツオブジェクトの新しい SourceSE を作成します。
        パラメーター:
        marshaller - contentObject を XML にマーシャリングするために使用されるマーシャラーインスタンス。これは、contentObject の構築に使用された JAXBContext から作成する必要があり、null であってはなりません。
        contentObject - Jakarta XML バインディングで生成されたクラスのインスタンス。SourceSE として使用されます（XML にマーシャリングすることにより）。null であってはなりません。
        例外:
        JAXBException - JAXBSource の作成中にエラーが発生した場合、またはいずれかのパラメーターが null の場合。