ご使用のアプリケーションに Structured Query Language in Java™ (SQLJ) ステートメントを組み込んで、データベースでのトランザクション効率を最大化します。アプリケーションで SQLJ を利用するには、
アプリケーションをデプロイし、作成される SQLJ
プロファイルをカスタマイズする必要があります。アプリケーション・サーバーには、コンテナー管理パーシスタンスを使用するエンタープライズ
Bean のためにパーシスタンス・メカニズムとして SQLJ を使用する機能が用意されています。
アプリケーションをデプロイするには、EJB デプロイメント・ツールを使用します。
このタスクについて
EJB デプロイメント・ツールを使用して SQLJ アプリケーションをデプロイすると、スタンドアロン環境にエンタープライズ・アプリケーションをデプロイすることができます。
また、アプリケーション・サーバーでは、
コンテナー管理パーシスタンス (CMP)
を使用するアプリケーションのために SQLJ サポートが強化されています。新しい機能には、以下のものがあります。
- アプリケーション・サーバーへのアプリケーションのインストール時の CMP Bean のデプロイ
- 管理コンソールまたはスクリプトによる SQLJ プロファイルのカスタマイズおよびバインディング
- アプリケーションの再インストールが不要な SQLJ アプリケーションのカスタマイズおよびバインディングの再実行
これらの機能拡張により、コンテナー管理パーシスタンスおよび Bean 管理パーシスタンスの両方の SQLJ アプリケーションのインストール、デプロイ、
およびカスタマイズの複雑さを緩和することができます。詳しくは、
コンテナー管理パーシスタンス (CMP) を使用する SQLJ アプリケーションのデプロイに関するトピックを参照してください。
手順
- DB2® データベースに対する top-down マッピングを作成します。
- DB2 インストールから、sqlj.zip ファイルをワークステーション上のディレクトリーにコピーします。
- エンタープライズ Bean JAR プロジェクトの Java ビルド・パスを、sqlj.zip ファイルを含むように変更します。
- Rational® Application
Developer または DB2 SQLJ 変換プログラムを使用して、自動的に SQLJ を変換します。
- Rational Application
Developer を使用して以下を実行します。
- 「プロジェクト・ナビゲーター」から、とクリックします。
- マッピング・エディターで Map.mapxmi を開きます。
- 「概要」パネルで、エンタープライズ Bean の列の JAR プロジェクトの名前を強調表示します。
リストされたエンタープライズ Bean のいずれかの名前ではなく、JAR
プロジェクトの名前を強調表示する必要があります。
- 「プロパティー」パネルで「SQLJ」を展開します。
- 「Is using SQLJ?」を True に設定します。
- 「変換プログラム・モジュール (Translator Module)」を、ワークステーション上の
sqlj.zip ファイルの完全修飾パスに設定します。
- Map.mapxmi ファイルを保存します。
- エンタープライズ・アーカイブ (EAR) ファイルをエクスポートします。
- DB2
SQLJ 変換プログラムを使用します。このツールは、
後で処理を行う際に使用する .ser 拡張子を持つ .sqlj ファイルの .java 版および直列化プロファイルを作成します。
SQLJ 変換プログラム・ツールについて詳しくは、DB2 の資料を参照してください。
- EJB デプロイメント・ツールを使用して EAR ファイルをデプロイします。
- クラスパスに app_server_root/bin
ディレクトリーがあることを確認してください。
- ejbdeploy コマンド・ユーティリティーに -sqlj オプションを指定して実行します。 ejbdeploy コマンドは、ユーザーが指定する名前を使用して EAR ファイルと
application_name.ear.xml という名前の Ant スクリプトを生成します。
以下に例を示します。
ejbdeploy d:¥application_name.ear
working d:¥deployed_application_name.ear
-sqlj
-dbvendor DB2UDB_V81
-cp "C:¥PROGRA~1¥IBM¥SQLLIB¥java¥sqlj.zip"
トラブルの回避 (Avoid trouble): SQLJ 変換プログラムの sqlj.zip ファイルのロケーションを
クラスパスのオプションである -cp を使用して指定します。ejbdeploy コマンドは
システム・クラスパスからは
sqlj.zip にアクセスしません。
gotcha
- カスタマイズ用のオプションを選択します。
- アプリケーション・サーバーの SQLJ サポートを使用します。デプロイ済みアプリケーションをインストールし、
アプリケーション・サーバーまたはスクリプトを使用して SQLJ プロファイルをカスタマイズします。
- アプリケーション・サーバーにエンタープライズ・アプリケーションをインストールします。
- SQLJ プロファイルをカスタマイズします。
- 管理コンソールのサポートについては、SQLJ (Structured Query Language in Java) アプリケーション用プロファイルのカスタマイズおよびバインディングに関するトピックを参照してください。
- スクリプトのサポートについては、AdminTask オブジェクトのアプリケーション管理コマンド・グループについてのトピックを参照してください。
- db2sqljcustomize ツールを使用して SQLJ プロファイルをカスタマイズして、バインドします。
db2sqljcustomize ツールによる SQLJ プロファイルのカスタマイズおよびバインディングに関するトピックを参照してください。