クラス ResourceAdapterFactoryBean
- 実装されているすべてのインターフェース:
DisposableBean, FactoryBean<jakarta.resource.spi.ResourceAdapter>, InitializingBean
ResourceAdapter をブートストラップする FactoryBean は、ローカルの BootstrapContext で起動し、Bean 参照用に公開します。また、コンテキストのシャットダウン時に ResourceAdapter を停止します。これは、JCA 1.7 仕様に基づく、ローカル環境における「非管理型」ブートストラップに相当します。これは基本的に、JCA ResourceAdapter の Bean スタイルのブートストラップ用のアダプターであり、BootstrapContext またはその要素(JCA WorkManager など)を Bean プロパティで指定できます。
- 導入:
- 2.0.3
- 作成者:
- Juergen Hoeller
- 関連事項:
フィールドのサマリー
インターフェース FactoryBean から継承されたフィールド
OBJECT_TYPE_ATTRIBUTEコンストラクターの概要
コンストラクターメソッドのサマリー
修飾子と型メソッド説明voidBootstrapContext をビルドし、それを使用して ResourceAdapter を開始します。voiddestroy()ResourceAdapter を停止します。@Nullable jakarta.resource.spi.ResourceAdapterこのファクトリによって管理されるオブジェクトのインスタンス(おそらく共有または独立)を返します。ClassSE<? extends jakarta.resource.spi.ResourceAdapter> この FactoryBean が作成するオブジェクトの型を返します。事前にわからない場合はnullを返します。booleanこのファクトリによって管理されるオブジェクトはシングルトンですか? つまり、FactoryBean.getObject()は常に同じオブジェクト(キャッシュ可能な参照)を返しますか?voidsetBootstrapContext(jakarta.resource.spi.BootstrapContext bootstrapContext) ResourceAdapter の開始に使用する JCA BootstrapContext を指定します。voidsetResourceAdapter(jakarta.resource.spi.ResourceAdapter resourceAdapter) まだ開始されていない構成済みインスタンスとして渡されるターゲット JCA ResourceAdapter を指定します。voidsetResourceAdapterClass(ClassSE<? extends jakarta.resource.spi.ResourceAdapter> resourceAdapterClass) デフォルトの構成でインスタンス化されるターゲット JCA ResourceAdapter をクラスとして指定します。voidsetWorkManager(jakarta.resource.spi.work.WorkManager workManager) ResourceAdapter のブートストラップに使用する JCA WorkManager を指定します。voidsetXaTerminator(jakarta.resource.spi.XATerminator xaTerminator) ResourceAdapter のブートストラップに使用する JCA XATerminator を指定します。
コンストラクターの詳細
ResourceAdapterFactoryBean
public ResourceAdapterFactoryBean()
メソッドの詳細
setResourceAdapterClass
public void setResourceAdapterClass(ClassSE<? extends jakarta.resource.spi.ResourceAdapter> resourceAdapterClass) デフォルトの構成でインスタンス化されるターゲット JCA ResourceAdapter をクラスとして指定します。または、"resourceAdapter" プロパティを使用して、事前構成された ResourceAdapter インスタンスを指定します。
- 関連事項:
setResourceAdapter
public void setResourceAdapter(jakarta.resource.spi.ResourceAdapter resourceAdapter) まだ開始されていない構成済みインスタンスとして渡されるターゲット JCA ResourceAdapter を指定します。これは通常、内部 Bean 定義として発生し、ベンダー固有の Bean プロパティを介して ResourceAdapter インスタンスを構成します。setBootstrapContext
public void setBootstrapContext(jakarta.resource.spi.BootstrapContext bootstrapContext) ResourceAdapter の開始に使用する JCA BootstrapContext を指定します。または、個々のパーツ(JCA WorkManager など)を個々の参照として指定することもできます。
- 関連事項:
setWorkManager
public void setWorkManager(jakarta.resource.spi.work.WorkManager workManager) ResourceAdapter のブートストラップに使用する JCA WorkManager を指定します。- 関連事項:
setXaTerminator
public void setXaTerminator(jakarta.resource.spi.XATerminator xaTerminator) ResourceAdapter のブートストラップに使用する JCA XATerminator を指定します。- 関連事項:
afterPropertiesSet
public void afterPropertiesSet() throws jakarta.resource.ResourceExceptionBootstrapContext をビルドし、それを使用して ResourceAdapter を開始します。- 次で指定:
- インターフェース
InitializingBeanのafterPropertiesSet - 例外:
jakarta.resource.ResourceException- 関連事項:
getObject
インターフェースからコピーされた説明:FactoryBeanこのファクトリによって管理されるオブジェクトのインスタンス(おそらく共有または独立)を返します。BeanFactoryと同様に、これにより、シングルトンとプロトタイプの両方の設計パターンをサポートできます。この FactoryBean が呼び出し時にまだ完全に初期化されていない場合(たとえば、循環参照に関係しているため)、対応する
FactoryBeanNotInitializedExceptionをスローします。FactoryBeans は
nullオブジェクトを返すことができます。Bean ファクトリはこれを通常の値と見なし、この場合はFactoryBeanNotInitializedExceptionをスローしません。ただし、FactoryBean 実装では、必要に応じてFactoryBeanNotInitializedException自体をスローすることが推奨されます。- 次で指定:
- インターフェース
FactoryBean<jakarta.resource.spi.ResourceAdapter>のgetObject - 戻り値:
- Bean のインスタンス (
nullにすることができます) - 関連事項:
getObjectType
インターフェースからコピーされた説明:FactoryBeanこの FactoryBean が作成するオブジェクトの型を返します。事前にわからない場合はnullを返します。これにより、たとえばオートワイヤーなどで、オブジェクトをインスタンス化せずに特定の型の Bean を確認できます。
シングルトンオブジェクトを作成する実装の場合、このメソッドはシングルトンの作成を可能な限り回避し、事前に型を推定する必要があります。プロトタイプの場合は、ここで意味のある型を返すことも推奨されます。
このメソッドは、この FactoryBean が完全に初期化される前に呼び出すことができます。初期化中に作成された状態に依存しないでください。もちろん、利用可能な場合はそのような状態を引き続き使用できます。
注意 : オートワイヤーは、ここで
nullを返す FactoryBeans を単に無視します。FactoryBean の現在の状態を使用して、このメソッドを適切に実装することを強くお勧めします。- 次で指定:
- インターフェース
FactoryBean<jakarta.resource.spi.ResourceAdapter>のgetObjectType - 戻り値:
- この FactoryBean が作成するオブジェクトの型、または呼び出し時に不明な場合は
null - 関連事項:
isSingleton
public boolean isSingleton()インターフェースからコピーされた説明:FactoryBeanこのファクトリによって管理されるオブジェクトはシングルトンですか? つまり、FactoryBean.getObject()は常に同じオブジェクト(キャッシュ可能な参照)を返しますか?注意 : FactoryBean がシングルトンオブジェクトを保持していることを示している場合、
getObject()から返されたオブジェクトは、所有する BeanFactory によってキャッシュされる可能性があります。FactoryBean が常に同じ参照を公開しない限り、trueを返さないでください。FactoryBean 自体のシングルトンステータスは、通常、所有する BeanFactory によって提供されます。通常、そこではシングルトンとして定義する必要があります。
注意 :
falseを返すこのメソッドは、返されるオブジェクトが独立したインスタンスであることを必ずしも示しません。拡張SmartFactoryBeanインターフェースの実装は、SmartFactoryBean.isPrototype()メソッドを通じて独立したインスタンスを明示的に示す場合があります。この拡張インターフェースを実装しないプレーンなFactoryBean実装は、isSingleton()実装がfalseを返す場合、常に独立したインスタンスを返すと単純に想定されます。FactoryBeanは通常シングルトンインスタンスを管理するため、デフォルトの実装ではtrueが返されます。- 次で指定:
- インターフェース
FactoryBean<jakarta.resource.spi.ResourceAdapter>のisSingleton - 戻り値:
- 公開されたオブジェクトがシングルトンかどうか
- 関連事項:
destroy