> アダプタの開発

アダプタの開発

     前  次    目次     
ここから内容

ADK の概要

この節の目的

ADK とは

アダプタ開発の要件

ADK の機能

アダプタとは

ResourceAdapter インタフェース

サービス接続

イベント接続

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

設計時 GUI

アプリケーション ビュー

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

始める前に

開発の基本概念

実行時と設計時

実行時フレームワーク

設計時フレームワーク

イベントとサービス

イベントとは

サービスとは

アダプタによるロギングの使い方

ロギング ツールキット

ロギング フレームワーク

インターナショナライゼーションとローカライゼーション

アダプタ論理名

アダプタ論理名の使用場所

アダプタ デプロイメントでアダプタ論理名を使用する

アダプタ論理名を構成基準として使用する

getAdapterLogicalName の戻り値として使用されるアダプタ論理名

エンタープライズ アーカイブ (EAR) ファイル

開発ツール

サンプル アダプタ

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

サンプル アダプタとは

GenerateAdapterTemplate ユーティリティ

ADK Javadoc

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

Ant の使用目的

XML ツール

カスタム開発環境の作成

アダプタ設定ワークシート

GenerateAdapterTemplate の使い方

手順 1 : GenerateAdapterTemplate の実行

手順 2 : ツリーの再構築

手順 3 : アダプタのテスト

手順 4 : WebLogic Integration へのアダプタのデプロイ

ロギング ツールキットの使い方

ロギング ツールキット

ロギング コンフィグレーション ファイル

ロギングの概念

メッセージ カテゴリ

メッセージ優先度

カテゴリへの優先度の割り当て

メッセージ アペンダ

メッセージ レイアウト

コンポーネントの結合

ロギングの設定方法

ロギング フレームワークのクラス

com.bea.logging.ILogger

com.bea.logging.LogContext

com.bea.logging.LogManager

ログ メッセージのインターナショナライゼーションとローカライゼーション

マルチスレッド コンポーネントでのコンテキスト情報の保存

サービス アダプタの開発

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

実行時環境のサービス接続

イベント フロー

手順 1 : 環境要件の調査

手順 2 : 開発環境のコンフィグレーション

手順 2a : ディレクトリ構造の設定

web.xml および weblogic.xml 記述子ファイル

ディレクトリ構造内での開発ツリーの作成

手順 2b : アダプタ論理名の割り当て

手順 2c : ビルド プロセスの設定

マニフェスト ファイル

build.xml のコンポーネント

手順 2d : メッセージ バンドルの作成

手順 3 : SPI の実装

基本的な SPI の実装

ManagedConnectionFactory

トランザクションの境界設定

XA 準拠トランザクション

ローカル トランザクション

ADK の実装

createConnectionFactory()

createManagedConnection()

checkState()

equals()

hashCode()

matchManagedConnections()

実装の説明

デプロイメント時に必要な AbstractManagedConnectionFactory プロパティ

ADK のその他の主要な ManagedConnectionFactory 機能

ManagedConnection

ADK の実装

ManagedConnectionMetaData

ADK の実装

ConnectionEventListener

ADK の実装

ConnectionManager

ADK の実装

ConnectionRequestInfo

ADK の実装

LocalTransaction

ADK の実装

手順 4 : CCI の実装

この節の利用方法

基本的な CCI の実装

Connection

ADK の実装

Interaction

ADK の実装

execute() バージョン 1

execute() バージョン 2

XCCI を使用した CCI の実装

サービス

DocumentRecord

IDocument

IDocument インスタンスでのネームスペースの適切な使い方

ADK に付属の XCCI クラス

AbstractDocumentRecordInteraction

DocumentDefinitionRecord

DocumentInteractionSpecImpl

XCCI の設計パターン

非 XML J2EE 準拠アダプタの使用

ConnectionFactory

ADK の実装

ConnectionMetaData

ADK の実装

ConnectionSpec

ADK の実装

InteractionSpec

ADK の実装

LocalTransaction

Record

ADK の実装

ResourceAdapterMetaData

ADK の実装

手順 5 : 環境変数のサポートの有効化 (省略可能)

ClientDataInteractionSpec の実装

DocumentInteractionSpecImpl の拡張

手順 6 : アダプタのテスト

