モジュール java.xml.ws
パッケージ javax.xml.soap

クラスSAAJMetaFactory



  • public abstract class SAAJMetaFactory
    extends Object
    SAAJ APIで定義されたファクトリの実装クラスのアクセス・ポイントです。 SAAJ 1.3のSOAPFactoryMessageFactoryファクトリで定義されたnewInstanceメソッドは、このクラスのインスタンスを継承して実際のオブジェクトを作成します。 SAAJ 1.2に定義されたnewInstance()メソッド(SOAPFactoryMessageFactoryで)の実装は、SAAJ 1.2定義ルックアップがファクトリ実装クラス名の特定に失敗したときにSAAJMetaFactoryに委譲するように更新されました。

    SAAJMetaFactoryはサービス・プロバイダ・インタフェースであり、他のSAAJファクトリと同様のルックアップ・メカニズムを使用して実際のインスタンスを取得します:

    • 名前がjavax.xml.soap.SAAJMetaFactoryのシステム・プロパティが存在する場合、その値は実装クラスの完全修飾名とみなされます。 ルックアップのこのフェーズでは、SAAJ実装のJVM単位のオーバーライドが可能になります。
    • 名前がjavax.xml.soap.MetaFactoryのシステム・プロパティが存在する場合、その値は実装クラスの完全修飾名とみなされます。 以前の仕様である(最大1.3)で定義されているこのプロパティは引き続きサポートされていますが、新しいプロパティjavax.xml.soap.SAAJMetaFactoryにマイグレーションすることを強く推奨します。
    • 構成ファイル"jaxm.properties"を使用します。 このファイルは標準のProperties形式であり、通常Javaインストールのconfディレクトリにあります。 これには、キーjavax.xml.soap.SAAJMetaFactoryを使用した実装クラスの完全修飾名が含まれます。 そのようなプロパティが定義されていない場合は、再びキーjavax.xml.soap.MetaFactoryを持つプロパティが使用されます。 新しいプロパティjavax.xml.soap.SAAJMetaFactoryに移行することを強くお勧めします。
    • ServiceLoaderクラスで定義されているサービス・プロバイダのロード機能を使用して、「デフォルトのロード・メカニズム」を使用してサービスの実装を見つけてロードしようとします。
    • 最後に、上記のすべてのステップが失敗した場合、プラットフォームのデフォルト実装が使用されます。

    このクラスのpublicメソッドはありません。

    導入されたバージョン:
    1.6, SAAJ 1.3