T - 結果の型 @FunctionalInterfaceSE public interface CallableStatementCallback<T>
JdbcTemplate によって内部的に使用されますが、アプリケーションコードにも役立ちます。渡された CallableStatement は、フレームワークまたはカスタム CallableStatementCreator によって作成された可能性があることに注意してください。ただし、後者はほとんど必要ありません。ほとんどのカスタムコールバックアクションが更新を実行するため、標準の CallableStatement で十分です。カスタムアクションは常にパラメーター値を設定するため、CallableStatementCreator 機能も必要ありません。
JdbcTemplate.execute(String, CallableStatementCallback), JdbcTemplate.execute(CallableStatementCreator, CallableStatementCallback)| 修飾子と型 | メソッドと説明 |
|---|---|
T | doInCallableStatement(CallableStatementSE cs) アクティブな JDBC CallableStatement で JdbcTemplate.execute によって呼び出されます。 |
@Nullable T doInCallableStatement(CallableStatementSE cs) throws SQLExceptionSE, DataAccessException
JdbcTemplate.execute によって呼び出されます。ステートメントまたは接続のクローズ、またはトランザクションの処理について気にする必要はありません。これはすべて Spring の JdbcTemplate によって処理されます。 注意 : 開いた ResultSets はすべて、コールバック実装内の finally ブロックで閉じる必要があります。Spring はコールバックが返された後に Statement オブジェクトを閉じますが、これは必ずしも ResultSet リソースが閉じられることを意味するわけではありません: ステートメントオブジェクトは接続プールによってプールされる可能性があり、close 呼び出しはオブジェクトをプールに返すだけで、リソースを物理的に閉じません。
スレッドにバインドされた JDBC トランザクション（DataSourceTransactionManager によって開始された）なしで呼び出された場合、コードはトランザクションセマンティクスを使用して JDBC 接続で実行されます。JTA 対応の DataSource を使用するように JdbcTemplate が構成されている場合、JTA トランザクションがアクティブな場合、JDBC 接続とコールバックコードはトランザクションになります。
コールバック内で作成された結果オブジェクト、つまりドメインオブジェクトまたはドメインオブジェクトのコレクションを返すことができます。スローされた RuntimeException はアプリケーション例外として扱われ、テンプレートの呼び出し元に伝達されます。
cs - アクティブな JDBC CallableStatementnull SQLExceptionSE - JDBC メソッドによってスローされた場合、SQLExceptionTranslator によって DataAccessException に自動変換されます。DataAccessException - カスタム例外の場合