アダプタの開発
![]() |
![]() |
![]() |
![]() |
アダプタを作成したら、エンタープライズ アーカイブ (Enterprise Archive : EAR) ファイルを使用して、アダプタをデプロイする必要があります。EAR ファイルを使用すると、すべてのアダプタ コンポーネントを 1 度にデプロイできるため、この作業を効率的に行えます。EAR ファイルのデプロイは、WebLogic Server Administration Console から実行できます。
各アダプタは、1 つの EAR ファイルでデプロイされます。EAR ファイルには、デプロイに必要な設計時 Web アプリケーションの WAR ファイル、アダプタの RAR ファイル、アダプタの JAR ファイル、および共有 JAR ファイルが含まれています。この EAR ファイルは、コード リスト 10-1 に示す構造にします。
adapter.ear
application.xml
sharedJar.jar
adapter.jar
adapter.rar
META-INF
ra.xml
weblogic-ra.xml
MANIFEST.MF
designtime.war
WEB-INF
web.xml
META-INF
MANIFEST.MF
サンプル アダプタ用の EAR ファイルをコード リスト 10-2 に示します。
コード リスト 10-2 サンプル アダプタの EAR ファイル
sample.ear
application.xml
adk.jar (shared .jar between .war and .rar)
bea.jar (shared .jar between .war and .rar)
BEA_WLS_SAMPLE_ADK.jar (shared .jar between .war and .rar)
BEA_WLS_SAMPLE_ADK.war (Web application with
META-INF/MANIFEST.MF entry Class-Path:
BEA_WLS_SAMPLE_ADK.jar adk.jar bea.jar log4j.jar
logtoolkit.jar xcci.jar xmltoolkit.jar)
BEA_WLS_SAMPLE_ADK.rar (Resource Adapter with
META-INF/MANIFEST.MF entry Class-Path:
BEA_WLS_SAMPLE_ADK.jar adk.jar bea.jar log4j.jar
logtoolkit.jar xcci.jar xmltoolkit.jar)
log4j.jar (shared .jar between .war and .rar)
logtoolkit.jar (shared .jar between .war and .rar)
xcci.jar (shared .jar between .war and .rar)
xmltoolkit.jar (shared .jar between .war and .rar)
RAR ファイルと WAR ファイルは共有 JAR ファイルをインクルードせず、<manifest.classpath>
属性を使用して共有 JAR ファイルを参照します。
設計時アプリケーションは、アダプタの SPI クラスを非管理対象のシナリオで使用します。そのため、アダプタの SPI および CCI クラスは、EAR ファイルと同じディレクトリにある共有 JAR ファイルに含まれます。WAR および RAR クラスローダから共有 JAR ファイルのクラスにアクセスできるようにするには、MANIFEST.MF
ファイルで、共有 EAR ファイルのインクルードを要求する必要があります。MANIFEST.MF
の詳細については、「マニフェスト ファイル」または以下の URL の「Understanding the Manifest」を参照してください。
http://java.sun.com/docs/books/tutorial/jar/basics/manifest.html
BEA_WLS_SAMPLE_ADK.rar
ファイルと BEA_WLS_SAMPLE_ADK.war
ファイルには、コード リスト 10-3 に示す META-INF/MANIFEST.MF
が含まれています。
Manifest-Version: 1.0
Created-By: BEA Systems, Inc.
Class-Path: BEA_WLS_SAMPLE_ADK.jar adk.jar wlai-core.jar
wlai-client.jar
注意 : ファイル名 MANIFEST.MF
は、すべて大文字で表記します。正しく表記しないと、UNIX システムで認識されず、エラーが発生します。
コード リスト 10-4 に、EAR ファイルのコンポーネントを宣言するデプロイメント記述子を示します。この場合、これらのコンポーネントには設計時 WAR モジュールとアダプタ RAR モジュールが含まれます。
コード リスト 10-4 EAR ファイルのデプロイメント記述子
<!DOCTYPE application PUBLIC '-//Sun Microsystems, Inc.//DTD J2EE Application 1.3//EN'
'http://java.sun.com/dtd/application_1_3.dtd'>
<application>
<display-name>BEA_WLS_SAMPLE_ADK</display-name>
<description>This is a J2EE application that contains a sample
connector and Web application for configuring
application views for the adapter.</description>
<module>
<connector>BEA_WLS_SAMPLE_ADK.rar</connector>
</module>
<module>
<web>
<web-uri>BEA_WLS_SAMPLE_ADK.war</web-uri>
<context-root>BEA_WLS_SAMPLE_ADK_Web</context-root>
</web>
</module>
</application>
アダプタのデプロイは、WebLogic Server Administration Console から実行できます。この手順については、「WebLogic Server Administration Console を使用したアダプタのデプロイ」を参照してください。
WebLogic Server Administration Console を使用してアダプタをコンフィグレーションおよびデプロイする手順は以下のとおりです。
WebLogic Server Administration Console からアプリケーション (またはアプリケーション コンポーネント) をインストールすると、該当するドメインのコンフィグレーション ファイル (/config/
DOMAIN_NAME
/config.xml
。DOMAIN_NAME
はドメイン名) にもそのアプリケーションまたはコンポーネントのエントリが作成されます。また、アプリケーションとアプリケーション コンポーネントをコンフィグレーションしてモニタするための JMX Management Bean (MBean) も生成されます。
WebLogic Integration では、アダプタのデプロイ時に、自動登録プロセスが実行されます。自動登録は、アダプタのデプロイメント フェーズで実行されます。このプロセスは、以下の 2 つのいずれかの方法で呼び出せます。
設計時 Web アプリケーションとコネクタのデプロイメントに命名規約を使用することをお勧めします。
EAR ファイルを WebLogic Integration 環境でデプロイするときに、アダプタの論理名をファイル名として使用し、config.xml
でファイルを定義します。コード リスト 10-5 に、その例を示します。
コード リスト 10-5 config.xml ファイルへのアダプタ論理名の追加
<Application Deployed="true" Name="ALN"
Path="WLI_HOME/adapters/ADAPTER/lib/ALN
.ear">
<ConnectorComponent Name="ALN
" Targets="myserver"
URI="ALN
.rar"/>
<WebAppComponent Name="ALN
_EventRouter" Targets="myserver"
URI="ALN_EventRouter.war"/>
<WebAppComponent Name="ALN
_Web" Targets="myserver"
URI="ALN_Web.war"/>
</Application>
このコード リストでは、ALN
フィールドにアダプタの論理名を入力します。この名前を、<ConnectorComponent>
要素の Name
属性の値として使用してください。
設計時 Web アプリケーションのデプロイメントに ALN
_Web
という名前を割り当てると、デプロイメントの際に、設計時 Web アプリケーションが自動的に Weblogic Server Administration Console で登録されます。この命名規約は、DBMS およびサンプル アダプタで使用されています。
webcontext.txt
という名前のテキスト ファイルを EAR ファイルのパス名のルート ディレクトリにインクルードすることもできます。webcontext.txt
ファイルには、使用するアダプタの設計時 Web アプリケーションのコンテキストが含まれます。このファイルは、UTF-8 フォーマットでエンコードする必要があります。
アダプタによっては、イベント ルータの Web アプリケーションで使用されるデプロイメント パラメータを変更する必要があります。たとえば、DBMS サンプル アダプタの場合、対応するイベント ジェネレータで使用されるデータベース URL の変更が必要になります。
この節では、WebLogic Server Administration Console のデプロイメント記述エディタを使用して、以下の Web アプリケーション デプロイメント記述子を編集する方法について説明します。
イベント ルータ サーブレットのパラメータは変更できます。以下のパラメータがあります。
eventGeneratorClassName
userID
password
dataSource
jdbcDriverClassName
dbURL
dbAccessFlag
eventCatalog
eventSchema
RootLogContext
AdditionalLogContext
LogConfigFile
LogLevel
MessageBundleBase
LanguageCode
CountryCode
sleepCount
Web アプリケーション デプロイメント記述子を編集する手順は以下のとおりです。
この URL で、host
は WebLogic Server が稼動するコンピュータ名、port
は WebLogic Server がリスンするポート番号に置き換えます。たとえば、以下のようになります。
http://localhost:7001/console
これは、2 つのペインで構成されています。左側のペインには、Web アプリケーション デプロイメント記述子のすべての要素で構成されたナビゲーション ツリーが含まれます。右側のペインには、web.xml
ファイルの説明要素のフォームが含まれます。
web.xml
デプロイメント記述子の要素があります。 weblogic.xml
デプロイメント記述子の要素があります。
アダプタは、WebLogic Integration クラスタにデプロイできます。クラスタ化された WebLogic Integration 環境におけるアダプタのデプロイメントの詳細については、以下の URL の 『WebLogic Integration ソリューションのデプロイメント』の「WebLogic Integration クラスタについて」を参照してください。
http://edocs.beasys.co.jp/e-docs/wli/docs81/deploy/cluster.html
アダプタ インスタンスのイベント接続またはサービス接続を変更した場合は、変更を有効にするためにインスタンスを再デプロイする必要があります。アダプタ インスタンスを再デプロイすると、依存アプリケーション ビューも再デプロイされます。WebLogic Integration Administration Console を使用してアダプタ インスタンスを再デプロイすることができます。詳細については、次の URL の『WebLogic Integration ソリューションの管理』の「アダプタ インスタンスの再デプロイ」を参照してください。
http://edocs.beasys.co.jp/e-docs/wli/docs81/manage/ai.html
警告 : アダプタ インスタンスの再デプロイ操作では、アンデプロイおよび再デプロイ時の実行中トランザクションまたはトランザクション リクエストのトランザクション リカバリはまったく保証されません。トランザクションの処理中に再デプロイを実行すると、予測できない動作や、データベースと WebLogic Integration Administration Console の間で不一致が発生する可能性があります。
![]() ![]() |
![]() |
![]() |