ADK の概要

このガイドでは、WebLogic Integration ADK (Adapter Development Kit) を使用する手順を説明します。イベント接続、サービス接続、および設計時ユーザインタフェースの開発、テスト、デプロイ方法を説明します。

この節の目的

この節では ADK を使用してイベント接続、サービス接続、および設計時 GUI を開発する方法を概説します。以下の項目を学習します。

アダプタの特徴と使用方法
アダプタ開発における要件
アダプタ開発に関連する用語

ADK とは

ADK は、BEA WebLogic Integration でサポートされているイベントおよびサービスプロトコルを実装するためのツールセットです。これらのツールは、WebLogic Integration の各種リソースアダプタの開発、テスト、パッケージ化、配布をサポートする一連のフレームワークに収められています。ADK には、以下の 4 つの目的に応じたフレームワークがあります。

設計時処理
実行時処理
ロギング
パッケージ化

アダプタ開発の要件

ADK は、アダプタ開発に必要な以下の 3 つの要件を満たしています。

開発環境構造 : すべての統合開発/デバッグ環境 (integrated development and debugging environment : IDDE) において、開発プロジェクトの組織化が最も重要です。構成のしっかりした開発環境があれば、アダプタのコーディングもすぐに開始できます。ADK には、組織的な開発環境、ビルドプロセス、テスト体系、および直感的にイメージできるクラス名とクラス階層が用意されています。ADK を使用することで、時間をかけずにビルドプロセスを設計および構成できます。

ADK にはさまざまな最新技術が採用され、段階的な開発プロセス (コードを少し作成してはテストし、次に進むプロセス) により着実に開発を進めることができます。ADK のテストプロセスを用いれば、開発者は簡単な変更を行いながら、その変更内容をすぐにテストできます。

周辺的な実装詳細に煩わされない : 周辺的な実装詳細は、堅牢なソフトウェアプログラムを稼動するフレームワークのサポートに必要なコード部分です。

たとえば、J2EE コネクタアーキテクチャ仕様では、javax.resource.cci.InteractionSpec 実装クラスで、JavaBean 設計パターンに従ってゲッターおよびセッターメソッドを指定する必要があります。ただし、JavaBean 設計パターンをサポートするには、使用する実装クラスで PropertyChangeListeners と VetoableChangeListeners もサポートする必要があります。このサポート方法を習得するために JavaBean の仕様を学習するのはたいへんです。それよりも、アダプタのエンタープライズ情報システム (Enterprise Information System : EIS) 固有の部分を実装するほうが望ましいといえます。ADK は、アダプタの実装における多くの周辺詳細に対応する基本的な機能を備えています。

目的達成への明確なロードマップ : 終了条件とは、「実装が完了したことをどのように判断すればよいのか」という問いに対する答えです。ADK では、アダプタの開発方法が明確になります。その開発方法に従うことで、開発者はイベント、サービス、設計時処理、および実行時処理という主要な概念を基に計画を立てることができます。この開発方法により、実装完了までのロードマップとなる終了条件を決定できます。

ADK の機能

イベントとサービスの実行時サポート
アダプタのユーザインタフェースを Application Integration Design Console に統合するための API

ADK では、アダプタを単一のグラフィックコンソールアプリケーションの一構成要素に組み入れることで、ビジネスユーザによる統合ソリューションの構築が可能になり、その価値がさらに高まります。

アダプタとは

リソースアダプタ (以下、「アダプタ」) は、本来相互に通信できるように設計されていないアプリケーションを接続するソフトウェアコンポーネントです。たとえば、ある会社が作成した注文入力システムと別の会社が作成した顧客情報システムとの間で通信を行うには、アダプタが必要です。

ADK を使用することにより、以下の 2 種類のアダプタを作成できます。

要求を受け入れ、応答を返すサービスアダプタ
メッセージを生成するイベントアダプタ

このサービスとイベントの両方をサポートするアダプタを作成することもできます。これらすべてのアダプタには、以下のトップレベルのアダプタインタフェースが実装されます。

ResourceAdapter - サービスとイベントのアダプタおよび接続を管理するトップレベルのコンテナ

