3 Oracle WebLogic Serverのデプロイメントおよび統合

この章では、Oracle WebLogic Server (OracleWLS)のデプロイメントおよびOracle Application Adapter for Siebelとの統合について説明します。内容は次のとおりです。

Oracle WebLogic Serverとのアダプタの統合
アダプタのデプロイメント
アダプタ構成の更新

Oracle WebLogic Serverとのアダプタの統合

Oracle Application Adapter for Siebelは、インストール中にOracleWLSコンテナ内にデプロイされます。すべてのクライアント・アプリケーションはOracleWLS環境で動作します。J2CAデプロイメントでは、Common Client Interface (CCI)により、OracleWLSクライアント・アプリケーションはリソース・アダプタと統合されます。

アダプタのデプロイメント

図3-1に、Oracle WebLogic Serverへのコネクタのデプロイメントを示します。ランタイム・サービス・シナリオでは、Enterprise Java Bean、サーブレットまたはJavaプログラム・クライアントによって、J2CAリソース・アダプタへのCCIコールが行われます。アダプタはこれらのコールをリクエストとして処理し、EISに送信します。その後、EISのレスポンスがクライアントに返信されます。

図3-1 Oracle Adapter J2CAのアーキテクチャ

「図3-1 Oracle Adapter J2CAのアーキテクチャ」の説明

アダプタ構成の更新

OracleAS Adapter for SiebelのJ2CAデプロイメント中、OracleWLSにより、次の場所にra.xmlと呼ばれるデプロイメント記述子が生成されます。

<ADAPTER_HOME>\soa\thirdparty\ApplicationAdapters\iwafjca.rar\META-INF

インストールには、ra.xmlと呼ばれるファイルが1つ以上含まれています。この項で説明されているOracleWLSデプロイメント記述子は、前述のディレクトリ内にあります。

注意:

複数の管理対象接続ファクトリは、アウトバウンド処理(サービス)の場合のみサポートされています。

管理対象コネクタ・ファクトリ・オブジェクトの作成

ra.xml記述子には、リソース・アダプタに関するOracleWLSに固有のデプロイメント情報が記載されます。たとえば、アプリケーション・エクスプローラ内のjca_sample構成は、ra.xmlファイル内では次のように表されます。

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE connector PUBLIC '-//Sun Microsystems, Inc.//DTD Connector 1.0//EN' 'http://java.sun.com/dtd/connector_1_0.dtd'><connector>  <display-name>IWAFJCA10</display-name>  <vendor-name>IWAY Software</vendor-name>  <spec-version>1.0</spec-version>  <eis-type>IWAF</eis-type>  <version>1.0</version>  <license>    <license-required>false</license-required>  </license>  <resourceadapter>    <managedconnectionfactory-class>com.ibi.afjca.spi.IWAFManagedConnectionFactory</managedconnectionfactory-class>    <connectionfactory-interface>javax.resource.cci.ConnectionFactory</connectionfactory-interface>    <connectionfactory-impl-class>com.ibi.afjca.cci.IWAFConnectionFactory</connectionfactory-impl-class>    <connection-interface>javax.resource.cci.Connection</connection-interface>    <connection-impl-class>com.ibi.afjca.cci.IWAFConnection</connection-impl-class>    <transaction-support>NoTransaction</transaction-support>    <config-property>      <config-property-name>AdapterName</config-property-name>      <config-property-type>java.lang.String</config-property-type>      <config-property-value></config-property-value>    </config-property>    <config-property>      <config-property-name>Config</config-property-name>      <config-property-type>java.lang.String</config-property-type>      <config-property-value></config-property-value>    </config-property>    <config-property>      <config-property-name>IWayHome</config-property-name>      <config-property-type>java.lang.String</config-property-type>      <config-property-value>C:\oracle\Middleware\Oracle_SOA1\soa\thirdparty\ApplicationAdapters</config-property-value>    </config-property>    <config-property>      <config-property-name>IWayConfig</config-property-name>      <config-property-type>java.lang.String</config-property-type>      <config-property-value>jca_sample</config-property-value>    </config-property>    <config-property>      <config-property-name>IWayRepoDriver</config-property-name>      <config-property-type>java.lang.String</config-property-type>      <config-property-value></config-property-value>    </config-property>    <config-property>      <config-property-name>IWayRepoURL</config-property-name>      <config-property-type>java.lang.String</config-property-type>      <config-property-value></config-property-value>    </config-property>    <config-property>      <config-property-name>IWayRepoUser</config-property-name>      <config-property-type>java.lang.String</config-property-type>      <config-property-value></config-property-value>    </config-property>    <config-property>      <config-property-name>IWayRepoPassword</config-property-name>      <config-property-type>java.lang.String</config-property-type>      <config-property-value></config-property-value>    </config-property>    <config-property>      <config-property-name>LogLevel</config-property-name>      <config-property-type>java.lang.String</config-property-type>      <config-property-value>DEBUG</config-property-value>    </config-property>    <authentication-mechanism>      <authentication-mechanism-type>BasicPassword</authentication-mechanism-type>      <credential-interface>javax.resource.spi.security.PasswordCredential</credential-interface>    </authentication-mechanism>    <reauthentication-support>true</reauthentication-support>  </resourceadapter></connector>