テスト ハーネスの使い方

ADK に付属のテスト ケース拡張

sample.spi.NonManagedScenarioTestCase

sample.event.OfflineEventGeneratorTestCase

sample.client.ApplicationViewClient

手順 7 : アダプタのデプロイ

イベント アダプタの開発

イベント接続の概要

実行時環境のイベント アダプタ

イベント フロー

手順 1 : アダプタの定義

手順 2 : 開発環境のコンフィグレーション

手順 2a : ファイル構造の設定

手順 2b : アダプタへの論理名の割り当て

手順 2c : ビルド プロセスの設定

手順 2d : メッセージ バンドルの作成

手順 2e : ロギングのコンフィグレーション

イベント生成のロギング カテゴリの作成

手順 3 : アダプタの実装

手順 3a : イベント ジェネレータの作成

データ抽出メカニズムの実装方法

Pull モード

Push モード

イベント ジェネレータの実装方法

EventGenerator のサンプル

新しいイベント タイプを追加する

アンデプロイされたアプリケーション ビューのイベント タイプの削除

リソースの削除

手順 3b : データ トランスフォーメーション メソッドの実装

手順 3c : サスペンド/再開サポートの実装

手順 3d : イベント ジェネレータおよび EIS ステータス レポートの実装

手順 3e : イベント ジェネレータのインスタンス サポートの実装

例 : DBMS サンプル アダプタ

イベント ジェネレータのインスタンス サポートを実装する目的

イベント ジェネレータのインスタンス仕様の変更の検出および応答

手順 3f : 環境変数サポートの実装

手順 4 : アダプタのテスト

手順 5 : アダプタのデプロイ

リソース アダプタの開発

リソース アダプタの概要

実行時環境のリソース アダプタ

手順 1 : アダプタの定義

手順 2 : 開発環境のコンフィグレーション

手順 2a : ファイル構造の設定

手順 2b : アダプタへの論理名の割り当て

手順 2c : ビルド プロセスの設定

手順 2d : メッセージ バンドルの作成

手順 2e : ロギングのコンフィグレーション

イベント生成のロギング カテゴリの作成

手順 3 : アダプタの実装

手順 3a : リソース アダプタの作成

手順 3b : リソース アダプタのプロパティの実装

手順 4 : イベントおよびサービス アダプタの実装

手順 5 : アダプタのデプロイ

設計時 GUI の開発

設計時フォーム処理の概要

フォーム処理クラス

RequestHandler

ControllerServlet

ActionResult

Word およびその子孫

AbstractInputTagSupport およびその子孫

送信タグ

フォーム処理のシーケンス

前提条件

シーケンスの手順

設計時 GUI の機能

Java Server Page

JSP テンプレート

JSP タグの ADK ライブラリ

JSP タグの属性

アプリケーション ビュー

ファイル構造

イベント フロー

手順 1 : 設計時 GUI の要件の定義

手順 2 : ページ フローの定義

ページ 1 : ログイン

ページ 2 : アプリケーション ビューの管理

ページ 3 : 新規アプリケーション ビューの定義

ページ 4 : 接続のコンフィグレーション

ページ 5 : アプリケーション ビューの管理

ページ 6 : イベントの追加

ページ 7 : サービスの追加

ページ 8 : アプリケーション ビューのテスト

アプリケーション ビューのパブリッシュ

アプリケーション ビューの保存

ページ 9 : アプリケーション ビューの概要

手順 3 : 開発環境のコンフィグレーション

手順 3a : メッセージ バンドルの作成

手順 3b : WebLogic Server を再起動せずに JSP を更新する環境のコンフィグレーション

手順 4 : 設計時 GUI の実装

AbstractDesignTimeRequestHandler の拡張

インクルードするメソッド

手順 4a : ManagedConnectionFactory クラスの指定

手順 4b : initServiceDescriptor() の実装

手順 4c : initEventDescriptor() の実装

手順 5 : HTML フォームの記述

手順 5a : confconn.jsp フォームの作成

ADK タグ ライブラリのインクルード

ControllerServlet のポスト

フォーム フィールドのラベル表示

テキスト フィールド サイズの表示

フォームの送信ボタンの表示

confconn() の実装

手順 5b : addevent.jsp フォームの作成

