executeStoredProcedure()

名前とパラメーター配列を指定して SQL ストアード・プロシージャーを実行します。

構文

void executeStoredProcedure(String storedProcedure,
                    Vector storedProcParameters)
 

パラメーター

storedProcedure
データベースで実行する SQL ストアード・プロシージャーの名前。

storedProcParameters
ストアード・プロシージャーに渡されるパラメーターの Vector オブジェクト。各パラメーターは、CwDBStoredProcedureParam クラスのインスタンスです。この配列を通じてパラメーターを渡す方法の詳細については、"executeStoredProcedure() でのストアード・プロシージャーの呼び出し"を参照してください。

戻り値

なし。

例外

CwDBSQLException - データベース・エラーが発生した場合。

注記

executeStoredProcedure() メソッドは、指定した storedProcedure への呼び出しを、現行接続に関連付けられているデータベースに送信します。

このメソッドは、ストアード・プロシージャー呼び出しを準備済み SQL ステートメントとして送信します。つまり、このストアード・プロシージャー呼び出しは、最初に実行されるときにストリングとしてデータベースに送信されます。データベースは、このストリングを実行可能形式 (準備済みステートメントと呼ばれる) にコンパイルし、SQL ステートメントを実行し、この準備済みステートメントを executeStoredProcedure() に戻します。executeStoredProcedure() メソッドは、準備済みステートメントをメモリー内に保管します。

要確認:
executeStoredProcedure() を使用してストアード・プロシージャーを実行する前に、getDBConnection() メソッドを使用して BaseDLM クラスから CwDBConnection オブジェクトを作成しておく必要があります。

ストアード・プロシージャーが戻すデータを処理するには、hasMoreRows() および nextRow() メソッドを使用します。

ストアード・プロシージャーの処理は、ストアード・プロシージャーに OUT パラメーターが含まれていない 場合は、executeSQL() または executePreparedSQL() メソッドを使用して行うことも可能です。ストアード・プロシージャーが OUT パラメーターを使用する場合、executeStoredProcedure() を使用してそれを実行する必要がありますexecuteSQL() または executePreparedSQL() の場合と異なり、ストアード・プロシージャーを実行するのに全 SQL ステートメントを渡す必要はありません。executeStoredProcedure() の場合には、ストアード・プロシージャーの名前と CwDBStoredProcedureParam オブジェクトの Vector パラメーター配列のみを渡す必要があります。executeStoredProcedure() メソッドは、storedProcParameters 配列からパラメーターの数を判断し、ストアード・プロシージャーの呼び出しステートメントを構築することができます。

関連項目

"executeStoredProcedure() でのストアード・プロシージャーの呼び出し"

executePreparedSQL()executeSQL()getDBConnection()hasMoreRows()nextRow()

Copyright IBM Corp. 2004