Oracle Application Server Containers for J2EE(OC4J)のデプロイおよびOracleAS Adapter for Siebelとの統合について説明します。
この章の項目は次のとおりです。
関連項目:
|
OracleAS Adapter for Siebelは、インストール時にOC4Jコンテナ内にデプロイされます。すべてのクライアント・アプリケーションは、OC4J環境内で実行されます。 J2CAのデプロイでは、共通クライアント・インタフェース(CCI)によりOC4Jクライアント・アプリケーションとリソース・アダプタが統合されます。
図3-1に、Oracle Application Serverへのコネクタのデプロイを示します。 実行時サービスの使用例では、Enterprise Java Bean、サーブレットまたはJavaプログラム・クライアントがJ2CAリソース・アダプタに対してCCIコールを実行します。アダプタは、このコールをリクエストとして処理し、EISに送ります。EISのレスポンスはクライアントに送られます。
図3-1 Oracle Application Server AdapterのJ2CAアーキテクチャ
関連項目:
|
OracleAS Adapter for SiebelをJ2CAにデプロイするときに、OC4Jによってoc4j-ra.xml
というデプロイメント・ディスクリプタが生成されます。このデプロイメント・ディスクリプタは、OC4J_home
\integration\orabpel\system\appserver\oc4j\j2ee\home\application-deployments\default\iwafjca
にあります。
注意: インストールには oc4j-ra.xml という名前のファイルが複数含まれています。この項で説明するOC4Jデプロイメント・ディスクリプタは、指定したディレクトリにあります。 |
単一の管理コネクタ・ファクトリ・オブジェクトの作成
oc4j-ra.xml
記述子は、リソース・アダプタに関するOC4J固有のデプロイ情報を提供します。 たとえばApplication Explorerでのデフォルトのjca_sample
構成は、oc4j-ra.xml
ファイルでは次のように表されます。
<?xml version="1.0"?><!DOCTYPE oc4j-connector-factories PUBLIC "-//Oracle//DTD Oracle Connector 9.04//EN" "http://xmlns.oracle.com/ias/dtds/oc4j-connector-factories-9_04.dtd"> <oc4j-connector-factories> <connector-factory location="eis/OracleJCAAdapter/DefaultConnection" connector-name="IWAFJCA10"> <config-property name="IWayHome" value="../../adapters/application"/> <config-property name="IWayConfig" value="jca_sample"/> <config-property name="IWayRepoURL" value=""/> <config-property name="IWayRepoUser" value=""/> <config-property name="IWayRepoPassword" value=""/> <config-property name="logLevel" value="debug"/> </connector-factory> </oc4j-connector-factories>
oc4j-ra.xml
ファイルで定義されているパラメータについては、次の表で説明します。
パラメータ名 | 説明 |
---|---|
IWayHome | OracleASにパッケージされたアプリケーション・アダプタの基本インストール・ディレクトリ。 |
IWayConfig | Application Explorerで定義されているアダプタ構成名。たとえば、OracleAS Adapter for Siebelの場合は、Application Explorerでjca_sample 構成が事前に構成されています。 |
IWayRepoURL | データベースへの接続をオープンするときに使用するURL。このパスワードが必要なのは、BSEリポジトリとしてOracleデータベースを使用する場合のみです。詳細は、「BSEシステム設定の構成」を参照してください。 |
IWayRepoUser | データベースへの接続時に使用するユーザー名。このパスワードが必要なのは、BSEリポジトリとしてOracleデータベースを使用する場合のみです。詳細は、「BSEシステム設定の構成」を参照してください。 |
IWayRepoPassword | パスワード。指定すると、構成が上書きされます。このパスワードが必要なのは、BSEリポジトリとしてOracleデータベースを使用する場合のみです。詳細は、「BSEシステム設定の構成」を参照してください。 |
loglevel | ManagedConnectionFactoryプロパティで設定されているレベルが上書きされます。 |
複数の管理コネクタ・ファクトリ・オブジェクトの作成
複数の管理コネクタ・ファクトリ・オブジェクトを設定するには、oc4j-ra.xml
ファイルを編集して<connector-factory>
ノードを追加する必要があります。 たとえば、Application Explorerでのデフォルトのjca_sample
構成は、oc4j-ra.xml
ファイルでは次のように表されます。
<?xml version="1.0"?><!DOCTYPE oc4j-connector-factories PUBLIC "-//Oracle//DTD Oracle Connector 9.04//EN" "http://xmlns.oracle.com/ias/dtds/oc4j-connector-factories-9_04.dtd"> <oc4j-connector-factories> <connector-factory location="eis/OracleJCAAdapter/DefaultConnection" connector-name="IWAFJCA10"> <config-property name="IWayHome" value="../../adapters/application"/> <config-property name="IWayConfig" value="jca_sample"/> <config-property name="IWayRepoURL" value=""/> <config-property name="IWayRepoUser" value=""/> <config-property name="IWayRepoPassword" value=""/> <config-property name="logLevel" value="debug"/> </connector-factory> </oc4j-connector-factories>
複数の管理コネクタ・ファクトリ・オブジェクトを作成するには、ファイルに新規の<connector-factory>ノードを追加する必要があります。次に例を示します。
<?xml version="1.0"?><!DOCTYPE oc4j-connector-factories PUBLIC "-//Oracle//DTD Oracle Connector 9.04//EN" "http://xmlns.oracle.com/ias/dtds/oc4j-connector-factories-9_04.dtd"> <oc4j-connector-factories> <connector-factory location="eis/OracleJCAAdapter/DefaultConnection1" connector-name="IWAFJCA10"> <config-property name="IWayHome" value="../../adapters/application"/> <config-property name="IWayConfig" value="jca_sample"/> <config-property name="IWayRepoURL" value=""/> <config-property name="IWayRepoUser" value=""/> <config-property name="IWayRepoPassword" value=""/> <config-property name="logLevel" value="debug"/> </connector-factory> <connector-factory location="eis/OracleJCAAdapter/DefaultConnection2" connector-name="IWAFJCA10"> <config-property name="IWayHome" value="../../adapters/application"/> <config-property name="IWayConfig" value="jca_sample2"/> <config-property name="IWayRepoURL" value=""/> <config-property name="IWayRepoUser" value=""/> <config-property name="IWayRepoPassword" value=""/> <config-property name="logLevel" value="debug"/> </connector-factory> </oc4j-connector-factories>
次の例では、パッケージされたアプリケーション・アダプタでCCIを使用するためのコード構造を示します。コード例は4つのステップにわかれています。
注意: OracleAS Adapter for Siebelは、CCI API経由の起動をサポートしていません。 Oracle BPEL Process ManagerおよびESBを使用した起動のみをサポートしています。 次の項はリファレンス用に掲載します。 |
ステップ1. コネクション・ファクトリの取得
コネクション・ファクトリはJNDIルックアップにより取得されます。
InitialContext context = new InitialContext(); ConnectionFactory cf = (ConnectionFactory)context.lookup(iwayJndi)
ステップ2. アダプタ用接続の取得
IWAFConnectionSpecは、設計時または実行時のサービス・アダプタ接続を作成するために使用されるConnectionSpecの実装です。ConnectionSpecには7つのパラメータがあります。ログ・レベルを除き、これらのパラメータに基づいて接続プーリングが完全にサポートされ、設定されます。
ConnectionSpecでアダプタ名と構成のパラメータを指定すると、iWAFConnectionSpecでSiebelとの相互作用を開始できます。 次に例を示します。
iWAFConnectionSpec cs = new IWAFConnectionSpec(); cs.setAdapterName(ADAPTER); cs.setConfig(TARGET); cs.setLogLevel(LOG_LEVEL); // Adapter layer log level Connection c = cf.getConnection(cs);// where cf is the connection factory
このコード部分では、ADAPTER
はデプロイするアダプタ(この場合はSiebel)、TARGET
はApplication Explorerで定義されているターゲットの名前を指します。詳細は、「完全なコード例」を参照してください。
ステップ3. 実行時用のinteractionSpecとの相互作用の作成
Interaction i = c.createInteraction(); IWAFInteractionSpec is = new IWAFInteractionSpec(); is.setFunctionName(IWAFInteractionSpec.PROCESS);
PROCESSおよびIWAEという2つのファンクションを設定できます。 PROCESSは実行時に使用されます。IWAEが使用されるのは、設計時にIAEAdapterを使用する場合です。
ステップ4. 入力レコードの作成と相互作用の実行
この例では、EISの起動を完了するために、Siebelメッセージが参照されます。スキーマはApplication Explorerから提供されます。
この例では、標準的なJ2CA索引付きレコードを使用しています。
// Use J2CA IndexRecord, named "input" for run-time processing.
IndexedRecord rIn = cf.getRecordFactory().createIndexedRecord("input");
rIn.add(msg_run
);
IndexedRecord rOut = (IndexedRecord)i.execute(is, rIn);
System.out.println((String)rOut.get(0));
この例では、特殊なレコードがサポートされます。
//IWAFRecord rIn = new IWAFRecord("input");
//rIn.setRootXML(msg_run
);
//IWAFRecord response = executeRunInteraction(c, rIn);
//IWAFRecord rOut = (IWAFRecord)i.execute(is, rIn);
//System.out.println(rOut.getRootXML());
msg_run
は、Application Explorerで作成されたスキーマから生成されるインスタンスのXML文書です。
完全なコード例
import javax.resource.cci.*; import com.ibi.afjca.cci.*; import com.ibi.afjca.spi.*; /** * The purpose of this sample is to illustrate how to use the IWAF Universal * JCA connector. */ public class IWAFJCASimple { private static String HOME = "c:/iway/xfoc/components/iwafcont/dist"; private static String CONFIG = "base"; private static String LOG_LEVEL = "FATAL"; private static String ADAPTER = "Siebel"; private static String TARGET = "Siebel_connection"; // Input Message private static String msg_run = "<Siebel/>"; public static void main(String[] args) throws Exception { // 1. Getting the Connection factory through JNDI lookup // --------------------------------------------------------- InitialContext context = new InitialContext(); ConnectionFactory cf = (ConnectionFactory)context.lookup(iwayJndi) // 2. Getting a connection for a particular adapter target, in this case Siebel // --------------------------------------------------------- IWAFConnectionSpec cs = new IWAFConnectionSpec(); cs.setAdapterName(ADAPTER); cs.setConfig(TARGET); cs.setLogLevel(LOG_LEVEL); // Adapter layer log level Connection c = cf.getConnection(cs);// where cf is the connection factory // 3. Create interaction with interactionSpec for RUNTIME // --------------------------------------------------------- Interaction i = c.createInteraction(); IWAFInteractionSpec is = new IWAFInteractionSpec(); is.setFunctionName("PROCESS"); // 4. Create input Record and execute interaction // --------------------------------------------------------- // 4.1 Using JCA standard Indexed Record // Use JCA IndexRecord, named "input" for run-time processing. IndexedRecord rIn = cf.getRecordFactory().createIndexedRecord("input"); rIn.add(msg_run
); IndexedRecord rOut = (IndexedRecord)i.execute(is, rIn); System.out.println((String)rOut.get(0)); // 4.2 Our own Record is supported here //IWAFRecord rIn = new IWAFRecord("input"); //rIn.setRootXML(msg_run
); //IWAFRecord response = executeRunInteraction(c, rIn); //IWAFRecord rOut = (IWAFRecord)i.execute(is, rIn); //System.out.println(rOut.getRootXML()); } // main() }