SpringContextResourceAdapter (Spring Framework API)

java.lang.ObjectSE
- org.springframework.jca.context.SpringContextResourceAdapter

実装されているすべてのインターフェース:
ResourceAdapterEE
```
public class SpringContextResourceAdapter
extends ObjectSE
implements ResourceAdapterEE
```
Spring ApplicationContext をロードする JCA 1.7 ResourceAdapterEE 実装。ResourceAdapter のライフサイクルの一部として Spring 管理 Bean を開始および停止します。
HTTP エントリポイントを必要とせず、メッセージエンドポイントとスケジュールされたジョブなどで構成されるアプリケーションコンテキストに最適です。このようなコンテキストの Bean は、JTA トランザクションマネージャー、JNDI にバインドされた JDBC DataSources および JMS ConnectionFactory インスタンスなどのアプリケーションサーバーリソースを使用することができ、プラットフォームの JMX サーバーに登録することもできます。これらはすべて、Spring の標準的なトランザクション管理、JNDI および JMX サポート機能を介して行われます。
非同期作業をスケジュールする必要が生じた場合は、Spring の WorkManagerTaskExecutor を標準の Bean 定義として使用し、依存性注入を通じてアプリケーション Bean に注入することを検討してください。この WorkManagerTaskExecutor は、この ResourceAdapter に提供されている BootstrapContext からの JCA WorkManager を自動的に使用します。
JCA BootstrapContextEE には、BootstrapContextAware インターフェースを実装するアプリケーションコンポーネントを介して直接アクセスすることもできます。この ResourceAdapter を使用してデプロイすると、BootstrapContext がそのようなコンポーネントに渡されることが保証されます。
この ResourceAdapter は、次のように、Java EE ".rar" デプロイユニット内の "META-INF/ra.xml" ファイルで定義されます。
```
 <?xml version="1.0" encoding="UTF-8"?>
 <connector xmlns="http://java.sun.com/xml/ns/j2ee"
                 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                 xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee https://java.sun.com/xml/ns/j2ee/connector_1_5.xsd"
                 version="1.5">
         <vendor-name>Spring Framework</vendor-name>
         <eis-type>Spring Connector</eis-type>
         <resourceadapter-version>1.0</resourceadapter-version>
         <resourceadapter>
                 <resourceadapter-class>org.springframework.jca.context.SpringContextResourceAdapter</resourceadapter-class>
                 <config-property>
                         <config-property-name>ContextConfigLocation</config-property-name>
                         <config-property-type>java.lang.String</config-property-type>
                         <config-property-value>META-INF/applicationContext.xml</config-property-value>
                 </config-property>
         </resourceadapter>
 </connector>
```
"META-INF/applicationContext.xml" はデフォルトのコンテキスト設定場所であるため、別の / 追加の設定ファイルを指定するつもりがない限り、指定する必要はありません。デフォルトの場合は、上記の config-property セクション全体を削除できます。
単純なデプロイのニーズの場合、必要な操作は次のとおりです。すべてのアプリケーションクラスを RAR ファイル (ファイル拡張子が異なる標準の JAR ファイル) にパッケージ化し、必要なすべてのライブラリ jar を RAR アーカイブのルートに追加し、上記のように "META-INF/ra.xml" デプロイ記述子と対応する Spring XML Bean 定義ファイル (通常は "META-INF/applicationContext.xml" ) を追加し、結果の RAR ファイルをアプリケーションサーバーのデプロイディレクトリにドロップします。
導入:
2.5
作成者:
Juergen Hoeller
関連事項:
setContextConfigLocation(java.lang.String), loadBeanDefinitions(org.springframework.beans.factory.support.BeanDefinitionRegistry, java.lang.String[]), ResourceAdapterApplicationContext

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static StringSE`	`CONFIG_LOCATION_DELIMITERS` これらの文字は、1 つの文字列値に含まれる複数のコンテキスト設定パス間の区切り文字とみなされます。
`static StringSE`	`DEFAULT_CONTEXT_CONFIG_LOCATION` デフォルトの `applicationContext.xml` ロケーション。
`protected Log`	`logger`

コンストラクターの概要
コンストラクター
コンストラクターと説明
SpringContextResourceAdapter()

コンストラクター
コンストラクターと説明
`SpringContextResourceAdapter()`

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`protected ConfigurableApplicationContext`	`createApplicationContext(BootstrapContextEE bootstrapContext)` 指定された JCA BootstrapContext の Spring ApplicationContext をビルドします。
`protected ConfigurableEnvironment`	`createEnvironment()` 新しい `StandardEnvironment` を返します。
`void`	`endpointActivation(MessageEndpointFactoryEE messageEndpointFactory, ActivationSpecEE activationSpec)` この実装は常に NotSupportedException をスローします。
`void`	`endpointDeactivation(MessageEndpointFactoryEE messageEndpointFactory, ActivationSpecEE activationSpec)` この実装は何もしません。
`boolean`	`equals(ObjectSE other)`
`protected StringSE`	`getContextConfigLocation()` 指定されたコンテキスト構成ファイルを返します。
`XAResourceSE[]`	`getXAResources(ActivationSpecEE[] activationSpecs)` この実装は、常に `null` を返します。
`int`	`hashCode()`
`protected void`	`loadBeanDefinitions(BeanDefinitionRegistry registry, StringSE[] configLocations)` 指定された構成ファイルに基づいて、Bean 定義を所定のレジストリにロードします。
`void`	`setContextConfigLocation(StringSE contextConfigLocation)` リソースアダプターのデプロイユニット内のコンテキスト構成ファイルの場所を設定します。
`void`	`start(BootstrapContextEE bootstrapContext)` この実装は、`createApplicationContext(javax.resource.spi.BootstrapContext)` テンプレートメソッドを介して Spring ApplicationContext をロードします。
`void`	`stop()` この実装は Spring ApplicationContext を閉じます。

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, finalizeSE, getClassSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

- フィールドの詳細
  - CONFIG_LOCATION_DELIMITERS
```
public static final StringSE CONFIG_LOCATION_DELIMITERS
```
    これらの文字は、1 つの文字列値に含まれる複数のコンテキスト設定パス間の区切り文字とみなされます。
    関連事項:
    setContextConfigLocation(java.lang.String), 定数フィールド値
  - DEFAULT_CONTEXT_CONFIG_LOCATION
```
public static final StringSE DEFAULT_CONTEXT_CONFIG_LOCATION
```
    デフォルトの applicationContext.xml ロケーション。
    関連事項:
    定数フィールド値
  - logger
```
protected final Log logger
```
- コンストラクターの詳細
  - SpringContextResourceAdapter
```
public SpringContextResourceAdapter()
```
- メソッドの詳細
  - setContextConfigLocation
```
public void setContextConfigLocation(StringSE contextConfigLocation)
```
    リソースアダプターのデプロイユニット内のコンテキスト構成ファイルの場所を設定します。これは、コンマ、セミコロン、空白、改行で区切られた複数のリソースの場所で構成される区切られた文字列にすることができます。
    これは、ra.xml デプロイ記述子の "ContextConfigLocation" 構成プロパティとして指定できます。
    デフォルトは "classpath:META-INF/applicationContext.xml" です。
  - getContextConfigLocation
```
protected StringSE getContextConfigLocation()
```
    指定されたコンテキスト構成ファイルを返します。
  - createEnvironment
```
protected ConfigurableEnvironment createEnvironment()
```
    新しい StandardEnvironment を返します。
    サブクラスは、カスタム ConfigurableEnvironment 実装を提供するためにこのメソッドをオーバーライドできます。
  - start
```
public void start(BootstrapContextEE bootstrapContext)
           throws ResourceAdapterInternalExceptionEE
