WebLogic リソースアダプタプログラマーズガイド

概要とロードマップ

以下の節では、このマニュアル『WebLogic リソースアダプタプログラマーズガイド』の内容と構成について説明します。

マニュアルの内容と対象読者

このマニュアルは、リソースアダプタのユーザ、デプロイヤ、WebLogic Server にデプロイされる J2EE リソースアダプタを含んだアプリケーションを開発するソフトウェア開発者を対象としています。また、WebLogic Server を評価するビジネスアナリストや、特定のアプリケーションで WebLogic Server リソースアダプタの使用を考えているシステム設計者にとって便利な情報も掲載されています。

このマニュアルのトピックでは、ソフトウェアプロジェクトの設計および開発段階に関連する情報を提供します。また、プロジェクトのテストおよびプロダクション前の段階で見つかるアプリケーションの問題を解決する上で便利なトピックもあります。

このマニュアルでは、プロダクション段階での管理、モニタ、パフォーマンスチューニングについては扱いません。これらのトピックに関する WebLogic Server のマニュアルとリソースへのリンクについては、「関連マニュアル」を参照してください。

このマニュアルは、J2EE およびリソースアダプタの概念に精通している読者を対象としています。リソースアダプタの開発に関する基本的なドキュメントは Sun Microsystems の J2EE コネクタアーキテクチャ仕様、バージョン 1.5 最終リリース (http://java.sun.com/j2ee/connector/) です (このマニュアルでは「J2CA 1.5 仕様」と呼びます)。リソースアダプタの開発者は J2CA 1.5 仕様について理解しておく必要があります。このマニュアルでは、WebLogic Server リソースアダプタの付加価値機能と、WebLogic Server 機能を使用してリソースアダプタを実行するための主要な情報を重点的に扱います。

このマニュアルの手引き

この節「概要とロードマップ」では、このガイドの構成を紹介します。
「リソースアダプタについて」では、J2EE コネクタアーキテクチャの BEA WebLogic Server 実装と、リソースアダプタの種類や XML スキーマについて紹介します。
「リソースアダプタの作成とコンフィグレーション」では、J2EE コネクタアーキテクチャの BEA WebLogic Server 実装を使用してリソースアダプタを作成する方法について説明します。
「プログラミングタスク」では、リソースアダプタのプログラミングタスクについて説明します。
「接続管理」では、リソースアダプタの接続管理について紹介します。
「トランザクション管理」では、リソースアダプタのトランザクション管理について紹介します。
「メッセージインフローとトランザクションインフロー」では、リソースアダプタのメッセージングインフローとトランザクションインフローについて説明します。
「セキュリティ」では、リソースアダプタのセキュリティのコンフィグレーション方法について説明します。
「リソースアダプタのパッケージ化とデプロイ」では、リソースアダプタのパッケージ化とデプロイの要件について説明し、これらのタスクを実行する手順を示します。
「weblogic-ra.xml スキーマ」は、WebLogic Server 固有のデプロイメント記述子 weblogic-ra.xml のスキーマに関する詳細なリファレンスです。
「リソースアダプタのベストプラクティス」では、リソースアダプタ開発者向けのベストプラクティスを示します。

リソースアダプタ開発者向けのサンプル

このマニュアルに加えて、ソフトウェア開発者向けにリソースアダプタのサンプルが用意されています。WebLogic Server では、任意で API コードサンプルを WL_HOME\samples\server\examples\src\examples にインストールできます。WL_HOME は、WebLogic Server の最上位インストールディレクトリです。[スタート] メニューの [WebLogic Server Examples] から、サンプルサーバを起動し、サンプルとその実行手順に関する情報を確認できます。

このリリースの WebLogic Server で提供されるリソースアダプタのサンプルは J2CA 1.5 仕様に準拠しています。独自のリソースアダプタを開発する前に、このリソースアダプタサンプルを検討および実行して理解しておくことをお勧めします。

このリリースでの新機能と変更点

このリリースの WebLogic Server での新機能、変更点、非推奨になった機能の詳細については、『リリースノート』の「WebLogic Server 9.0 の新機能」を参照してください。

リソースアダプタを含むすべての WebLogic Server API に関する、一般リリースおよびサービスパックで確認された問題の詳細については、「WebLogic Server に関する確認済みおよび解決済みの問題」を参照してください。

(非推奨) Link-Ref メカニズム

Link-Ref メカニズムは WebLogic Server リリース 8.1 で導入されました。基本アダプタを 1 つデプロイし、そのコードを、さまざまなコンフィグレーションプロパティを持つ複数の論理的なアダプタで共有できるようにするものです。現在のリリースの WebLogic Server で J2CA 1.5 仕様に基づいて開発されるリソースアダプタについては、Link-Ref メカニズムは非推奨となり、新しい J2EE ライブラリ機能で置き換えられています。ただし、J2CA 1.0 仕様に基づいて開発されたリソースアダプタについては、Link-Ref メカニズムが引き続きサポートされます。J2EE ライブラリの詳細については、『WebLogic Server アプリケーションの開発』の「Creating Shared J2EE Libraries and Optional Packages」を参照してください。1.0 リソースアダプタで Link-Ref メカニズムを使用する方法については、「(非推奨) Link-Ref メカニズムのコンフィグレーション」を参照してください。