WebLogic Integration 8.1 へのアップグレード
|
 |
 |
|
この節では、WebLogic Integration 7.0 (Service Pack 2) ADK (Adapter Development Kit) のアダプタ開発ツリーを、8.1 ADK のアダプタ開発ツリーに変換する手順について説明します。
注意 : WebLogic Integration 8.1 SP2 では、接続ファクトリはアダプタ インスタンスの一部になりました。詳細については、「ADK で開発された WebLogic Integration 7.0 SP2 アダプタの WebLogic Integration 8.1 SP2 へのアップグレード」を参照してください。
BEA_HOME/weblogic81/integration/adapters/sample/src/sample/spi/ResourceAdapterImpl.java に従って AbstractWLIResourceAdapter を拡張することで、WebLogic Integration リソース アダプタを実装します。ここでの BEA_HOME は、WebLogic Platform 8.1 のホーム ディレクトリを表します。アダプタを実装するときは、以下の点に注意してください。AbstractResourceAdapter クラスは、受信/送信アダプタ セクションの両方を保持する汎用的なアダプタ オブジェクトに必要なプロパティを定義する。この状況で使用するために、このプロパティ セットは ADK の標準プロパティを除いた Event Router web.xml 内の一連のプロパティで構成されます。ResourceAdapterImpl に event router web.xml のある特定のプロパティが含まれておらず、かつそのプロパティがユーザのアダプタに特有でない場合は、そのプロパティを ResourceAdapterImpl クラスに含めない。ResourceAdapterImpl クラスのプロパティごとに、メソッドのセッター/ゲッターのペアが必要。BEA_HOME/weblogic81/integration/adapters/sample/src/wli-ra.xml に従って、wli-ra.xml ファイルをユーザの <アダプタ ルート>/src ディレクトリ (たとえば MyAdapter/src/wli-ra.xml) に追加する。このファイルのフォーマットは Connector 1.5 ドラフト仕様のものです。このファイルによって作成中の ResourceAdapterImpl クラスが記述されます。 この仕様については、次の URL にある Java Community Process (JCP) プログラムの「JSR 112: J2EE Connector Architecture 1.5」を参照してください。
http://jcp.org/en/jsr/detail?id=112
<アダプタの論理名>.properties というアダプタ プロパティ ファイル名を、<アダプタの論理名>-base.properties に変更します (たとえば MyAdapter_1_0.properties を MyAdapter_1_0-base.properties に変更)。web.xml と weblogic.xml) が、WebLogic Integration 8.1 のビルド スキームで機能するように準備します。新しいスキームによって、これらの記述子に含まれているアダプタ固有の情報が、汎用的な (ADK または WebLogic Server で定義された) 情報から別々のファイルへと分離されます。この新しいスキームでは、アダプタ ソースにユーザが用意した単純なプロパティ ファイルに基づいて、web.xml ファイルと weblogic.xml ファイルが生成されます。ビルドの変更についてはこの後の手順 5 を参照してください。<アダプタ ルート>/src/war/WEB-INF ディレクトリに、web-gen.properties という名前の新しい .properties ファイルを作成します。このファイルに入れるプロパティを次の手順で記述します。基本的に、これらのプロパティは同じディレクトリの web.xml ファイルの内容から導出されます。display-name というプロパティを追加し、そのプロパティに web.xml 記述子の display-name に使用した値を設定します。たとえば、web.xml に次の display-name 要素があるとします。<web-app>
<display-name>BEA_WLS_SAMPLE_ADK</display-name>
request-handler-class というプロパティを追加し、その値として設計時リクエスト ハンドラのクラス名を設定します。この値は、既存の web.xml ファイル内でコントローラ サーブレット定義の RequestHandlerClass init-param に指定されています。web.xml ファイルではこれが次のように記述されています。<!-- コントローラ サーブレット -->
<servlet>
<servlet-name>controller</servlet-name>
<servlet-class>com.bea.web.ControllerServlet</servlet-class>
<init-param>
<param-name>MessageBundleBase</param-name>
<param-value>BEA_WLS_SAMPLE_ADK</param-value>
<description></description>
</init-param>
<init-param>
<param-name>RequestHandlerClass</param-name><param-value>sample.web.DesignTimeRequestHandler</param-value>
<description>設計時要求を処理するクラス</description>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
debug-setting というプロパティを追加し、その値として on または off を設定します。これは、以前の web.xml ファイルでコントローラ サーブレットの init-params に指定されていた値と同じであることが必要です。extra-jsp-list というプロパティを追加し、アダプタに追加した JSP ページのリストを指定します。この JSP ページは、ADK ですでに定義されているページ以外の追加ページです。このリストは、追加の JSP のカンマ区切りのリストです。標準の JSP は、addevent、addservc、confconn、edtevent、edtservc、event、service、および testform です。これらの JSP は extra-jsp-list に入れないでください。たとえば mybrowser.jsp という JSP を追加すると、extra-jsp-list は次のようになります。extra-jsp-list=mybrowser
<アダプタ ルート>/src/ear/META-INF/application.xml ファイルを編集し、イベント ルータの Web モジュール定義を削除します。たとえば、サンプル アダプタでは次のテキストを削除します。<module>
<web>
<web-uri>BEA_WLS_SAMPLE_ADK_EventRouter.war</web-uri>
<context-root>BEA_WLS_SAMPLE_ADK_EventRouter</context-root>
</web>
</module>
注意 : 次の説明は、使用する build.xml ファイルが ADK に付属の build.xml ファイルに基づいていることを前提としています。build.xml ファイルが ADK の build.xml ファイルに基づいていない場合、またはこのファイルを大幅に変更した場合は、その違いに対応するよう下記の説明を調整する必要があります。
...
<!--
アダプタのソース ディレクトリから "includes" リストをインクルードする
このアダプタに対し、sample/cci、sample/event、sample/spi の
各パッケージのすべてのクラスがログ コンフィグレーション ファイル
およびメッセージ バンドルと共にインクルードされる
-->
<fileset dir='${SRC_DIR}'
includes='sample/cci/*.class,sample/event/*.class,sample/spi/*.class, sample/eis/*.class,
*.xml,*.properties'/>
...
<zipfileset src='${WLI_LIB_DIR}/adk-eventgenerator.jar'>
<exclude name='META-INF/MANIFEST.MF'/>
</zipfileset>
web.xml と weblogic.xml) を生成する Ant タスクが ADK で呼び出されます。また、アダプタ固有のプロパティ ファイルが ADK.properties プロパティ ファイルにマージされて、アダプタの適切な運用に必要となる最終的なマージ済みプロパティ ファイルが生成されます。<!-- Web 記述子を生成する。注意 : 必要であれば、この機能をオフにして
web.xml/weblogic.xml を厳密にコントロールできる。
その場合、これらのファイルは web-gen.properties ではなく
src/war/WEB-INF で保持する。 --
<ant dir='${WLI_HOME}/adapters/utils/ant'
target='generate_web_descriptors'
inheritAll='false'>
<property name='web_gen_props_file'
value='${SRC_DIR}/war/WEB-INF/web-gen.properties'/>
</ant>
<!-- ADK.properties ファイルとアダプタ固有のプロパティをマージして、
アダプタが使用する最終的なプロパティ ファイルを作成する。
-->
<ant dir='${WLI_HOME}/adapters/utils/ant'
target='merge_properties'
inheritAll='false'>
<property name='props_dir' value='${SRC_DIR}'/>
<property name='adapter_props_file'
value='BEA_WLS_DBMS_ADK-base.properties'/>
<property name='target_props_file'
value='BEA_WLS_DBMS_ADK.properties'/>
</ant>
PUBLIC '-//BEA Systems, Inc.//DTD WebLogic 6.0.0 Connector//EN'
'http://www.bea.com/servers/wls600/dtd/weblogic600-ra.dtd'
|
|
|