目次

タイトルおよび著作権情報

はじめに

• ドキュメントのアクセシビリティについて
• 表記規則

1 概要とロードマップ

• ドキュメントのスコープと対象読者
• このドキュメントの手引き
• 関連ドキュメント
• リソース・アダプタ開発者向けのサンプル
• このリリースでの新機能と変更点

2 リソース・アダプタについて

• リソース・アダプタの概要
  • WebLogic ServerとWebLogic Integrationのリソース・アダプタの比較
  • 着信、発信、および双方向のリソース・アダプタ
  • 1.0と1.5のリソース・アダプタの比較
• Java EEコネクタ・アーキテクチャ
  • Java EEアーキテクチャの図とコンポーネント
  • システム・レベル規約
• リソース・アダプタ・デプロイメント記述子

3 リソース・アダプタの作成と構成

• リソース・アダプタの作成と構成:主な手順
• 既存のリソース・アダプタの変更
• ra.xmlファイルの構成
• weblogic-ra.xmlファイルの構成
  • リソース・アダプタ・デプロイメント記述子の編集
    • 編集の考慮事項
    • スキーマ・ヘッダー情報
    • デプロイメント記述子ファイルのスキーマへの準拠
  • 動的な記述子の更新:コンソールの「構成」タブ
    • 動的な構成パラメータ
    • 動的なプール・パラメータ
    • 動的なロギング・パラメータ
  • weblogic-ra.xmlファイルの自動生成
  • (非推奨) Link-Refメカニズムの構成

4 プログラミング・タスク

• リソース・アダプタに必要なクラス
• 起動クラスとして実行するためのリソース・アダプタのプログラミング
• リソース・アダプタのアクティビティの中断と再開
• 拡張されたBootstrapContext
  • 診断コンテキストID
  • 仕分けビット
  • コールバック機能

5 接続管理

• 接続管理規約
  • 接続ファクトリと接続
  • JNDIツリーにバインドされたリソース・アダプタ
  • Connectionfactoryの取得(クライアントとJNDI間の対話)
  • 共有不可能なManagedConnectionFactoryの指定
• 発信接続の構成
  • 接続プールの構成レベル
  • 複数の発信接続の例
• 着信接続の構成
• 接続プール・パラメータの構成
  • initial-capacity : ManagedConnectionの初期数の設定
  • max-capacity : ManagedConnectionの最大数の設定
  • capacity-increment : ManagedConnectionの数の制御
  • shrinking-enabled :システム・リソースの使用量の制御
  • shrink-frequency-seconds :未使用のManagedConnectionの再利用を試みるまで待機する時間の設定
  • highest-num-waiters :接続を待機するクライアントの数の制御
  • highest-num-unavailable :使用できない接続の数の制御
  • connection-creation-retry-frequency-seconds :接続の再作成
  • match-connections-supported :接続のマッチング
  • test-frequency-seconds :接続の有効性のテスト
  • test-connections-on-create :作成時の接続のテスト
  • test-connections-on-release :接続プールへの解放時の接続のテスト
  • test-connections-on-reserve :予約時の接続のテスト
• 接続プロキシ・ラッパー - 1.0リソース・アダプタ
  • 発生する可能性のあるClassCastException
  • プロキシ生成の有効化および無効化
• 接続プールのリセット
• 接続のテスト
  • 接続のテストの構成
  • 管理コンソールでの接続のテスト

6 トランザクション管理

• サポートされているトランザクション・レベル
  • XAトランザクションのサポート
  • ローカル・トランザクションのサポート
  • トランザクション・サポートなし
• トランザクション・レベルの構成
  • XAトランザクション・リカバリの資格証明マッピングの構成

7 メッセージ・インフローとトランザクション・インフロー

• メッセージ・インフローとトランザクション・インフローの概要
  • アーキテクチャのコンポーネント
  • 着信通信のシナリオ
• メッセージ・インフローの仕組み
  • 着信メッセージの処理
  • 独自の通信チャネルとプロトコル
• メッセージ・エンド・ポイント(メッセージドリブンBean)へのメッセージ・インフロー
  • MDBとリソース・アダプタのデプロイメント時のバインド
    • MDBとリソース・アダプタのバインド
  • メッセージのディスパッチ
  • アクティブ化仕様
  • 管理対象オブジェクト
• トランザクション・インフロー
  • ローカルで管理されるトランザクションでのトランザクション・インフロー・モデルの使用
• @LongRunning

8 セキュリティ

• コンテナ管理およびアプリケーション管理によるサインオン
  • アプリケーション管理によるサインオン
  • コンテナ管理によるサインオン
• パスワード資格証明マッピング
  • 認証メカニズム
  • 資格証明マッピング
    • 非初期接続:アプリケーションのリクエストに応じて、アダプタからのManagedConnectionが必要
    • 初期接続:アプリケーションのリクエストがない場合、アダプタからのManagedConnectionが必要
    • 特殊なユーザー
  • コンソールを使用した資格証明マッピングの作成
• セキュリティ・ポリシーの処理
• リソース・アダプタのセキュリティIDの構成
  • default-principal-name :デフォルトID
  • manage-as-principal-name :管理タスク実行用のID
  • run-as-principal-name :コネクタ・コンテナからリソース・アダプタへの接続呼出しに使用されるID
  • run-work-as-principal-name :リソース・アダプタの管理タスクを実行するためのID
• 接続ファクトリに固有の認証および再認証メカニズムの構成

9 リソース・アダプタのパッケージ化とデプロイ

• リソース・アダプタのパッケージ化
  • ディレクトリ構造のパッケージ化
  • パッケージ化の考慮事項
  • パッケージ化の制限
  • リソース・アダプタ・アーカイブ(RAR)のパッケージ化
• リソース・アダプタのデプロイ
  • デプロイメント・オプション
  • リソース・アダプタのデプロイメント名
  • 本番再デプロイメント
    • Suspendableインタフェースと本番再デプロイメント
    • 本番再デプロイメントの要件
    • 本番再デプロイメントのプロセス

A weblogic-ra.xmlスキーマ

• weblogic-connector
• work-manager
• security
  • default-principal-name
  • manage-as-principal-name
  • run-as-principal-name
  • run-work-as-principal-name
• properties
• admin-objects
  • admin-object-group
    • admin-object-instance
• outbound-resource-adapter
  • default-connection-properties
    • pool-params
    • logging
  • connection-definition-group
    • connection-instance

B リソース・アダプタのベスト・プラクティス

• リソース・アダプタのクラス・ロードの最適化
• 接続の最適化
• スレッド管理
• InteractionSpecインタフェース