また、ADK により、Weblogic Integration 固有のアダプタではなく、J2EE コネクタアーキテクチャ仕様に適合した J2EE 準拠アダプタを作成することもできます。

ResourceAdapter インタフェース

ResourceAdapter インタフェースは、WebLogic Integration 8.1 の新しい機能です。これは、イベントおよびサービス処理を統合する単一のオブジェクトとして機能します。WebLogic Integration の以前のリリースでは、イベントアダプタとサービスアダプタは、別々のアダプタコンポーネントとして扱われました。また、各アダプタを個別にデプロイおよびコンフィグレーションできました。

このリリースでは、イベントアダプタとサービスアダプタが ResourceAdapter インタフェースおよびアダプタのそのインタフェースの実装下で統合されています。このインタフェースにより、イベントアダプタが作成する 0 または 1 つのイベント接続、およびサービスアダプタが作成する 0 以上のサービス接続にアクセスできます。このサービス接続は、接続ファクトリと呼ばれることもあります。

イベント接続とサービス接続のコンフィグレーションは、ResourceAdapter インタフェースの下で実行されます。Application Integration Design Console で使用される用語「リソースアダプタ」は、イベント接続とサービス接続のコンテナを意味します。

アダプタが WebLogic Integration 内で機能するには、どのアダプタも具象クラスで ResourceAdapter を実装し、そのクラスをアダプタの EAR モジュールにパッケージ化する必要があります。ADK では、ResourceAdapter クラスの抽象基本実装が com.bea.adapter.spi.AbstractWLIResourceAdapter で提供されています。

サービス接続

サービス接続は、クライアントから XML 要求ドキュメントを受信すると、基底の EIS 内の特定の関数を呼び出します。このサービス接続はメッセージのコンシューマで、応答を返す場合と返さない場合があります。

サービスの呼び出しには、同期または非同期の 2 つの方法があります。サービスの呼び出しが非同期の場合、クライアントアプリケーションはサービス要求を発行した後も応答を待たずに処理を続行します。サービスの呼び出しが同期の場合、クライアントは応答を待ってから処理を続行します。BEA WebLogic Integration では、どちらのタイプの呼び出し方法もサポートされているため、この機能を設定する必要がありません。

外部クライアントからサービス要求を受信する。
XML フォーマットの要求ドキュメントを EIS 固有のフォーマットに変換する。要求ドキュメントは、サービスの要求 XML スキーマに準拠します。要求 XML スキーマは、EIS のメタデータに基づきます。
EIS 内の該当する関数を呼び出し、応答を待つ。
EIS 固有のデータフォーマットから、サービスの応答 XML スキーマに従った XML ドキュメントに応答を変換する。応答 XML スキーマは、EIS のメタデータに基づきます。

ADK には、イベントの場合と同様に、すべてのサービス接続に共通するこれら 4 つの機能が実装されています。

イベント接続

イベント接続は、EIS から WebLogic Server に情報を伝播します。このタイプの接続は、情報のパブリッシャと呼ばれます。

イベント接続には、プロセス内とプロセス外の 2 つの基本タイプがあります。プロセス内イベント接続は、EIS と同じプロセス内で実行されます。プロセス外イベント接続は、別のプロセス内で機能します。プロセス内イベント接続とプロセス外イベント接続の違いは、データ抽出プロセスの実行方法だけです。

WebLogic Integration 環境で稼動するイベント接続では、以下の 3 つの機能が実行されます。

外部パーティに関連すると思われるイベントが稼動中の EIS で発生した場合に応答し、そのイベントに関するデータを EIS から抽出する。
イベントデータを、EIS 固有のデータフォーマットから、イベントの XML スキーマに準拠する XML ドキュメントに変換する。この XML スキーマは、EIS のメタデータに基づきます。
各イベントを、アプリケーションサーバから提供されるイベントメッセージエンドポイントに伝播する。

ADK では、すべてのイベント接続に共通するこれら 3 つの機能が実装されています。このため、開発者はアダプタの EIS 固有の部分に専念できます。この概念は、エンタープライズ JavaBean (EJB) の背景にある概念と同じです。コンテナによってシステムレベルのサービスが提供されるため、EJB 開発者はビジネスアプリケーションロジックの実装に専念できます。

WebLogic Integration に限定されない J2EE 準拠アダプタ

このタイプのアダプタは WebLogic Integration 専用に設計されていないため、J2EE コネクタアーキテクチャ仕様に対応するすべてのアプリケーションサーバにプラグインできます。このタイプのアダプタは、サービス接続の開発手順を微調整するだけで開発できます。WebLogic Integration に限定されないアダプタの開発方法については、「WebLogic Integration に限定されないアダプタの作成」を参照してください。

設計時 GUI

イベント接続とサービス接続のほかにも、ADK の設計時フレームワークには Web ベースの GUI の構築に使用できるツールが用意されています。この Web ベースの GUI は、アダプタのユーザがアプリケーションビュー (後述の「アプリケーションビュー」を参照) を定義、デプロイ、およびテストする際に必要になります。どのアダプタにも EIS 固有の機能がありますが、すべてのアダプタにアプリケーションビューをデプロイする GUI が必要です。設計時フレームワークでは、主に以下の 2 つのコンポーネントを使用して、このようなインタフェースの作成やデプロイの作業を最小限に抑えることができます。

Web アプリケーションコンポーネントと Web 要求ハンドラ基本クラス (AbstractDesignTimeRequestHandler) : JSP (Java Server Pages) を使用して HTML ベースの GUI を作成できます。このコンポーネントの機能は、JSP テンプレート、JSP タグライブラリ、JavaScript ライブラリなどのツールによって拡張できます。
DesignTimeHelper という名称のデプロイメントヘルパーコンポーネント : このコンポーネントは、WebLogic Server 上のアプリケーションビューをデプロイ、アンデプロイ、および編集するための簡易な API を提供します。

設計時 GUI の開発方法については、「設計時 GUI の開発」を参照してください。

アプリケーションビュー

アダプタは、アプリケーション内のすべての機能に対するシステムレベルのインタフェースであるのに対し、アプリケーションビューは、アプリケーション内の特定の機能に対するビジネスレベルのインタフェースといえます。

アプリケーションビューは、単一のビジネス目的のためにコンフィグレーションされ、そのビジネス目的に関連したサービスだけが定義されます。これらのサービスは、要求ドキュメントで指定されるビジネス関連データだけを要求し、応答ドキュメントでビジネス関連データだけを返します。アプリケーションビューは、ユーザの介入なしに、このビジネス関連データを格納されているメタデータと結合します。アダプタは、このビジネス関連データと格納されているメタデータの両方を使用して、システムレベルの機能をアプリケーションに対して実行します。

また、アプリケーションビューは、特定のビジネス目的をサポートするイベントとサービスの両方を表します。これによって、ビジネスユーザは、アプリケーションビューを使用してアプリケーションと通信できます。この双方向通信は、実際にはイベント接続とサービス接続の 2 つのアダプタコンポーネントによってサポートされています。アプリケーションビューを使用することで、ユーザがこれを意識することなく、アプリケーションに対する統合ビジネスインタフェースを提供できます。

アプリケーションビューの詳細については、『Application Integration Design Console の使い方』の「Application Integration の概要」を参照してください。

パッケージ化フレームワーク

ADK のパッケージ化フレームワークは、顧客への配信用アダプタをパッケージ化するためのツールセットです。すべてのアダプタを 1 つの WebLogic Server で同じ方法でインストール、コンフィグレーション、およびアンインストールするのが理想的です。また、サービス接続もすべて J2EE 準拠である必要があります。パッケージ化フレームワークを使用すると、J2EE アダプタアーカイブ (RAR) ファイル、Web アプリケーションアーカイブ (WAR) ファイル、エンタープライズアーカイブ (EAR) ファイル、および WebLogic Integration 設計環境アーカイブを簡単に設計できるようになります。

始める前に

開発作業を始める前に、ご使用のコンピュータに WebLogic Integration がインストールされているかを確認してください。詳細については、『BEA WebLogic Platform のインストール』および BEA WebLogic Integration の『リリースノート』を参照してください。

アダプタの開発