ADK の概要

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

サイトマップ

用語集

検索

e-docs > WebLogic Integration > AI トピック > アダプタの開発 > ADK の概要

アダプタの開発

ADK の概要

このガイドでは、WebLogic Integration Adapter Development Kit（ADK）の使用手順について説明します。具体的には、イベントアダプタ、サービスアダプタ、および設計時ユーザインタフェースの開発、テスト、デプロイ方法について説明します。

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

この章の目的

この章では、ADK によるイベントアダプタ、サービスアダプタ、および設計時 GUI の開発方法について概説し、以下の事項の習得を目的とします。

アダプタの特徴と使用方法
アダプタ開発の前提条件
アダプタ開発に関連する用語

ADK の特徴

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

設計時動作
実行時動作
ロギング
パッケージ化

アダプタ開発の前提条件

ADK は、アダプタの開発に必要な次の 3 つの前提条件を備えています。

開発環境構造－どのような統合開発/デバッグ環境（IDDE）でも、開発プロジェクトの構成が最も重要です。しっかりと構成された開発環境があれば、アダプタのコーディングにすぐに着手できます。ADK では、整った開発環境、ビルドプロセス、テスト体系、および直感的にイメージできるクラス名とクラス階層を提供しています。ADK を使用することで、ビルドプロセスの設計や構成に時間を費やす必要がなくなります。

ADK には非常に多くの先進技術が取り入れられているため、段階的な開発プロセス（コードを少し作成してはテストし、次に進む）が成功への鍵となります。ADK のテストプロセスを用いれば、開発者は簡単に変更を加えて、その変更をすぐにテストできます。
実装の周辺的な詳細をできる限り公開しない－周辺的な実装の詳細は、堅牢なソフトウェアプログラムが稼動するフレームワークのサポートに必要なコードセクションです。

たとえば、J2EE コネクタアーキテクチャの仕様では、javax.resource.cci.InteractionSpec 実装クラスで、JavaBeans 設計パターンの後にゲッター（取得）およびセッター（設定）メソッドを指定する必要があります。JavaBeans 設計パターンをサポートするには、使用する実装クラスで PropertyChangeListeners および VetoableChangeListeners をサポートする必要があります。このサポート方法を習得するために JavaBeans の仕様を学習するのは大変です。それよりも、アダプタに関するエンタープライズ情報システム（EIS）固有の実装を中心に作業するほうが望ましいことです。ADK は、アダプタを実装するための周辺的な詳細の大半に対応できる基本的な機能を備えています。
目的達成への明確なロードマップ－終了条件とは、「実装の完了はどのように判断すればよいのか」という問いに対する回答です。ADK は、アダプタの開発方法を明確な形で提供しています。その開発方法に従えば、開発者は、イベント、サービス、設計時動作、および実行時動作という主要コンセプトを軸にして、アイディアをまとめることができます。この開発方法を使用して、実装完了へのロードマップを形成する終了条件を確立できます。

ADK が提供する機能

ADK は、以下の機能を提供します。

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

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

アダプタの特徴

リソースアダプタ（このマニュアルでは単に「アダプタ」と呼びます）は、相互に通信できるように設計されていないアプリケーションを連結するソフトウェアコンポーネントです。たとえば、ある会社が作成した注文入力システムと別の会社が作成した顧客情報システムとの間で通信を行うには、両者をつなぐアダプタが必要です。

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

メッセージを消費するサービスアダプタ
メッセージを生成するイベントアダプタ

また、ADK により、J2EE コネクタアーキテクチャの仕様に準拠していますが、Weblogic Integration 以外でも使用可能な J2EE 準拠アダプタを作成することもできます。

サービスアダプタ

サービスアダプタは、クライアントから XML 要求ドキュメントを受け取ると、基盤となるエンタープライズ情報システム（EIS）内の特定の関数を呼び出します。このサービスアダプタはメッセージのコンシューマで、応答を返す場合と返さない場合があります。

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

サービスアダプタでは、次の 4 つの機能が実行されます。

外部クライアントからサービス要求を受信します。
要求ドキュメントの 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 つのコンポーネントを使用して、各インタフェースの作成やデプロイメントの作業を最小限に抑えることができます。

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

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

アプリケーションビュー

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

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

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

アプリケーションビューの詳細については、『Application Integration ユーザーズガイド』の「Application Integration ユーザーズガイドの概要」を参照してください。

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

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

始める前に

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