ra.xmlファイルで定義されているパラメータを次の表に示します。

パラメータ名	説明
IWayHome	OracleWLSがパッケージされているアプリケーション・アダプタのベース・インストール・ディレクトリ。
IWayConfig	アプリケーション・エクスプローラで定義されているアダプタ構成名。たとえば、Oracle Application Adapter for Siebelには、アプリケーション・エクスプローラで`jca_sample`構成が事前定義されています。
IWayRepoURL	データベースへの接続を開くときに使用されるURL。これはOracleデータベースをリポジトリとして使用する場合にのみ必要です。
IWayRepoUser	データベースに接続するときに使用されるユーザー名。これはOracleデータベースをリポジトリとして使用する場合にのみ必要です。
IWayRepoPassword	パスワード。指定された場合は、構成を上書きします。これはOracleデータベースをリポジトリとして使用する場合にのみ必要です。
loglevel	ManagedConnectorFactoryプロパティによって設定されるレベルを上書きします。

複数の管理対象コネクタ・ファクトリ・オブジェクトの作成

複数の管理対象コネクタ・ファクトリ・オブジェクトを作成するには、weblogic-ra.xmlファイルを編集し、さらに<connection-instance>ノードを追加します。このファイルは次の場所にあります。

<ADAPTER_HOME>\soa\thirdparty\ApplicationAdapters\iwafjca.rar\META-INF

たとえば、アプリケーション・エクスプローラ内の最初のjca_configurationはweblogic-ra.xmlファイルでは次のように表現されます。

<?xml version="1.0"?> <weblogic-connector xmlns="http://www.bea.com/ns/weblogic/90">    <enable-access-outside-app>true</enable-access-outside-app>    <enable-global-access-to-classes>true</enable-global-access-to-classes>    <outbound-resource-adapter>        <default-connection-properties>        <pool-params>                <initial-capacity>0</initial-capacity>        </pool-params>        <transaction-support>LocalTransaction</transaction-support>        </default-connection-properties>        <connection-definition-group>            <connection-factory-interface>javax.resource.cci.ConnectionFactory</connection-factory-interface>            <connection-instance>                <jndi-name>eis/OracleJCAAdapter/DefaultConnection</jndi-name>            </connection-instance>        </connection-definition-group>    </outbound-resource-adapter></weblogic-connector>

複数の管理対象コネクタ・ファクトリ・オブジェクトを作成するには、次の例に示すように、新規の<connection-instance>ノードをファイルに追加する必要があります。

