インターフェース NamedParameterJdbcOperations
- すべての既知の実装クラス:
NamedParameterJdbcTemplate
これは、NamedParameterJdbcTemplate
によって実装される、典型的な JdbcOperations
インターフェースの代替です。このインターフェースは直接使用されることはあまりありませんが、簡単にモックまたはスタブ化できるため、テスト容易性を高める便利なオプションを提供します。
注: 6.1 では、JdbcClient
の形式で利用可能な統合 JDBC アクセスファサードがあります。JdbcClient
は、インデックス付きパラメーターまたは名前付きパラメーターを柔軟に使用して、一般的な JDBC クエリ / 更新に流れるような API スタイルを提供します。実際の実行は JdbcOperations
/NamedParameterJdbcOperations
に委譲されます。
- 導入:
- 2.0
- 作成者:
- Thomas Risberg, Juergen Hoeller
- 関連事項:
メソッドのサマリー
修飾子と型メソッド説明int[]
batchUpdate
(StringSE sql, MapSE<StringSE, ?>[] batchValues) 提供された引数のバッチで提供された SQL ステートメントを使用して、バッチを実行します。int[]
batchUpdate
(StringSE sql, SqlParameterSource[] batchArgs) 提供された引数のバッチで提供された SQL ステートメントを使用して、バッチを実行します。int[]
batchUpdate
(StringSE sql, SqlParameterSource[] batchArgs, KeyHolder generatedKeyHolder) 指定された SQL ステートメントと指定された引数のバッチを使用してバッチを実行し、生成されたキーを返します。int[]
batchUpdate
(StringSE sql, SqlParameterSource[] batchArgs, KeyHolder generatedKeyHolder, StringSE[] keyColumnNames) 指定された SQL ステートメントと指定された引数のバッチを使用してバッチを実行し、生成されたキーを返します。<T> T
execute
(StringSE sql, MapSE<StringSE, ?> paramMap, PreparedStatementCallback<T> action) JDBC PreparedStatement で動作するコールバックアクションとして実装される JDBC データアクセス操作を実行します。<T> T
execute
(StringSE sql, SqlParameterSource paramSource, PreparedStatementCallback<T> action) JDBC PreparedStatement で動作するコールバックアクションとして実装される JDBC データアクセス操作を実行します。<T> T
execute
(StringSE sql, PreparedStatementCallback<T> action) JDBC PreparedStatement で動作するコールバックアクションとして実装される JDBC データアクセス操作を実行します。クラシック Spring JdbcTemplate を公開して、クラシック JDBC 操作の呼び出しを許可します。<T> T
query
(StringSE sql, MapSE<StringSE, ?> paramMap, ResultSetExtractor<T> rse) 指定された SQL をクエリして、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、ResultSet を ResultSetExtractor で読み取ります。void
query
(StringSE sql, MapSE<StringSE, ?> paramMap, RowCallbackHandler rch) 指定された SQL にクエリを実行して、SQL から準備されたステートメントとクエリにバインドする引数のリストを作成し、RowCallbackHandler で ResultSet を行ごとに読み取ります。<T> ListSE<T>
指定された SQL をクエリして、SQL から準備されたステートメントとクエリにバインドする引数のリストを作成し、RowMapper を介して各行を Java オブジェクトにマッピングします。<T> T
query
(StringSE sql, SqlParameterSource paramSource, ResultSetExtractor<T> rse) 指定された SQL をクエリして、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、ResultSet を ResultSetExtractor で読み取ります。void
query
(StringSE sql, SqlParameterSource paramSource, RowCallbackHandler rch) 指定された SQL にクエリを実行して、SQL から準備されたステートメントとクエリにバインドする引数のリストを作成し、RowCallbackHandler で ResultSet を行ごとに読み取ります。<T> ListSE<T>
query
(StringSE sql, SqlParameterSource paramSource, RowMapper<T> rowMapper) 指定された SQL をクエリして、SQL から準備されたステートメントとクエリにバインドする引数のリストを作成し、RowMapper を介して各行を Java オブジェクトにマッピングします。<T> T
query
(StringSE sql, ResultSetExtractor<T> rse) 指定された SQL を照会して、ResultSet を ResultSetExtractor で読み取り、SQL から準備済みステートメントを作成します。void
query
(StringSE sql, RowCallbackHandler rch) 指定された SQL を照会して、RowCallbackHandler を使用して行ごとに ResultSet を読み取り、SQL から準備済みステートメントを作成します。<T> ListSE<T>
指定された SQL を照会して、SQL から準備済みステートメントを作成し、RowMapper を介して各行を Java オブジェクトにマッピングします。queryForList
(StringSE sql, MapSE<StringSE, ?> paramMap) 指定された SQL をクエリし、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果リストを期待します。<T> ListSE<T>
queryForList
(StringSE sql, MapSE<StringSE, ?> paramMap, ClassSE<T> elementType) 指定された SQL をクエリし、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果リストを期待します。queryForList
(StringSE sql, SqlParameterSource paramSource) 指定された SQL をクエリし、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果リストを期待します。<T> ListSE<T>
queryForList
(StringSE sql, SqlParameterSource paramSource, ClassSE<T> elementType) 指定された SQL をクエリし、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果リストを期待します。queryForMap
(StringSE sql, MapSE<StringSE, ?> paramMap) 指定された SQL をクエリして、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果マップを期待します。queryForMap
(StringSE sql, SqlParameterSource paramSource) 指定された SQL をクエリして、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果マップを期待します。<T> T
queryForObject
(StringSE sql, MapSE<StringSE, ?> paramMap, ClassSE<T> requiredType) 指定された SQL をクエリし、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果オブジェクトを期待します。<T> T
queryForObject
(StringSE sql, MapSE<StringSE, ?> paramMap, RowMapper<T> rowMapper) 指定された SQL をクエリして、SQL から準備されたステートメントとクエリにバインドする引数のリストを作成し、RowMapper を介して単一の結果行を Java オブジェクトにマッピングします。<T> T
queryForObject
(StringSE sql, SqlParameterSource paramSource, ClassSE<T> requiredType) 指定された SQL をクエリし、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果オブジェクトを期待します。<T> T
queryForObject
(StringSE sql, SqlParameterSource paramSource, RowMapper<T> rowMapper) 指定された SQL をクエリして、SQL から準備されたステートメントとクエリにバインドする引数のリストを作成し、RowMapper を介して単一の結果行を Java オブジェクトにマッピングします。queryForRowSet
(StringSE sql, MapSE<StringSE, ?> paramMap) 指定された SQL を照会して、SQL から準備済みステートメントを作成し、SqlRowSet を想定して、照会にバインドする引数のリストを作成します。queryForRowSet
(StringSE sql, SqlParameterSource paramSource) 指定された SQL を照会して、SQL から準備済みステートメントを作成し、SqlRowSet を想定して、照会にバインドする引数のリストを作成します。<T> StreamSE<T>
queryForStream
(StringSE sql, MapSE<StringSE, ?> paramMap, RowMapper<T> rowMapper) 指定された SQL をクエリして、SQL とクエリにバインドする引数のリストから準備済みステートメントを作成し、各行を RowMapper を介して Java オブジェクトにマッピングし、反復可能でクローズ可能なストリームに変換します。<T> StreamSE<T>
queryForStream
(StringSE sql, SqlParameterSource paramSource, RowMapper<T> rowMapper) 指定された SQL をクエリして、SQL とクエリにバインドする引数のリストから準備済みステートメントを作成し、各行を RowMapper を介して Java オブジェクトにマッピングし、反復可能でクローズ可能なストリームに変換します。int
準備されたステートメントを介して更新を発行し、指定された引数をバインドします。int
update
(StringSE sql, SqlParameterSource paramSource) 準備されたステートメントを介して更新を発行し、指定された引数をバインドします。int
update
(StringSE sql, SqlParameterSource paramSource, KeyHolder generatedKeyHolder) 準備されたステートメントを介して更新を発行し、指定された引数をバインドし、生成されたキーを返します。int
update
(StringSE sql, SqlParameterSource paramSource, KeyHolder generatedKeyHolder, StringSE[] keyColumnNames) 準備されたステートメントを介して更新を発行し、指定された引数をバインドし、生成されたキーを返します。
メソッドの詳細
getJdbcOperations
JdbcOperations getJdbcOperations()クラシック Spring JdbcTemplate を公開して、クラシック JDBC 操作の呼び出しを許可します。execute
@Nullable <T> T execute(StringSE sql, SqlParameterSource paramSource, PreparedStatementCallback<T> action) throws DataAccessException JDBC PreparedStatement で動作するコールバックアクションとして実装された JDBC データアクセス操作を実行します。これにより、Spring のマネージ JDBC 環境内で、単一のステートメントに任意のデータアクセス操作を実装できます。つまり、Spring 管理トランザクションに参加し、JDBC SQLException を Spring の DataAccessException 階層に変換します。コールバックアクションは、ドメインオブジェクトまたはドメインオブジェクトのコレクションなどの結果オブジェクトを返すことができます。
- パラメーター:
sql
- 実行する SQLparamSource
- クエリにバインドする引数のコンテナーaction
- アクションを指定するコールバックオブジェクト- 戻り値:
- アクションによって返される結果オブジェクト、または
null
- 例外:
DataAccessException
- 問題がある場合
execute
@Nullable <T> T execute(StringSE sql, MapSE<StringSE, ?> paramMap, PreparedStatementCallback<T> action) throws DataAccessExceptionJDBC PreparedStatement で動作するコールバックアクションとして実装された JDBC データアクセス操作を実行します。これにより、Spring のマネージ JDBC 環境内で、単一のステートメントに任意のデータアクセス操作を実装できます。つまり、Spring 管理トランザクションに参加し、JDBC SQLException を Spring の DataAccessException 階層に変換します。コールバックアクションは、ドメインオブジェクトまたはドメインオブジェクトのコレクションなどの結果オブジェクトを返すことができます。
- パラメーター:
sql
- 実行する SQLparamMap
- クエリにバインドするパラメーターのマップ (対応する SQL 型を推測するために PreparedStatement に任せる)action
- アクションを指定するコールバックオブジェクト- 戻り値:
- アクションによって返される結果オブジェクト、または
null
- 例外:
DataAccessException
- 問題がある場合
execute
@Nullable <T> T execute(StringSE sql, PreparedStatementCallback<T> action) throws DataAccessException JDBC PreparedStatement で動作するコールバックアクションとして実装された JDBC データアクセス操作を実行します。これにより、Spring のマネージ JDBC 環境内で、単一のステートメントに任意のデータアクセス操作を実装できます。つまり、Spring 管理トランザクションに参加し、JDBC SQLException を Spring の DataAccessException 階層に変換します。コールバックアクションは、ドメインオブジェクトまたはドメインオブジェクトのコレクションなどの結果オブジェクトを返すことができます。
- パラメーター:
sql
- 実行する SQLaction
- アクションを指定するコールバックオブジェクト- 戻り値:
- アクションによって返される結果オブジェクト、または
null
- 例外:
DataAccessException
- 問題がある場合
query
@Nullable <T> T query(StringSE sql, SqlParameterSource paramSource, ResultSetExtractor<T> rse) throws DataAccessException 指定された SQL をクエリして、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、ResultSet を ResultSetExtractor で読み取ります。- パラメーター:
sql
- 実行する SQL クエリparamSource
- クエリにバインドする引数のコンテナーrse
- 結果を抽出するオブジェクト- 戻り値:
- ResultSetExtractor によって返される任意の結果オブジェクト
- 例外:
DataAccessException
- クエリが失敗した場合
query
@Nullable <T> T query(StringSE sql, MapSE<StringSE, ?> paramMap, ResultSetExtractor<T> rse) throws DataAccessException指定された SQL をクエリして、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、ResultSet を ResultSetExtractor で読み取ります。- パラメーター:
sql
- 実行する SQL クエリparamMap
- クエリにバインドするパラメーターのマップ (対応する SQL 型を推測するために PreparedStatement に任せる)rse
- 結果を抽出するオブジェクト- 戻り値:
- ResultSetExtractor によって返される任意の結果オブジェクト
- 例外:
DataAccessException
- クエリが失敗した場合
query
指定された SQL を照会して、ResultSet を ResultSetExtractor で読み取り、SQL から準備済みステートメントを作成します。メモ: 同じ署名を持つ JdbcOperations メソッドとは対照的に、このクエリバリアントは常に PreparedStatement を使用します。これは、空のパラメーター Map を使用したクエリ呼び出しと実質的に同等です。
- パラメーター:
sql
- 実行する SQL クエリrse
- 結果を抽出するオブジェクト- 戻り値:
- ResultSetExtractor によって返される任意の結果オブジェクト
- 例外:
DataAccessException
- クエリが失敗した場合
query
void query(StringSE sql, SqlParameterSource paramSource, RowCallbackHandler rch) throws DataAccessException 指定された SQL にクエリを実行して、SQL から準備されたステートメントとクエリにバインドする引数のリストを作成し、RowCallbackHandler で ResultSet を行ごとに読み取ります。- パラメーター:
sql
- 実行する SQL クエリparamSource
- クエリにバインドする引数のコンテナーrch
- 結果を 1 行ずつ抽出するオブジェクト- 例外:
DataAccessException
- クエリが失敗した場合
query
void query(StringSE sql, MapSE<StringSE, ?> paramMap, RowCallbackHandler rch) throws DataAccessException指定された SQL にクエリを実行して、SQL から準備されたステートメントとクエリにバインドする引数のリストを作成し、RowCallbackHandler で ResultSet を行ごとに読み取ります。- パラメーター:
sql
- 実行する SQL クエリparamMap
- クエリにバインドするパラメーターのマップ (対応する SQL 型を推測するために PreparedStatement に任せる)rch
- 結果を 1 行ずつ抽出するオブジェクト- 例外:
DataAccessException
- クエリが失敗した場合
query
指定された SQL を照会して、RowCallbackHandler を使用して行ごとに ResultSet を読み取り、SQL から準備済みステートメントを作成します。メモ: 同じ署名を持つ JdbcOperations メソッドとは対照的に、このクエリバリアントは常に PreparedStatement を使用します。これは、空のパラメーター Map を使用したクエリ呼び出しと実質的に同等です。
- パラメーター:
sql
- 実行する SQL クエリrch
- 結果を 1 行ずつ抽出するオブジェクト- 例外:
DataAccessException
- クエリが失敗した場合
query
<T> ListSE<T> query(StringSE sql, SqlParameterSource paramSource, RowMapper<T> rowMapper) throws DataAccessException 指定された SQL をクエリして、SQL から準備されたステートメントとクエリにバインドする引数のリストを作成し、RowMapper を介して各行を Java オブジェクトにマッピングします。- パラメーター:
sql
- 実行する SQL クエリparamSource
- クエリにバインドする引数のコンテナーrowMapper
- 行ごとに 1 つのオブジェクトをマップするオブジェクト- 戻り値:
- マッピングされたオブジェクトを含む結果リスト
- 例外:
DataAccessException
- クエリが失敗した場合
query
<T> ListSE<T> query(StringSE sql, MapSE<StringSE, ?> paramMap, RowMapper<T> rowMapper) throws DataAccessException指定された SQL をクエリして、SQL から準備されたステートメントとクエリにバインドする引数のリストを作成し、RowMapper を介して各行を Java オブジェクトにマッピングします。- パラメーター:
sql
- 実行する SQL クエリparamMap
- クエリにバインドするパラメーターのマップ (対応する SQL 型を推測するために PreparedStatement に任せる)rowMapper
- 行ごとに 1 つのオブジェクトをマップするオブジェクト- 戻り値:
- マッピングされたオブジェクトを含む結果リスト
- 例外:
DataAccessException
- クエリが失敗した場合
query
指定された SQL を照会して、SQL から準備済みステートメントを作成し、RowMapper を介して各行を Java オブジェクトにマッピングします。メモ: 同じ署名を持つ JdbcOperations メソッドとは対照的に、このクエリバリアントは常に PreparedStatement を使用します。これは、空のパラメーター Map を使用したクエリ呼び出しと実質的に同等です。
- パラメーター:
sql
- 実行する SQL クエリrowMapper
- 行ごとに 1 つのオブジェクトをマップするオブジェクト- 戻り値:
- マッピングされたオブジェクトを含む結果リスト
- 例外:
DataAccessException
- クエリが失敗した場合
queryForStream
<T> StreamSE<T> queryForStream(StringSE sql, SqlParameterSource paramSource, RowMapper<T> rowMapper) throws DataAccessException 指定された SQL をクエリして、SQL とクエリにバインドする引数のリストから準備済みステートメントを作成し、各行を RowMapper を介して Java オブジェクトにマッピングし、反復可能でクローズ可能なストリームに変換します。- パラメーター:
sql
- 実行する SQL クエリparamSource
- クエリにバインドする引数のコンテナーrowMapper
- 行ごとに 1 つのオブジェクトをマップするオブジェクト- 戻り値:
- マップされたオブジェクトを含む結果のストリーム。完全に処理されたら閉じる必要があります (たとえば try-with-resources 句を使用)
- 例外:
DataAccessException
- クエリが失敗した場合- 導入:
- 5.3
queryForStream
<T> StreamSE<T> queryForStream(StringSE sql, MapSE<StringSE, ?> paramMap, RowMapper<T> rowMapper) throws DataAccessException指定された SQL をクエリして、SQL とクエリにバインドする引数のリストから準備済みステートメントを作成し、各行を RowMapper を介して Java オブジェクトにマッピングし、反復可能でクローズ可能なストリームに変換します。- パラメーター:
sql
- 実行する SQL クエリparamMap
- クエリにバインドするパラメーターのマップ (対応する SQL 型を推測するために PreparedStatement に任せる)rowMapper
- 行ごとに 1 つのオブジェクトをマップするオブジェクト- 戻り値:
- マップされたオブジェクトを含む結果のストリーム。完全に処理されたら閉じる必要があります (たとえば try-with-resources 句を使用)
- 例外:
DataAccessException
- クエリが失敗した場合- 導入:
- 5.3
queryForObject
@Nullable <T> T queryForObject(StringSE sql, SqlParameterSource paramSource, RowMapper<T> rowMapper) throws DataAccessException 指定された SQL をクエリして、SQL から準備されたステートメントとクエリにバインドする引数のリストを作成し、RowMapper を介して単一の結果行を Java オブジェクトにマッピングします。- パラメーター:
sql
- 実行する SQL クエリparamSource
- クエリにバインドする引数のコンテナーrowMapper
- 行ごとに 1 つのオブジェクトをマップするオブジェクト- 戻り値:
- 単一のマッピングされたオブジェクト (指定された
RowMapper
が null を返した場合、null
になることがあります) - 例外:
IncorrectResultSizeDataAccessException
- クエリが正確に 1 行を返さない場合DataAccessException
- クエリが失敗した場合
queryForObject
@Nullable <T> T queryForObject(StringSE sql, MapSE<StringSE, ?> paramMap, RowMapper<T> rowMapper) throws DataAccessException指定された SQL をクエリして、SQL から準備されたステートメントとクエリにバインドする引数のリストを作成し、RowMapper を介して単一の結果行を Java オブジェクトにマッピングします。- パラメーター:
sql
- 実行する SQL クエリparamMap
- クエリにバインドするパラメーターのマップ (対応する SQL 型を推測するために PreparedStatement に任せる)rowMapper
- 行ごとに 1 つのオブジェクトをマップするオブジェクト- 戻り値:
- 単一のマッピングされたオブジェクト (指定された
RowMapper
が null を返した場合、null
になることがあります) - 例外:
IncorrectResultSizeDataAccessException
- クエリが正確に 1 行を返さない場合DataAccessException
- クエリが失敗した場合
queryForObject
@Nullable <T> T queryForObject(StringSE sql, SqlParameterSource paramSource, ClassSE<T> requiredType) throws DataAccessException 指定された SQL をクエリし、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果オブジェクトを期待します。クエリは、単一の行 / 単一列クエリであることが期待されています。返された結果は、対応するオブジェクト型に直接マップされます。
- パラメーター:
sql
- 実行する SQL クエリparamSource
- クエリにバインドする引数のコンテナーrequiredType
- 結果オブジェクトが一致すると予想される型- 戻り値:
- 必要な型の結果オブジェクト、または SQL NULL の場合は
null
- 例外:
IncorrectResultSizeDataAccessException
- クエリが正確に 1 行を返さない場合IncorrectResultSetColumnCountException
- クエリが単一の列を含む行を返さない場合DataAccessException
- クエリが失敗した場合- 関連事項:
queryForObject
@Nullable <T> T queryForObject(StringSE sql, MapSE<StringSE, ?> paramMap, ClassSE<T> requiredType) throws DataAccessException指定された SQL をクエリし、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果オブジェクトを期待します。クエリは、単一の行 / 単一列クエリであることが期待されています。返された結果は、対応するオブジェクト型に直接マップされます。
- パラメーター:
sql
- 実行する SQL クエリparamMap
- クエリにバインドするパラメーターのマップ (対応する SQL 型を推測するために PreparedStatement に任せる)requiredType
- 結果オブジェクトが一致すると予想される型- 戻り値:
- 必要な型の結果オブジェクト、または SQL NULL の場合は
null
- 例外:
IncorrectResultSizeDataAccessException
- クエリが正確に 1 行を返さない場合IncorrectResultSetColumnCountException
- クエリが単一の列を含む行を返さない場合DataAccessException
- クエリが失敗した場合- 関連事項:
queryForMap
MapSE<StringSE,ObjectSE> queryForMap(StringSE sql, SqlParameterSource paramSource) throws DataAccessException 指定された SQL をクエリして、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果マップを期待します。クエリは単一行クエリであることが期待されています。結果行はマップにマップされます(列名をキーとして使用して、各列に 1 つのエントリ)。
- パラメーター:
sql
- 実行する SQL クエリparamSource
- クエリにバインドする引数のコンテナー- 戻り値:
- 結果マップ (列名をキーとして使用して、列ごとに 1 つのエントリ)
- 例外:
IncorrectResultSizeDataAccessException
- クエリが正確に 1 行を返さない場合DataAccessException
- クエリが失敗した場合- 関連事項:
queryForMap
MapSE<StringSE,ObjectSE> queryForMap(StringSE sql, MapSE<StringSE, ?> paramMap) throws DataAccessException指定された SQL をクエリして、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果マップを期待します。このインターフェースで定義される queryForMap() メソッドは、ドメインモデルがない場合に適しています。それ以外の場合は、queryForObject() メソッドのいずれかを使用することを検討してください。クエリは単一行クエリであることが期待されています。結果行はマップにマップされます(列名をキーとして使用して、各列に 1 つのエントリ)。
- パラメーター:
sql
- 実行する SQL クエリparamMap
- クエリにバインドするパラメーターのマップ (対応する SQL 型を推測するために PreparedStatement に任せる)- 戻り値:
- 結果マップ (列名をキーとして使用して、列ごとに 1 つのエントリ)
- 例外:
IncorrectResultSizeDataAccessException
- クエリが正確に 1 行を返さない場合DataAccessException
- クエリが失敗した場合- 関連事項:
queryForList
<T> ListSE<T> queryForList(StringSE sql, SqlParameterSource paramSource, ClassSE<T> elementType) throws DataAccessException 指定された SQL をクエリし、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果リストを期待します。結果は、結果オブジェクトのリスト(各行に 1 つのエントリ)にマップされ、各オブジェクトは指定された要素型に一致します。
- パラメーター:
sql
- 実行する SQL クエリparamSource
- クエリにバインドする引数のコンテナーelementType
- 結果リスト内の必須型の要素 (たとえば、Integer.class
)- 戻り値:
- 指定された要素型に一致するオブジェクトのリスト
- 例外:
DataAccessException
- クエリが失敗した場合- 関連事項:
queryForList
<T> ListSE<T> queryForList(StringSE sql, MapSE<StringSE, ?> paramMap, ClassSE<T> elementType) throws DataAccessException指定された SQL をクエリし、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果リストを期待します。結果は、結果オブジェクトのリスト(各行に 1 つのエントリ)にマップされ、各オブジェクトは指定された要素型に一致します。
- パラメーター:
sql
- 実行する SQL クエリparamMap
- クエリにバインドするパラメーターのマップ (対応する SQL 型を推測するために PreparedStatement に任せる)elementType
- 結果リスト内の必須型の要素 (たとえば、Integer.class
)- 戻り値:
- 指定された要素型に一致するオブジェクトのリスト
- 例外:
DataAccessException
- クエリが失敗した場合- 関連事項:
queryForList
ListSE<MapSE<StringSE,ObjectSE>> queryForList(StringSE sql, SqlParameterSource paramSource) throws DataAccessException 指定された SQL をクエリし、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果リストを期待します。結果は、マップのリスト(行ごとに 1 つのエントリ)にマップされます(列名をキーとして使用して、列ごとに 1 つのエントリ)。リスト内の各要素は、このインターフェースの
queryForMap
メソッドによって返される形式になります。- パラメーター:
sql
- 実行する SQL クエリparamSource
- クエリにバインドする引数のコンテナー- 戻り値:
- 行ごとにマップを含むリスト
- 例外:
DataAccessException
- クエリが失敗した場合- 関連事項:
queryForList
ListSE<MapSE<StringSE,ObjectSE>> queryForList(StringSE sql, MapSE<StringSE, ?> paramMap) throws DataAccessException指定された SQL をクエリし、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果リストを期待します。結果は、マップのリスト(行ごとに 1 つのエントリ)にマップされます(列名をキーとして使用して、列ごとに 1 つのエントリ)。リスト内の各要素は、このインターフェースの
queryForMap
メソッドによって返される形式になります。- パラメーター:
sql
- 実行する SQL クエリparamMap
- クエリにバインドするパラメーターのマップ (対応する SQL 型を推測するために PreparedStatement に任せる)- 戻り値:
- 行ごとにマップを含むリスト
- 例外:
DataAccessException
- クエリが失敗した場合- 関連事項:
queryForRowSet
指定された SQL を照会して、SQL から準備済みステートメントを作成し、SqlRowSet を想定して、照会にバインドする引数のリストを作成します。結果は SqlRowSet にマップされ、切断された方法でデータを保持します。このラッパーは、スローされた SQLException を変換します。
デフォルトの実装では、JDBC RowSet サポートが実行時に使用可能である必要があることに注意してください。デフォルトでは、Sun の
com.sun.rowset.CachedRowSetImpl
クラスが使用されます。これは、JDK 1.5 + の一部であり、Sun の JDBC RowSet 実装のダウンロード(rowset.jar)の一部として個別に入手することもできます。- パラメーター:
sql
- 実行する SQL クエリparamSource
- クエリにバインドする引数のコンテナー- 戻り値:
- SqlRowSet 表現 (おそらく
javax.sql.rowset.CachedRowSet
のラッパー) - 例外:
DataAccessException
- クエリの実行に問題がある場合- 関連事項:
queryForRowSet
指定された SQL を照会して、SQL から準備済みステートメントを作成し、SqlRowSet を想定して、照会にバインドする引数のリストを作成します。結果は SqlRowSet にマップされ、切断された方法でデータを保持します。このラッパーは、スローされた SQLException を変換します。
デフォルトの実装では、JDBC RowSet サポートが実行時に使用可能である必要があることに注意してください。デフォルトでは、Sun の
com.sun.rowset.CachedRowSetImpl
クラスが使用されます。これは、JDK 1.5 + の一部であり、Sun の JDBC RowSet 実装のダウンロード(rowset.jar)の一部として個別に入手することもできます。- パラメーター:
sql
- 実行する SQL クエリparamMap
- クエリにバインドするパラメーターのマップ (対応する SQL 型を推測するために PreparedStatement に任せる)- 戻り値:
- SqlRowSet 表現 (おそらく
javax.sql.rowset.CachedRowSet
のラッパー) - 例外:
DataAccessException
- クエリの実行に問題がある場合- 関連事項:
update
準備されたステートメントを介して更新を発行し、指定された引数をバインドします。- パラメーター:
sql
- 名前付きパラメーターを含む SQLparamSource
- クエリにバインドする引数と SQL 型のコンテナー- 戻り値:
- 影響を受ける行の数
- 例外:
DataAccessException
- 更新の発行に問題がある場合
update
準備されたステートメントを介して更新を発行し、指定された引数をバインドします。- パラメーター:
sql
- 名前付きパラメーターを含む SQLparamMap
- クエリにバインドするパラメーターのマップ (対応する SQL 型を推測するために PreparedStatement に任せる)- 戻り値:
- 影響を受ける行の数
- 例外:
DataAccessException
- 更新の発行に問題がある場合
update
int update(StringSE sql, SqlParameterSource paramSource, KeyHolder generatedKeyHolder) throws DataAccessException 準備されたステートメントを介して更新を発行し、指定された引数をバインドし、生成されたキーを返します。この方法では、JDBC ドライバーで生成されたキーのサポートが必要です。
- パラメーター:
sql
- 名前付きパラメーターを含む SQLparamSource
- クエリにバインドする引数と SQL 型のコンテナーgeneratedKeyHolder
- 生成されたキーを保持するKeyHolder
- 戻り値:
- 影響を受ける行の数
- 例外:
DataAccessException
- 更新の発行に問題がある場合- 関連事項:
update
int update(StringSE sql, SqlParameterSource paramSource, KeyHolder generatedKeyHolder, StringSE[] keyColumnNames) throws DataAccessException 準備されたステートメントを介して更新を発行し、指定された引数をバインドし、生成されたキーを返します。この方法では、JDBC ドライバーで生成されたキーのサポートが必要です。
- パラメーター:
sql
- 名前付きパラメーターを含む SQLparamSource
- クエリにバインドする引数と SQL 型のコンテナーgeneratedKeyHolder
- 生成されたキーを保持するKeyHolder
keyColumnNames
- キーが生成される列の名前- 戻り値:
- 影響を受ける行の数
- 例外:
DataAccessException
- 更新の発行に問題がある場合- 関連事項:
batchUpdate
提供された引数のバッチで提供された SQL ステートメントを使用して、バッチを実行します。- パラメーター:
sql
- 実行する SQL ステートメントbatchArgs
- クエリの引数のバッチを含むSqlParameterSource
の配列- 戻り値:
- バッチ内の各更新によって影響を受ける行の数を含む配列 (
Statement.SUCCESS_NO_INFO
SE/Statement.EXECUTE_FAILED
SE などの影響を受ける行に対して特別な JDBC 定義の負の値が含まれる場合もあります) - 例外:
DataAccessException
- 更新の発行に問題がある場合
batchUpdate
提供された引数のバッチで提供された SQL ステートメントを使用して、バッチを実行します。- パラメーター:
sql
- 実行する SQL ステートメントbatchValues
- クエリの引数のバッチを含むマップの配列- 戻り値:
- バッチ内の各更新によって影響を受ける行の数を含む配列 (
Statement.SUCCESS_NO_INFO
SE/Statement.EXECUTE_FAILED
SE などの影響を受ける行に対して特別な JDBC 定義の負の値が含まれる場合もあります) - 例外:
DataAccessException
- 更新の発行に問題がある場合
batchUpdate
指定された SQL ステートメントと指定された引数のバッチを使用してバッチを実行し、生成されたキーを返します。この方法では、JDBC ドライバーで生成されたキーのサポートが必要です。
- パラメーター:
sql
- 実行する SQL ステートメントbatchArgs
- クエリの引数のバッチを含むSqlParameterSource
の配列generatedKeyHolder
- 生成されたキーを保持するKeyHolder
- 戻り値:
- バッチ内の各更新によって影響を受ける行の数を含む配列 (
Statement.SUCCESS_NO_INFO
SE/Statement.EXECUTE_FAILED
SE などの影響を受ける行に対して特別な JDBC 定義の負の値が含まれる場合もあります) - 例外:
DataAccessException
- 更新の発行に問題がある場合- 導入:
- 6.1
- 関連事項:
batchUpdate
int[] batchUpdate(StringSE sql, SqlParameterSource[] batchArgs, KeyHolder generatedKeyHolder, StringSE[] keyColumnNames) 指定された SQL ステートメントと指定された引数のバッチを使用してバッチを実行し、生成されたキーを返します。この方法では、JDBC ドライバーで生成されたキーのサポートが必要です。
- パラメーター:
sql
- 実行する SQL ステートメントbatchArgs
- クエリの引数のバッチを含むSqlParameterSource
の配列generatedKeyHolder
- 生成されたキーを保持するKeyHolder
keyColumnNames
- キーが生成される列の名前- 戻り値:
- バッチ内の各更新によって影響を受ける行の数を含む配列 (
Statement.SUCCESS_NO_INFO
SE/Statement.EXECUTE_FAILED
SE などの影響を受ける行に対して特別な JDBC 定義の負の値が含まれる場合もあります) - 例外:
DataAccessException
- 更新の発行に問題がある場合- 導入:
- 6.1
- 関連事項: