THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
...
Anchor
この文章は Apache Geronimo アプリケーション・サーバーの持つ JDBC 機能を解説します。JDBC 機能のデモンストレーションでは、JSP、サーブレットによりウェブ関連の機能や組み込みデータベースの Derby を扱う単純な Inventory アプリケーションを利用します.
...
JDBC 機能の概略 Anchor overview
アプリケーション・サーバーへの JDBC の実装は、アプリケーション・サーバーごとに異なります。以下の表は Apache Geronimo の JDBC 機能一覧です。
Feature | Description |
|---|---|
JDBC access | Geronimo は JDBC を直接統合していませんが、総括的な J2CA フレームワークを通しての接続をサポートしています。TranQL プロジェクトは様々なデータベース用 J2CA アダプターです。 |
JCA implementation | Geronimo は JCA 1.5 仕様をサポートしています。これは JCA 1.0 仕様と下位互換です。 |
Data sources supported | TranQL は各種データソースの総括的ラッパーです。 |
Data source failover | TranQL は特定のデータベース (Apache Derby、Oracle、DB2 を含みます) 向けに特化されたドライバーを持っていますので、それらドライバーの拡張機能と密接に統合されます。 |
XA support | XA トランザクション、ローカル・トランザクション、トランザクション無しをサポートしています。 |
Connection Manager Configurability | J2CA フレームワークは異なるコネクション・フレームワークの組み込みを可能にするインターセプターを持ちます。 |
JTA implementation | トランザクションのサポートは Geronimo Specific Transaction Managing フレームワーク と HOWL により与えられます。 |
Connection pooling and management | カスタムの Geronimo コードと TranQL はコネクション・プーリングと管理に利用されます。 |
Legacy driver support | Geronimo JDBC の TranQL−コネクター を通じて Geronimo のサポートする JDBC 3.0 と 2.1 の JCA ラッパーが与えられます。 |
アプリケーションの概略 Anchor application application
この文章にある Inventory アプリケーションは、この手のアプリケーションの利用場面のうち、基本的な３つについてのみサポートします。
...
ウェブ・アプリケーションのファイルは以下のリストのとおりです。
...
...
geronimo-web.xml と web.xml ファイルによって、アプリケーションはデータソースを定義します。geronimo-web.xml は EAR ファイルに含まれ、データベース・プールへのリンクを持ちます。
...
以下に Inventory アプリケーションの web.xml を示します。データソースを作成する際に利用される geronimo-web.xml と同じ名前を利用しています。
...
geronimo-application.xml には、アプリケーションにデプロイする必要のあるデータベース・プールがあることを示します。データベース・プールは InventoryPool.xml に定義されています。また、ドライバーとして tranql-connector-ra-3.3.rar ファイルをデプロイする必要があることが記述されています。これら２つのファイルは生成された EAR ファイル内の最上位階層に置きます。
...
...
次の重要なアプリケーションの記述はソースコードから定義されたデータソースへ接続するものです。これは DBManager クラスとして扱われます。
...
...
サンプル・データベース
このサンプル・データベースは組み込みの Derby データベースを利用しています。サンプル・データベースの名前は InventoryDB で、２つの表を持ちます。ITEM 表と ITEM_MASTER 表です。それぞれの表の列は以下に記述します。
...
サンプル・アプリケーションの構成、ビルド、デプロイ Anchor configure
以下のリンクから Inventory アプリケーションをダウンロードしてください。
Inventory
...
Apache Geronimo サーバーを始動した後、 Geronimo コンソールへログインし、以下の手順により InventoryDB を作成してください。
...
...
- 左側の Console Navigation から DB Manager リンクを選択してください。
- データベース名として InventoryDB を入力し、Create ボタンをクリックしてください。
- Use DB 欄で InventoryDB を選択してください。
- テキストエディタで inventory/inventory-ear/src/main/resources ディレクトリーから InventoryDB.sql を開いてください。
- SQL Commands のテキストエリアに InventoryDB.sql の内容を貼りつけ、Run SQL ボタンを押してください。
...
- Console Navigation パネルから Deploy New を選択してください。
- Archive 入力欄に inventory フォルダーの inventory-ear-2.0-SNAPSHOT.ear を読み込んでください。
- Install ボタンを押してアプリケーションをサーバーへデプロイしてください。
Back to Top
サンプル・アプリケーションのテスト Anchor testing testing
サンプル・アプリケーションをテストするには、ブラウザーを開いて http://localhost:8080/inventory を入力してください。 Inventory アプリケーションの Welcome ページが表示され、そこには注目ボードがあります。
ユーザーは Welcome ページからアイテムの追加、物の入荷、物の出荷機能へ接続できます。
まとめ Anchor summary summary
この文章では Geronimo アプリケーション・サーバーでの JDBC 機能の利用方法を示しました。説明にしたがってサンプル・アプリケーションを順々にビルド、デプロイ、テストすればこれらの機能がよく分かります。
...