開発ツール

ADK では、アダプタおよび設計時 GUI の開発を支援する堅牢なツール セットを提供しています。この章では、これらのツールについて説明します。この章の内容は以下のとおりです。

• サンプル アダプタ

• GenerateAdapterTemplate ユーティリティ

• ADK Javadoc

• Ant ベースのビルド プロセス

• XML ツール

 

---

サンプル アダプタ

開発者が、このコードを用いてアダプタの構築を始めることができるよう、ADK には、EIS に依存しないコード例を提供するサンプル アダプタが搭載されています。このサンプル アダプタと、同じく WebLogic Integration に搭載されている DBMS アダプタを混同しないよう注意してください。DBMS サンプル アダプタについては、DBMS サンプル アダプタを使用したアダプタ開発方法の学習で説明します。DBMS サンプル アダプタの格納場所は、WLI_HOME/adapters/dbms です。

サンプル アダプタの使用目的

サンプル アダプタの目的は、アダプタの構築に必要なコーディング作業の負担を大幅に軽減することです。サンプル アダプタにより、主要な抽象クラスについては具象実装が提供されるため、開発者に必要な作業は、ご使用の EIS の要件を満たすためのカスタマイズだけです。さらに、ADK では、開発対象のアダプタで使用する、サンプル アダプタの開発ツリーを手早く複製できる GenerateAdapterTemplate ユーティリティが提供されています。GenerateAdapterTemplate ユーティリティを参照。

サンプル アダプタの内容

サンプル アダプタは、以下のクラスから構成されます。

sample.cci.ConnectionImpl

クライアントがその物理接続にアクセスするときに使用するアプリケーションレベルのハンドルを表す、Connection インタフェースの具象実装。

sample.cci.InteractionImpl

DesignTimeInteractionSpecImpl クラスを使用してどのように設計パターンを実装するかを示すクラス。

sample.cci.InteractionSpecImpl

基本実装を提供するインタフェース。この基本実装は標準対話プロパティにゲッターおよびセッター メソッドを使用することにより拡張できる。

sample.client.ApplicationViewClient

サービスを呼び出し、アプリケーション ビューのイベントをリスンする方法を示すクラス。

sample.eis.EIS
sample.eis.EISEvent
sample.eis.EISListener

デモ用に簡単な EIS を表すクラス。

sample.event.EventGenerator

イベント ジェネレータを作成する ADK 基本クラスの拡張方法を示す、AbstractPullEventGenerator の具象拡張。

sample.event.OfflineEventGeneratorTestCase

Weblogic Server 以外のイベント ジェネレータの内部動作をテストするときに使用できるクラス。

sample.spi.ManagedConnectionFactoryImpl

特定の EIS のカスタマイズを行うことができる、AbstractManagedConnectionFactory の具象拡張。

sample.spi.ManagedConnectionImpl

特定の EIS のカスタマイズを行うことができる、AbstractManagedConnection の具象拡張。

sample.spi.ConnectionMetaDataImpl

特定の EIS のカスタマイズを行うことができる、AbstractConnectionMetaData の具象拡張。

sample.spi.NonManagedScenarioTestCase

非管理対象シナリオで SPI および CCI クラスをテストするために使用できるクラス。

sample.web.DesignTimeRequestHandler

設計時にイベントまたはサービスの追加方法を示す、AbstractDesignTimeRequestHandler の具象拡張。

注意: サンプル アダプタ内のサンプルによって拡張されたクラスの詳細については、ADK Javadocs を参照してください。

 

---

GenerateAdapterTemplate ユーティリティ

サンプル アダプタを使いやすくするため、ADK では GenerateAdapterTemplate というコマンドライン ユーティリティを提供しています。このユーティリティを使用して、サンプル ツリーを複製し、新しいアダプタ開発ツリーを作成できます。このアクションの使用法の詳細については、カスタム開発環境の作成を参照してください。

 

---

ADK Javadoc

ADK のクラス、インタフェース、メソッド、およびコンストラクタは、開発キットの Javadoc に定義されています。Javadoc は、WebLogic Integration インストールで組み込まれ、WLI_HOME/adapters/ADAPTER/docs/api に保存されます。ADAPTER は、Sample や DMBS などのアダプタ名です。たとえば、Javadoc は WLI_HOME/adapters/dbms/docs/api にインストールされます。

 

---

Ant ベースのビルド プロセス

ADK では、Ant という Java 言語のみを使用して作成した Java のビルド ツールに基づくビルド プロセスが採用されています。ADK では、Ant により以下の処理が実行されます。

• アダプタの Java アーカイブ（JAR）ファイルを作成します。

• アダプタの Web アプリケーションに対する WAR ファイルを作成します。

• J2EE 準拠アダプタの RAR ファイルを作成します。

• リスト内の他のコンポーネントをデプロイメントのために EAR ファイルにバンドルします。

Ant を使用する理由

従来、ビルド ツールはシェル ベースでした。シェル コマンドと同様に、一連の依存関係を評価し、さまざまなタスクを実行します。これらのツールには、オペレーティング システム（OS）のプログラムを使用する、または作成することによって簡単に拡張できるという利点がありますが、逆にその OS に制限されるという欠点もあります。

Ant は、以下の理由でシェルベースの作成ツールよりも優れています。

• Ant は、シェル ベース コマンドではなく Java クラスを使用して拡張されます。

• コンフィグレーション ファイルは、シェル コマンドではなく XML ベースで、さまざまなタスクが実行されるターゲット ツリーを呼び出します。各タスクは、特定のタスク インタフェースを実装するオブジェクトによって実行されます。この方法では、シェル コマンドを作成する場合に本来の表現力がある程度失われますが、その代わりにアプリケーションはプラットフォームを通じてポータブルにできます。

• Ant により、さまざまな OS固有のシェル コマンドを実行できます。

Ant の設定方法に関する詳細は、手順 2c : ビルド プロセスの設定を参照してください。

 

---

XML ツール

ADK には 2 つの XML 開発ツールから成る XML ツール キットが付属しており、設計時フレームワークのメタデータ サポート レイヤの一部とみなされています。

• XML スキーマ API −この API はスキーマ オブジェクト モデル（SOM）をベースとしており、XML スキーマを作成するときに使用されます。SOM は、構文的に複雑な XML スキーマ操作などの一般的な詳細処理の多くを抽出するツール セットで、これによって開発者はより基本的な側面に作業を集中できます。

• XML ドキュメント API −この API は IDocument をベースとしており、Document Object Model (DOM) のドキュメントに対する x-path インタフェースを提供します。

これらのツールの使用方法については、XML Toolkitを参照してください。

WebLogic Integration は、両方の API に対する Javadoc を提供します。

• SOM Javadoc を参照するには
  WLI_HOME/docs/apidocs/com/bea/schema

• IDocument Javadoc を参照するには WLI_HOME/docs/apidocs/com/bea/document