ADK タグ ライブラリのインクルード

ControllerServlet のポスト

フォーム フィールドのラベル表示

テキスト フィールド サイズの表示

フォームの送信ボタンの表示

その他のフィールドの追加

手順 5c : addservc.jsp フォームの作成

ADK タグ ライブラリのインクルード

ControllerServlet のポスト

フォーム フィールドのラベル表示

テキスト フィールド サイズの表示

フォームの送信ボタンの表示

その他のフィールドの追加

手順 5d : イベントおよびサービスの編集機能の実装 (省略可能)

アダプタ プロパティ ファイルの更新

edtservc.jsp および addservc.jsp の作成

メソッドの実装

手順 5e : Web アプリケーション デプロイメント記述子の記述

手順 6 : ルック アンド フィールの実装

手順 7 : 環境変数の実装

手順 7a : 変数セットの表示および編集

手順 7b : 変数セットの使用

手順 8 : サンプル アダプタの設計時インタフェースのテスト

ファイルおよびクラス

テストの実行

アダプタのデプロイ

エンタープライズ アーカイブ (EAR) ファイルの使用

EAR ファイルでの共有 JAR ファイルの使い方

EAR ファイルのデプロイメント記述子

WebLogic Server Administration Console を使用したアダプタのデプロイ

アダプタの自動登録

命名規約の使い方

テキスト ファイルの使い方

Web アプリケーション デプロイメント記述子の編集

デプロイメント パラメータ

デプロイメント記述子の編集

WebLogic Integrator クラスタでのアダプタのデプロイメント

アダプタ インスタンスの再デプロイ

WebLogic Integration に限定されないアダプタの作成

この節の使い方

アダプタの構築

ビルド プロセスの更新

XML ツールキット

ツールキットのパッケージ

IDocument

SOM (Schema Object Model)

SOM の仕組み

スキーマの作成

作成されるスキーマ

XML ドキュメントの検証

ドキュメントの検証方法

isValid() の実装

isValid() の実装のサンプル

アダプタ設定ワークシート

アダプタ設定ワークシート

アダプタを WebLogic Integration 8.1 にアップグレードする

DBMS サンプル アダプタを使用したアダプタ開発方法の学習

DBMS サンプル アダプタの概要

DBMS サンプル アダプタの接続パラメータ

DBMS サンプル アダプタの仕組み

始める前に

DBMS サンプル アダプタへのアクセス

DBMS サンプル アダプタのツアー

DBMS サンプル アダプタの開発工程

手順 1 : DBMS サンプル アダプタについて

手順 2 : 環境の定義

手順 3 : サービス プロバイダ インタフェース パッケージの実装

ManagedConnectionFactoryImpl

基本的な実装

開発者のコメント

ManagedConnectionImpl

基本的な実装

開発者のコメント

ConnectionMetaDataImpl

基本的な実装

開発者のコメント

LocalTransactionImpl

基本的な実装

開発者のコメント

手順 4 : Common Client Interface パッケージの実装

ConnectionImpl

基本的な実装

開発者のコメント

InteractionImpl

基本的な実装

開発者のコメント

InteractionSpecImpl

基本的な実装

開発者のコメント

手順 5 : イベント パッケージの実装

EventGenerator

基本的な実装

開発者のコメント

手順 6 : DBMS サンプル アダプタのデプロイ

手順 6a : 環境の設定

手順 6b : ra.xml ファイルの更新

手順 6c : RAR ファイルの作成

手順 6d : JAR および EAR ファイルの作成

手順 6e : EAR ファイルの作成とデプロイ

データベース固有のエラー メッセージ

DBMS サンプル アダプタ設計時 GUI の開発工程

手順 1 : 要件の識別

手順 2 : 必要な Java Server Page の識別

手順 3 : メッセージ バンドルの作成

手順 4 : 設計時 GUI の実装

手順 5 : Java Server Page の記述

カスタム JSP タグの使用

オブジェクトの状態の保存

WEB-INF/web.xml デプロイメント記述子の記述

実行時の考慮事項

イベント接続の変更

複数のアプリケーション ビューで使用される DBMS サンプル アダプタ インスタンスの管理

同一 DBMS インスタンスを使用する複数のイベント ジェネレータ


  ページの先頭       前  次