インターフェース NamedParameterJdbcOperations

すべての既知の実装クラス:
NamedParameterJdbcTemplate

public interface NamedParameterJdbcOperations
従来の "?" ではなく名前付きパラメーターの使用を許可する JDBC 操作の基本セットを指定するインターフェースプレースホルダー。

これは、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[]
    提供された引数のバッチで提供された SQL ステートメントを使用して、バッチを実行します。
    int[]
    batchUpdate(StringSE sql, SqlParameterSource[] batchArgs, KeyHolder generatedKeyHolder)
    指定された SQL ステートメントと指定された引数のバッチを使用してバッチを実行し、生成されたキーを返します。
    int[]
    batchUpdate(StringSE sql, SqlParameterSource[] batchArgs, KeyHolder generatedKeyHolder, StringSE[] keyColumnNames)
    指定された SQL ステートメントと指定された引数のバッチを使用してバッチを実行し、生成されたキーを返します。
    <T> T
    JDBC PreparedStatement で動作するコールバックアクションとして実装される JDBC データアクセス操作を実行します。
    <T> T
    JDBC PreparedStatement で動作するコールバックアクションとして実装される JDBC データアクセス操作を実行します。
    <T> T
    JDBC PreparedStatement で動作するコールバックアクションとして実装される JDBC データアクセス操作を実行します。
    クラシック Spring JdbcTemplate を公開して、クラシック JDBC 操作の呼び出しを許可します。
    <T> T
    query(StringSE sql, MapSE<StringSE,?> paramMap, ResultSetExtractor<T> rse)
    指定された SQL をクエリして、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、ResultSet を ResultSetExtractor で読み取ります。
    void
    指定された SQL にクエリを実行して、SQL から準備されたステートメントとクエリにバインドする引数のリストを作成し、RowCallbackHandler で ResultSet を行ごとに読み取ります。
    <T> ListSE<T>
    query(StringSE sql, MapSE<StringSE,?> paramMap, RowMapper<T> rowMapper)
    指定された SQL をクエリして、SQL から準備されたステートメントとクエリにバインドする引数のリストを作成し、RowMapper を介して各行を Java オブジェクトにマッピングします。
    <T> T
    指定された SQL をクエリして、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、ResultSet を ResultSetExtractor で読み取ります。
    void
    指定された SQL にクエリを実行して、SQL から準備されたステートメントとクエリにバインドする引数のリストを作成し、RowCallbackHandler で ResultSet を行ごとに読み取ります。
    <T> ListSE<T>
    query(StringSE sql, SqlParameterSource paramSource, RowMapper<T> rowMapper)
    指定された SQL をクエリして、SQL から準備されたステートメントとクエリにバインドする引数のリストを作成し、RowMapper を介して各行を Java オブジェクトにマッピングします。
    <T> T
    指定された SQL を照会して、ResultSet を ResultSetExtractor で読み取り、SQL から準備済みステートメントを作成します。
    void
    指定された SQL を照会して、RowCallbackHandler を使用して行ごとに ResultSet を読み取り、SQL から準備済みステートメントを作成します。
    <T> ListSE<T>
    query(StringSE sql, RowMapper<T> rowMapper)
    指定された SQL を照会して、SQL から準備済みステートメントを作成し、RowMapper を介して各行を Java オブジェクトにマッピングします。
    指定された SQL をクエリし、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果リストを期待します。
    <T> ListSE<T>
    queryForList(StringSE sql, MapSE<StringSE,?> paramMap, ClassSE<T> elementType)
    指定された SQL をクエリし、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果リストを期待します。
    指定された SQL をクエリし、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果リストを期待します。
    <T> ListSE<T>
    queryForList(StringSE sql, SqlParameterSource paramSource, ClassSE<T> elementType)
    指定された SQL をクエリし、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果リストを期待します。
    指定された SQL をクエリして、SQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果マップを期待します。
    指定された 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 オブジェクトにマッピングします。
    指定された SQL を照会して、SQL から準備済みステートメントを作成し、SqlRowSet を想定して、照会にバインドする引数のリストを作成します。
    指定された 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
    update(StringSE sql, MapSE<StringSE,?> paramMap)
    準備されたステートメントを介して更新を発行し、指定された引数をバインドします。
    int
    準備されたステートメントを介して更新を発行し、指定された引数をバインドします。
    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 - 実行する SQL
      paramSource - クエリにバインドする引数のコンテナー
      action - アクションを指定するコールバックオブジェクト
      戻り値:
      アクションによって返される結果オブジェクト、または null
      例外:
      DataAccessException - 問題がある場合
    • execute

      @Nullable <T> T execute(StringSE sql, MapSE<StringSE,?> paramMap, PreparedStatementCallback<T> action) throws DataAccessException
      JDBC PreparedStatement で動作するコールバックアクションとして実装された JDBC データアクセス操作を実行します。これにより、Spring のマネージ JDBC 環境内で、単一のステートメントに任意のデータアクセス操作を実装できます。つまり、Spring 管理トランザクションに参加し、JDBC SQLException を Spring の DataAccessException 階層に変換します。

      コールバックアクションは、ドメインオブジェクトまたはドメインオブジェクトのコレクションなどの結果オブジェクトを返すことができます。

      パラメーター:
      sql - 実行する SQL
      paramMap - クエリにバインドするパラメーターのマップ (対応する 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 - 実行する SQL
      action - アクションを指定するコールバックオブジェクト
      戻り値:
      アクションによって返される結果オブジェクト、または 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

      @Nullable <T> T query(StringSE sql, ResultSetExtractor<T> rse) throws DataAccessException
      指定された 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

      void query(StringSE sql, RowCallbackHandler rch) throws DataAccessException
      指定された 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

      <T> ListSE<T> query(StringSE sql, RowMapper<T> rowMapper) throws DataAccessException
      指定された 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

      SqlRowSet queryForRowSet(StringSE sql, SqlParameterSource paramSource) throws DataAccessException
      指定された 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

      SqlRowSet queryForRowSet(StringSE sql, MapSE<StringSE,?> paramMap) throws DataAccessException
      指定された 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

      int update(StringSE sql, SqlParameterSource paramSource) throws DataAccessException
      準備されたステートメントを介して更新を発行し、指定された引数をバインドします。
      パラメーター:
      sql - 名前付きパラメーターを含む SQL
      paramSource - クエリにバインドする引数と SQL 型のコンテナー
      戻り値:
      影響を受ける行の数
      例外:
      DataAccessException - 更新の発行に問題がある場合
    • update

      int update(StringSE sql, MapSE<StringSE,?> paramMap) throws DataAccessException
      準備されたステートメントを介して更新を発行し、指定された引数をバインドします。
      パラメーター:
      sql - 名前付きパラメーターを含む SQL
      paramMap - クエリにバインドするパラメーターのマップ (対応する SQL 型を推測するために PreparedStatement に任せる)
      戻り値:
      影響を受ける行の数
      例外:
      DataAccessException - 更新の発行に問題がある場合
    • update

      int update(StringSE sql, SqlParameterSource paramSource, KeyHolder generatedKeyHolder) throws DataAccessException
      準備されたステートメントを介して更新を発行し、指定された引数をバインドし、生成されたキーを返します。

      この方法では、JDBC ドライバーで生成されたキーのサポートが必要です。

      パラメーター:
      sql - 名前付きパラメーターを含む SQL
      paramSource - クエリにバインドする引数と SQL 型のコンテナー
      generatedKeyHolder - 生成されたキーを保持する KeyHolder
      戻り値:
      影響を受ける行の数
      例外:
      DataAccessException - 更新の発行に問題がある場合
      関連事項:
    • update

      int update(StringSE sql, SqlParameterSource paramSource, KeyHolder generatedKeyHolder, StringSE[] keyColumnNames) throws DataAccessException
      準備されたステートメントを介して更新を発行し、指定された引数をバインドし、生成されたキーを返します。

      この方法では、JDBC ドライバーで生成されたキーのサポートが必要です。

      パラメーター:
      sql - 名前付きパラメーターを含む SQL
      paramSource - クエリにバインドする引数と SQL 型のコンテナー
      generatedKeyHolder - 生成されたキーを保持する KeyHolder
      keyColumnNames - キーが生成される列の名前
      戻り値:
      影響を受ける行の数
      例外:
      DataAccessException - 更新の発行に問題がある場合
      関連事項:
    • batchUpdate

      int[] batchUpdate(StringSE sql, SqlParameterSource[] batchArgs)
      提供された引数のバッチで提供された SQL ステートメントを使用して、バッチを実行します。
      パラメーター:
      sql - 実行する SQL ステートメント
      batchArgs - クエリの引数のバッチを含む SqlParameterSource の配列
      戻り値:
      バッチ内の各更新によって影響を受ける行の数を含む配列 (Statement.SUCCESS_NO_INFOSE/Statement.EXECUTE_FAILEDSE などの影響を受ける行に対して特別な JDBC 定義の負の値が含まれる場合もあります)
      例外:
      DataAccessException - 更新の発行に問題がある場合
    • batchUpdate

      int[] batchUpdate(StringSE sql, MapSE<StringSE,?>[] batchValues)
      提供された引数のバッチで提供された SQL ステートメントを使用して、バッチを実行します。
      パラメーター:
      sql - 実行する SQL ステートメント
      batchValues - クエリの引数のバッチを含むマップの配列
      戻り値:
      バッチ内の各更新によって影響を受ける行の数を含む配列 (Statement.SUCCESS_NO_INFOSE/Statement.EXECUTE_FAILEDSE などの影響を受ける行に対して特別な JDBC 定義の負の値が含まれる場合もあります)
      例外:
      DataAccessException - 更新の発行に問題がある場合
    • batchUpdate

      int[] batchUpdate(StringSE sql, SqlParameterSource[] batchArgs, KeyHolder generatedKeyHolder)
      指定された SQL ステートメントと指定された引数のバッチを使用してバッチを実行し、生成されたキーを返します。

      この方法では、JDBC ドライバーで生成されたキーのサポートが必要です。

      パラメーター:
      sql - 実行する SQL ステートメント
      batchArgs - クエリの引数のバッチを含む SqlParameterSource の配列
      generatedKeyHolder - 生成されたキーを保持する KeyHolder
      戻り値:
      バッチ内の各更新によって影響を受ける行の数を含む配列 (Statement.SUCCESS_NO_INFOSE/Statement.EXECUTE_FAILEDSE などの影響を受ける行に対して特別な 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_INFOSE/Statement.EXECUTE_FAILEDSE などの影響を受ける行に対して特別な JDBC 定義の負の値が含まれる場合もあります)
      例外:
      DataAccessException - 更新の発行に問題がある場合
      導入:
      6.1
      関連事項: