WebLogic Integration 7.0 へのアダプタの移行

ドキュメントのダウンロード

サイトマップ

用語集

検索

e-docs > WebLogic Integration > AI トピック > アダプタの開発 > WebLogic Integration 7.0 へのアダプタの移行

アダプタの開発

WebLogic Integration 7.0 へのアダプタの移行

WebLogic Integration 2.1 から WebLogic Integration 7.0 に移行する場合、アダプタの移行タスクを実行する必要はありません。WebLogic Integration 2.1 向けに開発され、テストされたアダプタは、変更を加えなくても WebLogic Integration 7.0 で正常に稼動しますが、このリリースの新機能を最大限に活かすために、この章で説明するタスクを実行したほうが良い場合があります。

この章の内容は以下のとおりです。

WebLogic Integration 7.0 ADK 向けのアダプタの再構築

WebLogic Integration 7.0 ADK 向けにアダプタを再構築する必要がある場合、WebLogic Integration 7.0 で提供される新しいバイナリファイルを参照するよう、手順を再構築する必要があります。特に、以下の新しい JAR ファイルを参照する必要があります。

<property name='WLAI_CORE' value='${WLI_LIB_DIR}/wlai-core.jar'/>
<property name='WLAI_CLIENT' value='${WLI_LIB_DIR}/wlai-client.jar'/>
<property name='WLAI_EVENTROUTER' value='${WLI_LIB_DIR}/wlai-eventrouter.jar'/>

以下の JAR ファイルは、アダプタでの有効性がなくなっています。

<property name='WLAI_CLIENT'   value='${WLI_LIB_DIR}/wlaiclient.jar'/>
<property name='WLAI_COMMON'   value='${WLI_LIB_DIR}/wlai-common.jar'/>
<property name='WLAI_EJB_CLIENT' value='${WLI_LIB_DIR}/wlai-ejb-client.jar'/>
<property name='WLAI_SERVLET_CLIENT'
     value='${WLI_LIB_DIR}/wlai-servlet-client.jar'/>
<property name='WLAI_EVENTROUTER_CLIENT'
     value='${WLI_LIB_DIR}/wlai-eventrouter-client.jar'/>

環境プロパティの宣言方法も、以下のフォームに合うよう変更する必要があります。

<property environment='env'/>

以下のような文は、無効となった Ant 文であるため、削除してください。

<property name='WL_HOME' environment='env'/>

注意: 無効な Ant 文があると、以下のようなエラーメッセージが表示されます。

You must specify value, location or refid with the name attribute.

アプリケーション統合 CLASSPATH およびアダプタのパッケージ化の変更

WebLogic Integration 2.1 および WebLogic Integration 2.1 SP1 では、WebLogic Server のインスタンスに対し、システム CLASSPATH にアダプタの java クラスが必要とされていましたが、WebLogic Integration 7.0 では、アダプタ java クラスは単一の独立した EAR ファイルにパッケージ化されている必要があります。アダプタ java クラスまたは JAR ファイルを WebLogic Integration 7.0 のインストールに移動したり、アダプタのクラスを WebLogic Integration CLASSPATH に追加しないでください。アダプタ EAR ファイルのコンフィグレーション手順については、『WebLogic Integration 移行ガイド』「移行に関するその他のトピック」の「Application Integration アダプタ EAR ファイルのコンフィグレーション」を参照してください。

アダプタによる共有接続ファクトリユーザインタフェースのサポートの許可

WebLogic Integration は、共有接続ファクトリをサポートしています。アダプタが、関連付けられたユーザインタフェースと対話するのを許可するには、アダプタのプロパティファイルに以下のプロパティを追加します。nav.jsp プロパティは、Application View Console に表示されるツールバー項目に対応しており、その他のプロパティは共有接続ファクトリの表示ラベルとして使用されます。共通接続ファクトリを使用する場合、必ず最新の ADK および設計時インタフェースを使用してください。

#nav.jsp#
nav_label_summary=Summary
nav_label_service=Add&nbsp;Service
nav_label_main=Home
nav_label_event=Add&nbsp;Event
nav_label_deploy=Deploy&nbsp;Application&nbsp;View
nav_label_define=Define&nbsp;Application&nbsp;View
nav_label_connection=Configure&nbsp;Connection
nav_label_admin=Administration
nav_label_select=Select&nbsp;Connection&nbsp;Type

# owned connection hdr #
connhdr_label_username=User Name:
connhdr_label_eisproductname=EIS Product Name:
conndhr_label_eisproductversion=EIS Product Version:

# referenced connection hdr #
connhdr_label_referenceConnectionCaption=Referenced Connection
connhdr_label_connection=Connection:
connhdr_label_adaptername=Name:
connhdr_label_adapterdesc=Description:
connhdr_label_adapterversion=Version:
connhdr_label_adapterlocaltrans=Supports local transactions

depappvw_label_sharedconnection=Shared Connection
depappvw_label_adaptername=Name:
depappvw_label_adaptervendor=Vendor:
depappvw_label_adapterdesc=Description:
depappvw_label_adapterversion=Version:

WebLogic Integration 2.1 アダプタとの下位互換性をサポートするには、アプリケーション統合エンジンがユーザインタフェースを識別する必要があります。以下のような変更を行い、ユーザインタフェースにバージョン番号をマーキングします。

アダプタの Web コンポーネントの web.xml ファイルに以下のエントリを加えます。

<context-param>
  <param-name>version</param-name>
  <param-value>7.0</param-value>
</context-param>

<サーブレット>
  <servlet-name>contextinfo</servlet-name>
  <servlet-class>jsp_servlet.__contextinfo</servlet-class>
</servlet>

<servlet-mapping>
  <servlet-name>contextinfo</servlet-name>
  <url-pattern>contextinfo</url-pattern>
</servlet-mapping>

contextinfo JSP により、アプリケーション統合エンジンによるユーザインタフェースフレームワークのバージョンの識別が可能になります。この JSP は、WebLogic Integration 7.0 を使用してアダプタを再コンパイルするときに追加されます。

セキュリティ制約とログインコンフィグレーションにおける変更

アダプタの開発者は、アダプタグループではなく Administrators グループを使用するよう設計時ロールの制約を更新する必要があります。前のリリースでは、ユーザはアダプタグループに属している必要がありました。リリース 7.0 以降では、ユーザは Administrators グループに属している必要があります（設計時 GUI の開発のリスト8-14 およびリスト8-15 のロール名を参照してください）。この変更は、デプロイメントに、ユーザが Administrators グループに属することが必須の MBeans へのアクセスが必要となるためです。

要求データを必要としないサービスに対する DBMS サンプルアダプタの変更

WebLogic Integration 7.0 では、要求データを必要としないサービスに対し、DBMS サンプルアダプタにより、空またはヌルの要求ドキュメント定義が生成されます。たとえば、where 文節にパラメータを供給しないシンプルな SQL select文に基づくサービスは、実行時に要求ドキュメントの実行を必要としません。このようなサービスは、空またはヌルのドキュメント定義に関連付けられます。これは、DBMS サンプルアダプタの設計時 Web インタフェースの [Summary and Administration] ページの [要求はありません] ラベルに表示されます。

ApplicationView インスタンスで要求データを必要としないサービスの名前で ApplicationView.getRequestDocumentDefinition() を呼び出すと、isNull() メソッドが true を返す IDocumentDefinition インスタンスが返されます。IDocumentDefinition インスタンスで getDocumentSchema()、getDocumentSchemaName() または getRootElementName() を呼び出すと、送出時に IllegalStateException が発生します。

これらの変更は、WebLogic Integration 7.0 の DBMS サンプルアダプタで定義されたアプリケーションビューにのみ反映されます。この変更は、既存のアプリケーションビューには影響はありませんが、サンプルアダプタの動作の変化を、進行中の開発において考慮する必要があります。

WebLogic Integration 7.0 での WebLogic Integration 2.1 アダプタの使用

