JCA 接続ファクトリーの構成

Java™ EE Connector Architecture (JCA) 仕様に準拠する接続ファクトリーを構成することができます。

このタスクについて

インストールされているリソース・アダプターによって提供されている接続ファクトリー・タイプの 1 つ以上の接続ファクトリー・インスタンスを構成することができます。
注: Liberty プロファイルの JCA サポートを構成するには、WebSphere® Application Server Developer Tools for Eclipse のサーバー構成エディターの「ソース」ビュー、または他のテキスト・エディターを使用して server.xml ファイルを編集する必要があります。このトピックでは、MyAdapter という固有 ID を持つリソース・アダプターが既にサーバーに構成されていると想定しています。詳細については、リソース・アダプターの構成に関する資料を参照してください。以下のステップでは、基本シナリオの構成のエンドツーエンド・サンプルを提供します。
注: WebSphere® Development Tools (WDT) の「設計」ビューで接続ファクトリー、管理オブジェクト、アクティベーション・スペック、およびリソース・アダプターのサーバー構成のプロパティー・サブエレメントを編集することはサポートされていません。

手順

  1. server.xml ファイルを更新して、featureManager タグの下に jca-1.6 フィーチャーを追加します。
    <featureManager>  
    	<feature>jca-1.6</feature> 
    	<feature>jndi-1.0</feature>  <!-- Add the jndi feature to enable look up of connection factories and administered objects. -->   
    		... 
    </featureManager>
  2. リソース・アダプターをインストールします。 例えば、以下のように server.xml ファイルを更新します。
    <resourceAdapter location="C:/adapters/MyAdapter.rar"/>
  3. 1 つ以上の接続ファクトリー・インスタンスを構成します。 接続ファクトリー・インスタンスを構成する場合、どの構成プロパティーもオーバーライドしたくない場合でも、特定のリソース・アダプターによって提供されている接続ファクトリー・インターフェースに connectionFactory エレメントを関連付けるために、properties サブエレメントを提供する必要があります。以下の例で、MyAdapter リソース・アダプターは、1 つのタイプの接続ファクトリーのみを提供します。
    <connectionFactory jndiName="eis/cf1">
     <properties.MyAdapter portNumber="1234" someVendorProperty="100"/>
    </connectionFactory>
    
    <connectionFactory jndiName="eis/cf2" containerAuthDataRef="auth2">
     <connectionManager maxPoolSize="20" connectionTimeout="0"/>
     <properties.MyAdapter portNumber="1234" someVendorProperty="200"/>
    </connectionFactory>
    <authData id="auth2" user="user2" password="{xor}Lz4sLCgwLTtt"/>
  4. (オプション) 必要な場合、使用可能な接続ファクトリー・プロパティー・サブエレメント名を識別します。
    • リソース・アダプターが、すべての JMS 接続ファクトリーを除き、厳密に 1 つの接続ファクトリー・インターフェースを提供している場合、サブエレメントは properties.<rar_identifier> になります。

    • パッケージ名を除いてインターフェース名が固有の場合、サブエレメント名は properties.<rar_identifier>.<InterfaceName> になります。
    • パッケージ名を除いて実装名が固有の場合、サブエレメント名は properties.<rar_identifier>.<ImplementationName> になります。
    • 他のケースでは、サブエレメントは properties.<rar_identifier>.<fully.qualified.InterfaceName> になります。

固有のインターフェース・クラス名を持つ 2 つの接続ファクトリーを含むリソース・アダプターの構成方法については、以下の例を使用してください。

ra.xml ファイルからの以下のスニペットで、MyAdapter リソース・アダプターは、固有のインターフェース・クラス名を持つ 2 つの接続ファクトリーを提供します。

<connection-definition>
  <config-property>
  <config-property-name>ServerName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property>
 <connectionfactory-interface>javax.resource.cci.ConnectionFactory</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.ConnectionFactoryImpl</connectionfactory-impl-class>
</connection-defintion>
<connection-definition>
 <config-property>
  <config-property-name>ServerName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property> 
 <connectionfactory-interface>javax.sql.DataSource</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.DataSourceImpl</connectionfactory-impl-class>
</connection-defintion> 
以下に、このシナリオのサーバー構成の例を示します。
<connectionFactory jndiName="eis/cf">
 <properties.MyAdapter.ConnectionFactory serverName="localhost"/>
</connectionFactory>

<connectionFactory jndiName="jdbc/ds">
 <properties.MyAdapter.DataSource serverName="localhost"/>
</connectionFactory>

固有の実装クラス名を持つ 2 つの接続ファクトリーを含むリソース・アダプターの構成方法については、以下の例を使用してください。

ra.xml ファイルからの以下のスニペットで、MyAdapter リソース・アダプターは、固有の実装クラス名を持つ 2 つの接続ファクトリーを提供します。

<connection-definition>
  <config-property>
  <config-property-name>ServerName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property>
 <connectionfactory-interface>javax.resource.cci.ConnectionFactory</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.ConnectionFactoryImpl</connectionfactory-impl-class>
</connection-defintion>

<connection-definition>
  <config-property>
  <config-property-name>ServerName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property>
 <connectionfactory-interface>com.vendor.adapter.ConnectionFactory</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.MyConnectionFactoryImpl</connectionfactory-impl-class>
</connection-defintion>
以下に、このシナリオのサーバー構成の例を示します。
<connectionFactory jndiName="eis/cf1">
 <properties.MyAdapter.ConnectionFactoryImpl serverName="localhost"/>
</connectionFactory> 

<connectionFactory jndiName="eis/cf2">
 <properties.MyAdapter.MyConnectionFactoryImpl serverName="localhost"/>
</connectionFactory>

シンプル・インターフェース・クラス名または実装クラス名のいずれも固有でない 2 つの接続ファクトリーを持つリソース・アダプターの構成方法については、以下の例を使用してください。

ra.xml ファイルからの以下のスニペットで、MyAdapter リソース・アダプターは、シンプル・インターフェース・クラス名または実装クラス名のいずれも固有でない 2 つの接続ファクトリーを提供します。

<connection-definition>
 <config-property>
  <config-property-name>ServerName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property> 
 <connectionfactory-interface>javax.resource.cci.ConnectionFactory</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.ConnectionFactoryImpl</connectionfactory-impl-class>
</connection-defintion>

<connection-definition>
  <config-property>
  <config-property-name>HostName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property> 
 <connectionfactory-interface>com.vendor.adapter.custom.ConnectionFactory</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.custom.ConnectionFactoryImpl</connectionfactory-impl-class>
</connection-defintion>
以下に、このシナリオのサーバー構成の例を示します。
<connectionFactory jndiName="eis/cci-cf">
 <properties.MyAdapter.javax.resource.cci.ConnectionFactory serverName="localhost"/>
</connectionFactory>

<connectionFactory jndiName="eis/custom-cf">
 <properties.MyAdapter.com.vendor.adapter.custom.ConnectionFactory hostName="localhost"/>
</connectionFactory>
構成エレメント名のサフィックスはオーバーライドできます。構成エレメント名のサフィックスのオーバーライド方法については、JCA 構成エレメントのカスタマイズに関する情報を参照してください。

トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twlp_jca_config_confact
ファイル名: twlp_jca_config_confact.html