(外だしSQL)call()

call()

プロシージャを実行します。プロシージャ対応のParameterBean、ProcedurePmb を引数に取り、対応するプロシージャを実行します。OUTパラメータ(プロシージャリターンも含む)に対応しています。

会話上では、こーる もしくは ぷろしーじゃこーる と表現します。

実装方法

ProcedurePmbを自動生成

引数は一つだけで、Sql2Entityで自動生成した ProcedurePmb を指定します(自動生成はオプション)。 このパラメータ一つで、どのプロシージャを呼び出すか、プロシージャへ渡すパラメータ、プロシージャから受け取る値、全てを表現します。

メソッドの呼び出し

outsideSql() の後、call() を呼び出します。

e.g. 外だしSQLの一件検索の実装手順 (Eclipseでコード補完) @Java
memberBhv.o // .o と打って enter
--
memberBhv.outsideSql().ca // .ca と打って enter
--
memberBhv.outsideSql().call(pmb);
// あらかじめ補完される引数の名前に合わせておくとスムーズに

厳密には、プロシージャはテーブルとは関連付いていないため、どの Behavior を利用しても呼び出せます。しかしながら、そのプロシージャの処理としてメインとなっているテーブルの Behavior を習慣的に利用することをお奨めします。

どのプロシージャを呼び出すか

ProcedurePmb が対応するプロシージャの名前を保持しているので、指定するだけでプロシージャを呼び出せます。

e.g. プロシージャの呼び出し {SP_FOO_PROCプロシージャ} @Java
SpFooProcPmb pmb = new SpFooProcPmb();
memberBhv.outsideSql().call(pmb);

プロシージャへ渡すパラメータ

INパラメータ、INOUTパラメータを、ProcedurePmb に設定します。

e.g. INパラメータの指定 {SP_FOO_PROCプロシージャ} @Java
SpFooProcPmb pmb = new SpFooProcPmb();
pmb.setBarParam(3); // INパラメータ
memberBhv.outsideSql().call(pmb);

プロシージャから受け取る値

OUTパラメータやプロシージャリターン値を受け取る場合は、呼び出し後に ProcedurePmb インスタンスからそれら値を受け取ります。

e.g. OUTパラメータの受け取り {SP_FOO_PROCプロシージャ} @Java
SpFooProcPmb pmb = new SpFooProcPmb();
memberBhv.outsideSql().call(pmb);
String donOutParam = pmb.getDonParam(); // OUTパラメータの受け取り
Integer ret = pmb.getReturnValue(); // プロシージャリターン値の受け取り

ResultSet の受け取り

ResultSet (結果セット)を受け取る場合も、同じく ProcedurePmb のプロパティとして受け取ります。

DBMSごとの取扱い

DBMSへの依存が強い領域ですので、DBMSごとの取扱いを必ずご確認下さい。