```
    この実装は、createApplicationContext(javax.resource.spi.BootstrapContext) テンプレートメソッドを介して Spring ApplicationContext をロードします。
    次で指定:
    インターフェース ResourceAdapterEE の startEE
    例外:
    ResourceAdapterInternalExceptionEE
  - createApplicationContext
```
protected ConfigurableApplicationContext createApplicationContext(BootstrapContextEE bootstrapContext)
```
    指定された JCA BootstrapContext の Spring ApplicationContext をビルドします。
    デフォルトの実装では、ResourceAdapterApplicationContext を構築し、指定された構成ファイルを実際に解析するために loadBeanDefinitions(org.springframework.beans.factory.support.BeanDefinitionRegistry, java.lang.String[]) に委譲します。
    パラメーター:
    bootstrapContext - この ResourceAdapter の BootstrapContext
    戻り値:
    Spring ApplicationContext インスタンス
  - loadBeanDefinitions
```
protected void loadBeanDefinitions(BeanDefinitionRegistry registry,
                                   StringSE[] configLocations)
```
    指定された構成ファイルに基づいて、Bean 定義を所定のレジストリにロードします。
    パラメーター:
    registry - ロードするレジストリ
    configLocations - 解析された構成の場所
    関連事項:
    setContextConfigLocation(java.lang.String)
  - stop
```
public void stop()
```
    この実装は Spring ApplicationContext を閉じます。
    次で指定:
    インターフェース ResourceAdapterEE の stopEE
  - endpointActivation
```
public void endpointActivation(MessageEndpointFactoryEE messageEndpointFactory,
                               ActivationSpecEE activationSpec)
                        throws ResourceExceptionEE
```
    この実装は常に NotSupportedException をスローします。
    次で指定:
    インターフェース ResourceAdapterEE の endpointActivationEE
    例外:
    ResourceExceptionEE
  - endpointDeactivation
```
public void endpointDeactivation(MessageEndpointFactoryEE messageEndpointFactory,
                                 ActivationSpecEE activationSpec)
```
    この実装は何もしません。
    次で指定:
    インターフェース ResourceAdapterEE の endpointDeactivationEE
  - getXAResources
```
@Nullable
public XAResourceSE[] getXAResources(ActivationSpecEE[] activationSpecs)
                                      throws ResourceExceptionEE
```
    この実装は、常に null を返します。
    次で指定:
    インターフェース ResourceAdapterEE の getXAResourcesEE
    例外:
    ResourceExceptionEE
  - equals
```
public boolean equals(@Nullable
                      ObjectSE other)
```
    オーバーライド:
    クラス ObjectSE の equalsSE
  - hashCode
```
public int hashCode()
```
    オーバーライド:
    クラス ObjectSE の hashCodeSE

クラス SpringContextResourceAdapter

フィールドのサマリー

コンストラクターの概要

メソッドのサマリー

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

フィールドの詳細

CONFIG_LOCATION_DELIMITERS

DEFAULT_CONTEXT_CONFIG_LOCATION

logger

コンストラクターの詳細

SpringContextResourceAdapter

メソッドの詳細

setContextConfigLocation

getContextConfigLocation

createEnvironment

start

createApplicationContext

loadBeanDefinitions

stop

endpointActivation

endpointDeactivation

getXAResources

equals

hashCode