<?xml version="1.0"?> <weblogic-connector xmlns="http://www.bea.com/ns/weblogic/90">    <enable-access-outside-app>true</enable-access-outside-app>    <enable-global-access-to-classes>true</enable-global-access-to-classes>        <outbound-resource-adapter>        <default-connection-properties>        <pool-params>            <initial-capacity>0</initial-capacity>        </pool-params>        <transaction-support>LocalTransaction</transaction-support>        </default-connection-properties>        <connection-definition-group>            <connection-factory-interface>javax.resource.cci.ConnectionFactory</connection-factory-interface>            <connection-instance>                <jndi-name>eis/OracleJCAAdapter/DefaultConnection</jndi-name>            </connection-instance>            <connection-instance>                    <jndi-name>eis/OracleJCAAdapter/DefaultConnection1</jndi-name>                    <connection-properties>                      <properties>                 <property>                   <name>IWayHome</name>                     <value>C:\oracle\Middleware\Oracle_SOA1\soa\thirdparty\ApplicationAdapters</value>                       </property>                  <property>                   <name>IWayConfig</name>                   <value>jca_sample2</value>                 </property>                  <property>                       <name>IWayRepoURL</name>                          <value></value>                       </property>                  <property>                         <name>IWayRepoUser</name>                         <value></value>                     </property>                  <property>                         <name>IWayRepoPassword</name>                             <value></value>                     </property>                  <property>                         <name>LogLevel</name>                             <value>Debug</value>                        </property>                  </properties>                        </connection-properties>                  </connection-instance>            </connection-definition-group>    </outbound-resource-adapter></weblogic-connector>

<connection-instance>セクションで<property>要素を指定しない場合、ra.xmlファイルから値が取得されます。必要に応じ、ra.xmlファイルでデフォルトのプロパティを指定し、weblogic-ra.xmlファイルの値をオーバーライドできます。また、J2CA構成(jca_sample2など)が、アプリケーション・エクスプローラ内で作成済である必要があります。

注意:

ra.xmlファイルとweblogic-ra.xmlファイルを変更した場合、Oracle WebLogic Serverを再起動する必要があります。Oracle WebLogic Serverがすでに稼働している場合、Oracle WebLogic Serverを停止し、再起動します。

また、iwafjca.rarファイルをOracle WebLogic管理コンソールに再デプロイして、これらの変更をアクティブ化する必要もあります。

追加の接続ファクトリ値用のWSDLファイルの変更

アプリケーション・エクスプローラでは、デフォルトの接続ファクトリ名eis/OracleJCAAdapter/DefaultConnectionを使用してJ2CAプロパティ・ファイルが生成されます。追加の接続ファクトリを作成した場合は、J2CAプロパティ・ファイル内のjca:addressセクションのlocationフィールドを反映するように、追加の構成および接続ファクトリ用に生成されたWSDLを変更する必要があります。isdsrv2_conn2構成が含まれているOracle Application Adapter for Siebel用のデフォルトのJ2CAプロパティ・ファイルを次の例に示します。

J2CAプロパティ・ファイルに、次のデフォルトの接続ファクトリが含まれていることがわかります。eis/OracleJCAAdapter/DefaultConnection

<jca:address location="eis/OracleJCAAdapter/DefaultConnection"        ConnectionSpec="com.ibi.afjca.cci.IWAFConnectionSpec"        cs.AdapterName="Siebel" cs.Config="isdsrv2_conn2" UIConnectionName="Connection1"/>

この接続ファクトリ値を次の値に変更する必要があります。eis/OracleJCAAdapter/DefaultConnection1

例:

<jca:address location="eis/OracleJCAAdapter/DefaultConnection1"                        ConnectionSpec="com.ibi.afjca.cci.IWAFConnectionSpec"                        cs.AdapterName="Siebel" cs.Config="isdsrv2_conn2" UIConnectionName="Connection1"/>

jca:addressセクションのロケーション・フィールドの値のみ変更可能です。その他のフィールドまたはセクションは変更しないでください。