public class LocalConnectionFactoryBean extends ObjectSE implements FactoryBean<ObjectSE>, InitializingBean
FactoryBean(Java コネクターアーキテクチャ仕様で定義)。これは、Java EE サーバーのネーミング環境から接続ファクトリハンドルを取得する JndiObjectFactoryBean 定義の直接的な代替手段です。 接続ファクトリの型は、実際のコネクターに依存します。コネクターは、JCA 仕様で定義されているように、そのネイティブ API(JDBC DataSourceSE や JMS ConnectionFactoryEE など)を公開するか、標準の Common Client Interface(CCI)に従うことができます。CCI ケースで公開されているインターフェースは ConnectionFactoryEE です。
この FactoryBean を使用するには、コネクターの "managedConnectionFactory"(通常は個別の JavaBean として構成)を指定する必要があります。これは、アプリケーションに公開される実際の接続ファクトリ参照の作成に使用されます。オプションで、コネクターのデフォルトの代わりにカスタム ConnectionManager を使用するために、"connectionManager" を指定することもできます。
注意 : 非管理モードでは、コネクターはアプリケーションサーバーにデプロイされません。具体的には、アプリケーションサーバーと対話しません。Java EE サーバーのシステム契約を使用できません。: 接続管理、トランザクション管理、セキュリティ管理。スタンドアロンのトランザクションコーディネーターなどと組み合わせてこれらのサービスを適用するには、カスタム ConnectionManager 実装を使用する必要があります。
コネクターはデフォルトでローカル ConnectionManager(コネクターに含まれている)を使用しますが、XA 登録がないため、グローバルトランザクションに参加できません。コネクターが XA トランザクションコーディネーターと対話するようにするには、XA 対応の ConnectionManager を指定する必要があります。または、公開された API のネイティブローカルトランザクション機能(CCI ローカルトランザクションなど)を使用するか、Spring の PlatformTransactionManager SPI(CciLocalTransactionManager など)の対応する実装を使用してローカルトランザクションを駆動します。
OBJECT_TYPE_ATTRIBUTE| コンストラクターと説明 |
|---|
LocalConnectionFactoryBean() |
| 修飾子と型 | メソッドと説明 |
|---|---|
void | afterPropertiesSet() |
ObjectSE | getObject() このファクトリによって管理されるオブジェクトのインスタンス(おそらく共有または独立)を返します。 |
ClassSE<?> | getObjectType() この FactoryBean が作成するオブジェクトの型を返します。事前にわからない場合は null を返します。 |
boolean | isSingleton() このファクトリによって管理されるオブジェクトはシングルトンですか? つまり、 FactoryBean.getObject() は常に同じオブジェクト(キャッシュ可能な参照)を返しますか? |
void | setConnectionManager(ConnectionManagerEE connectionManager) 必要な接続ファクトリの作成に使用する JCA ConnectionManager を設定します。 |
void | setManagedConnectionFactory(ManagedConnectionFactoryEE managedConnectionFactory) 必要な接続ファクトリの作成に使用する JCA ManagerConnectionFactory を設定します。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSEpublic void setManagedConnectionFactory(ManagedConnectionFactoryEE managedConnectionFactory)
ManagerConnectionFactory は通常、個別の Bean(潜在的には内部 Bean として)としてセットアップされ、JavaBean プロパティが入力されます。ManagerConnectionFactory は、JDBC DataSource および JPA EntityManagerFactory に類似した JCA 仕様による JavaBean パターンに従うことが推奨されます。
ManagerConnectionFactory 実装では、ResourceAdapterAssociationEE インターフェースを通じて表現される JCA 1.7 ResourceAdapter への参照が想定されることに注意してください。この場合、ManagerConnectionFactory をこの LocalConnectionFactoryBean に渡す前に、対応する ResourceAdapter インスタンスをその "resourceAdapter" Bean プロパティに挿入するだけです。
public void setConnectionManager(ConnectionManagerEE connectionManager)
ローカルで使用するための ConnectionManager 実装は、多くの場合、JCA コネクターに含まれています。このように組み込まれた ConnectionManager は、明示的に指定する必要なく、デフォルトとして設定される場合があります。
public void afterPropertiesSet()
throws ResourceExceptionEEInitializingBeanBeanFactoryAware、ApplicationContextAware などを満たした後、包含 BeanFactory によって呼び出されます。このメソッドにより、Bean インスタンスは、すべての Bean プロパティが設定されたときに、その全体的な構成の検証と最終的な初期化を実行できます。
InitializingBean の afterPropertiesSet ResourceExceptionEE@Nullable public ObjectSE getObject()
FactoryBeanBeanFactory と同様に、これにより、シングルトンとプロトタイプの両方のデザインパターンをサポートできます。
この FactoryBean が呼び出し時にまだ完全に初期化されていない場合(たとえば、循環参照に関係しているため)、対応する FactoryBeanNotInitializedException をスローします。
Spring 2.0 以降、FactoryBeans は null オブジェクトを返すことができます。ファクトリはこれを通常の値として使用します。この場合、FactoryBeanNotInitializedException はスローされません。FactoryBean の実装では、必要に応じて FactoryBeanNotInitializedException 自体をすぐにスローすることをお勧めします。
FactoryBean<ObjectSE> の getObject null にすることができます)FactoryBeanNotInitializedExceptionpublic ClassSE<?> getObjectType()
FactoryBeannull を返します。これにより、たとえばオートワイヤーなどで、オブジェクトをインスタンス化せずに特定の型の Bean を確認できます。
シングルトンオブジェクトを作成している実装の場合、このメソッドはシングルトンの作成を可能な限り回避しようとします。むしろ、事前に型を推定する必要があります。プロトタイプの場合、ここで意味のある型を返すこともお勧めします。
このメソッドは、この FactoryBean が完全に初期化される前に呼び出すことができます。初期化中に作成された状態に依存しないでください。もちろん、利用可能な場合はそのような状態を引き続き使用できます。
注意 : オートワイヤーは、ここで null を返す FactoryBeans を単に無視します。FactoryBean の現在の状態を使用して、このメソッドを適切に実装することを強くお勧めします。
FactoryBean<ObjectSE> の getObjectType null ListableBeanFactory.getBeansOfType(java.lang.Class<T>)public boolean isSingleton()
FactoryBeanFactoryBean.getObject() は常に同じオブジェクト(キャッシュ可能な参照)を返しますか? 注意 : FactoryBean がシングルトンオブジェクトを保持することを示す場合、getObject() から返されたオブジェクトは所有 BeanFactory によってキャッシュされる可能性があります。FactoryBean が常に同じ参照を公開しない限り、true を返さないでください。
FactoryBean 自体のシングルトンステータスは、通常、所有する BeanFactory によって提供されます。通常、そこではシングルトンとして定義する必要があります。
注意 : false を返すこのメソッドは、返されるオブジェクトが独立したインスタンスであることを必ずしも示しません。拡張 SmartFactoryBean インターフェースの実装は、SmartFactoryBean.isPrototype() メソッドを通じて独立したインスタンスを明示的に示す場合があります。この拡張インターフェースを実装しないプレーンな FactoryBean 実装は、isSingleton() 実装が false を返す場合、常に独立したインスタンスを返すと単純に想定されます。
FactoryBean は通常シングルトンインスタンスを管理するため、デフォルトの実装では true が返されます。
FactoryBean<ObjectSE> の isSingleton FactoryBean.getObject(), SmartFactoryBean.isPrototype()