ストアード・プロシージャー・ウィザードを呼び出す「Java™ Bean の作成」を使用して、特定のストアード・プロシージャーを呼び出す Java Bean を作成することができます。
前提条件: このウィザードを使用するには、データベース・サーバーへアクセスしてオンラインにする必要があります。
- データ・パースペクティブに切り替えます。
- データ・プロジェクト・エクスプローラーまたはデータベース・エクスプローラーのいずれかにあるストアード・プロシージャー・フォルダーで、
処理したいストアード・プロシージャーを右クリックし、ポップアップ・メニューから「Java Bean の生成」を選択します。
- ウィザードの「Java クラスの指定」ページで、次のステップを完了します。
- 「ソース・フォルダー」フィールドで、Java Bean を作成するフォルダー名を入力するか、「参照」をクリックしてフォルダーを選択します。
- 「パッケージ」フィールドで、Java Bean を作成する Java パッケージの名前を入力するか、「参照」をクリックしてパッケージを選択します。 デフォルトのパッケージに新規クラスを作成するには、このフィールドを空にします。
- 「名前」フィールドで、新規クラスの名前を入力します。 Java 規則に準拠するためには、クラス名は大文字で始まる必要があります。
- ストアード・プロシージャーが結果セットを戻すかどうか指定します。 プロシージャーが結果セットを戻す場合は、次の項目の中から 1 つを生成するかどうか指定することができます。
- 結果セットの各列へより優れたアクセスを提供するヘルパー・クラス。
- 結果セットのサイズを制限する execute() メソッドのパラメーター。
このオプションを選択しない場合は、execute() メソッドはすべての行を結果セットに取り出します。
- 結果セットを記述します。 ヘルパー・クラスの生成を選択する場合は、ストアード・プロシージャーによって戻される結果セットを記述する必要があります。
このページの結果セットにある列を指定します。
- 「次へ」を選択します。
- 「ランタイム・データベース接続情報の指定」ページで、データ・ソース接続を使用するか、ドライバー・マネージャー接続を使用するかを指定します。 データ・ソースは、Java Database
Connectivity (JDBC) を実装するアプリケーション・サーバーで定義され、通常 Web アプリケーションがデータベースへ接続する場合はこちらが優先されます。これは、プール済み接続が提供されるからです。
アプリケーションが初期化されると、サーバーはデータベース接続のプールを要求します。
Web アプリケーションがデータベース接続を要求するたびに、サーバーは 1 つの接続をプールから提供します。
Web アプリケーションが接続によって完了する場合は、接続は再度プールに開放されます。
データベースへの接続はアプリケーションが実行できる操作の中で最も遅い操作の 1 つですが、このアプローチは通常、最も効率的です。
反対に、ドライバー・マネージャー接続の場合、Web アプリケーションがデータベース接続を要求するたびに、データベース・サーバーからの接続を要求します。
- データ・ソース接続: サーバー構成で定義したように、データ・ソースの Java Naming and Directory Interface (JNDI) 名を入力します。
- ドライバー・マネージャー接続: ドライバーの完全修飾クラス名を「ドライバー名」フィールドに入力し、関連付けられた JNDI アドレスを URL フィールドに入力します。例えば、DB2® の場合、COM.ibm.db2.jdbc.app.DB2Driver をドライバー名に、jdbc:db2:SAMPLE を URL に入力します。
- メソッドがユーザー認証を提供する方法を指定します。 ストアード・プロシージャーを実行するには、データベースに有効なユーザー ID とパスワードを提供する必要があります。
メソッドが有効なユーザー ID とパスワードを execute() メソッド内に提供するように指定することができます。
これは、Java Bean が常に同じユーザー ID とパスワードを使用して接続することを意味します。execute() メソッド内にユーザー ID とパスワードを含めない場合、アプリケーションはユーザー ID とパスワードを入力パラメーターとして execute() メソッドに提供する必要があります。
- メソッド内にユーザー認証を含めるには、「execute() メソッド内」をクリックします。該当するフィールドにユーザー ID とパスワードを入力してデータベースにアクセスします。
初期値は、最初に既存のデータベース・モデルをロードする際に使用した値です。
パスワードはフィールドに入力する際にマスクされます。
- パラメーターとして execute() メソッドに提供されるユーザー ID とパスワードを要求するには、「execute() メソッドの呼び出し元」をクリックします。
- 「次へ」を選択します。
- ウィザードの最終ページで、新規 Java Bean の仕様を検討し、「終了」をクリックしてウィザードを終了します。
ウィザードは Java Bean およびそれをアプリケーションでビルドし、実行し、デプロイするのに必要なすべてのデプロイメント記述子を作成します。