- java.lang.Object
-
- javax.xml.soap.SAAJMetaFactory
-
public abstract class SAAJMetaFactory extends Object
SAAJ APIで定義されたファクトリの実装クラスのアクセス・ポイントです。 SAAJ 1.4のSOAPFactory
とMessageFactory
ファクトリで定義されたnewInstance
メソッドは、このクラスのインスタンスを継承して実際のオブジェクトを作成します。 SAAJ 1.2に定義されたnewInstance()
メソッド(SOAPFactory
とMessageFactory
で)の実装は、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
- 名前が
-
-
コンストラクタのサマリー
コンストラクタ 修飾子 コンストラクタ 説明 protected
SAAJMetaFactory()
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド 修飾子と型 メソッド 説明 protected abstract MessageFactory
newMessageFactory(String protocol)
指定されたString
プロトコルのためのMessageFactory
オブジェクトを生成します。protected abstract SOAPFactory
newSOAPFactory(String protocol)
指定されたString
プロトコルのためのSOAPFactory
オブジェクトを生成します。
-
-
-
メソッドの詳細
-
newMessageFactory
protected abstract MessageFactory newMessageFactory(String protocol) throws SOAPException
指定されたString
プロトコルのためのMessageFactory
オブジェクトを生成します。- パラメータ:
protocol
- プロトコルを示すString
- 戻り値:
MessageFactory
、not null- 例外:
SOAPException
- MessageFactoryの作成でエラーが発生した場合- 関連項目:
SOAPConstants.SOAP_1_1_PROTOCOL
,SOAPConstants.SOAP_1_2_PROTOCOL
,SOAPConstants.DYNAMIC_SOAP_PROTOCOL
-
newSOAPFactory
protected abstract SOAPFactory newSOAPFactory(String protocol) throws SOAPException
指定されたString
プロトコルのためのSOAPFactory
オブジェクトを生成します。- パラメータ:
protocol
- プロトコルを示すString
- 戻り値:
SOAPFactory
、not null- 例外:
SOAPException
- SOAPFactoryの作成でエラーが発生した場合- 関連項目:
SOAPConstants.SOAP_1_1_PROTOCOL
,SOAPConstants.SOAP_1_2_PROTOCOL
,SOAPConstants.DYNAMIC_SOAP_PROTOCOL
-
-