3 OC4Jのデプロイおよび統合

Oracle Application Server Containers for J2EE（OC4J）のデプロイおよびOracleAS Adapter for Siebelとの統合について説明します。

この章の項目は次のとおりです。

アダプタとOC4Jの統合
アダプタのデプロイ
アダプタ構成の更新
CCI APIを使用したJava Application Clientの作成方法

アダプタとOC4Jの統合

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アーキテクチャ

「図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 APIを使用したJava Application Clientの作成方法

次の例では、パッケージされたアプリケーション・アダプタで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つのパラメータがあります。ログ・レベルを除き、これらのパラメータに基づいて接続プーリングが完全にサポートされ、設定されます。

パラメータ名	説明
adapterName	パッケージされているアプリケーション・アダプタの名前。
config -	アダプタ構成名。IWAEAdapterの場合は不要です。
language	デフォルトは`en`です。
country	デフォルトは`us`です。
userName	ユーザー名。指定すると、構成が上書きされます。
password	パスワード。指定すると、構成が上書きされます。
logLevel	ManagedConnectionFactoryプロパティで設定されているレベルが上書きされます。

注意:

現在、OracleAS Adapter J2CAでサポートされているのは、基本的なセキュリティ・マッピングのみです。DEBUGログ・レベルでは、マッピング動作の詳細情報が提供されます。機能は次のとおりです。

user nameとpasswordを設定せず、アプリケーション・サーバーからセキュリティが提供されていない場合にも、OracleAS Adapter J2CAではアダプタ構成のセキュリティ情報を受け渡して使用できます。
user nameとpasswordを設定すると、これらの値でアダプタ構成が上書きされます。OracleAS Adapter J2CAでは、この情報がアプリケーション・サーバーから提供されるセキュリティ情報と比較され、値が一致しない場合はログに記録されます。ただし、その場合も情報は受け渡すことができます。

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()

}