Oracle® Fusion Middleware Oracle WebLogic Server Application Adapter for SAP R/3(SAP JCo 3.0)ユーザーズ・ガイド 11g リリース1 (11.1.1.3.0) B61422-01 |
|
前 |
次 |
この章では、Oracle WebLogic Server (OracleWLS)のOracle Application Adapter for SAP R/3とのデプロイメントおよび統合について説明します。次のトピックが含まれています。
関連項目:
|
Oracle Application Adapter for SAP R/3は、インストール中にOracleWLSコンテナ内にデプロイされます。すべてのクライアント・アプリケーションはOracleWLS環境で動作します。J2CAデプロイメントでは、Common Client Interface (CCI)インタフェースにより、OracleWLSクライアント・アプリケーションはリソース・アダプタと統合されます。
関連項目:
|
図5-1に、Oracle Application ServerへのJ2CAコネクタのデプロイメントを示します。ランタイム・サービス・シナリオでは、Enterprise Java Bean、サーブレットまたはJavaプログラム・クライアントによって、J2CAリソース・アダプタへのCCIコールが行われます。アダプタはこれらのコールをリクエストとして処理し、EISに送信します。その後、EISのレスポンスがクライアントに返信されます。
関連項目:
|
Oracle Application Adapter for SAP R/3のJ2CAデプロイメント中、OracleWLSにより、次の場所にra.xml
と呼ばれるデプロイメント記述子が生成されます。
<ADAPTER_HOME>
\soa\thirdparty\ApplicationAdapters\iwafjca.rar\META-INF
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ファイルで定義されているパラメータを次の表に示します。
複数の管理対象コネクタ・ファクトリ・オブジェクトの作成
複数の管理対象コネクタ・ファクトリ・オブジェクトを作成するには、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 ファイルを変更するとき、アプリケーション・サーバーを再起動する必要があります。アプリケーション・サーバーがすでに実行されている場合は、一度停止し、再起動してください。
また、 |
追加の接続ファクトリ値用のWSDLファイルの変更
アプリケーション・エクスプローラでは、eis/OracleJCAAdapter/DefaultConnection
という名前のデフォルトの接続ファクトリを使用してJ2CAプロパティ・ファイルが生成されます。追加の接続ファクトリを作成した場合は、J2CAプロパティ・ファイル内のjca:address
セクションのロケーション・フィールドを反映するように、追加の構成および接続ファクトリ用に生成されたWSDLを変更する必要があります。isdsrv2_conn2
構成が含まれているOracle Application Adapter for SAP R/3用のデフォルトのJ2CAプロパティ・ファイルを次の例に示します。
J2CAプロパティ・ファイルに、次のデフォルトの接続ファクトリが含まれていることがわかります。eis/OracleJCAAdapter/DefaultConnection
<jca:address location="eis/OracleJCAAdapter/DefaultConnection" ConnectionSpec="com.ibi.afjca.cci.IWAFConnectionSpec" cs.AdapterName="MySAP" cs.Config="isdsrv2_conn2" UIConnectionName="Connection1"/>
この接続ファクトリ値を次の値に変更する必要があります。eis/OracleJCAAdapter/DefaultConnection1
例:
<jca:address location="eis/OracleJCAAdapter/DefaultConnection1" ConnectionSpec="com.ibi.afjca.cci.IWAFConnectionSpec" cs.AdapterName="MySAP" cs.Config="isdsrv2_conn2" UIConnectionName="Connection1"/>
jca:address
セクションのロケーション・フィールドの値のみ変更可能です。その他のフィールドまたはセクションは変更しないでください。