WebLogic Integration 2.1 を使用して開発されたアダプタは、コンポーネントの再コンパイルを行わなくても WebLogic Integration 7.0 で使用できますが、これらのアダプタを WebLogic Integration 7.0 で使用する前に、コンフィグレーションを以下のように変更する必要があります。

クラスパスに wlai-client.jar を追加する。
イベントルータをプライムする。

まず、クラスパスに wlai-client.jar を追加します。startWeblogic スクリプトを編集して、Windows システムの [スタート] コマンドに以下のテキストを追加します。

%WLI_HOME%¥lib¥wlai-client.jar

%JAVA_HOME%¥bin¥java -classic %DB_JVMARGS% -Xmx256m -classpath
%WLI_HOME¥lib¥wlai-client.jar;%SVRCP%

UNIX システムの場合は、以下のテキストを追加します。

$WLI_HOME¥lib¥wlai-client.jar

クラスパスを変更する他に、WebLogic Integration 2.1 アプリケーションビューをデプロイする前に、イベントルータをプライムする必要があります。これは、WebLogic Integration 2.1 アダプタを WebLogic Integration 7.0 環境で実行する場合にのみ、そしてアプリケーションビューをデプロイメントする前にのみ必要です。イベントルータをプライムすることで、ルータは、サーバとの通信が途切れた場合に自身を再初期化します。

イベントルータをプライムするには、イベントルータサーブレットにアクセスする必要があります。イベントルータサーブレットにアクセスするには、デプロイされているイベントルータの URL を使用します。イベントルータは、アプリケーション統合エンジンと同じ物理マシン上で、つまり別の WebLogic Server インスタンスに対してデプロイされている場合があります。ローカルにデプロイされたイベントルータの URL は、通常、以下のようなパターンになります。

http://localhost:7001/EventRouterContext/EventRouter

ここで、EventRouterContext は application.xml ファイルで定義されたコンテキストです。たとえば、DBMS サンプルアダプタのイベントルータのコンフィグレーションページは以下のようになります。

http://localhost:7001/DbmsEventRouter/EventRouter

イベントルータは、ルータを WAR ファイルにコンパイルすることでスタンドアロンモジュールとしてデプロイされている場合もあります。DBMS サンプルアダプタは、eventrouter_war ターゲットに示すように、このメソッドを build.xml ファイルで使用します。以下は DBMS サンプルアダプタに対する build.xml ファイルからの抜粋です。ここでルータがどのように WAR ファイルにコンパイルされるかを示します。

<target name='eventrouter_war' depends='jar,eventrouter_jar'>
  <delete dir='${SRC_DIR}/eventrouter/WEB-INF/lib'/>
  <war warfile='${LOCAL_LIB_DIR}/${EVENTROUTER_WAR_FILE}'
    webxml='${SRC_DIR}/eventrouter/WEB-INF/web.xml'>
    <fileset dir='.' includes='version_info.xml'/>
    <fileset dir='${SRC_DIR}/eventrouter'     excludes='WEB-INF/web.xml'/>
    <lib dir='${LOCAL_LIB_DIR}'
    includes='${JAR_FILE},${EVENTROUTER_JAR_FILE}'/>
    <lib dir='${WLI_LIB_DIR}'
    includes='adk.jar,adk-eventgenerator.jar,
    wlai-eventrouter.jar,wlai-core.jar,wlai-client.jar'/>
  </war>
</target>

この URL を使用してイベントルータサーブレットにアクセスすると、イベントルータのコンフィグレーションが表示されます。

このページで、イベントルータのサーバをコンフィグレーションすることができます。イベントルータのサーバ情報を追加するには、

[Add] ラジオボタンを選択します。
サーバ名（DNS または TCPIP）とポートを入力します。
ユーザ id とパスワードを入力します。

注意: ユーザは必ず管理者特権を持つ必要があります。
[Do it] をクリックします。
[Save Changes] をクリックします。パラメータの情報が変更され、変更が保存されたことを示す確認メッセージが表示されます。

初期化ファイルで、イベントルータが初期化されたことを確認できます。このファイルは、通常、_Servletcontextidname で始まる長い名前を持ちます。このファイルは、必要に応じていつでも安全に削除し、再作成することができます。