インターフェース SimpleJdbcInsertOperations

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

public interface SimpleJdbcInsertOperations
SimpleJdbcInsert によって実装された Simple JDBC Insert の API を指定するインターフェース。

このインターフェースは直接使用されることはあまりありませんが、簡単にモック化またはスタブ化できるため、テスト容易性を向上させるオプションを提供します。

導入:
2.5
作成者:
Thomas Risberg, Sam Brannen
  • メソッドの詳細

    • withTableName

      SimpleJdbcInsertOperations withTableName(StringSE tableName)
      挿入に使用するテーブル名を指定します。
      パラメーター:
      tableName - 格納されたテーブルの名前
      戻り値:
      この SimpleJdbcInsert (メソッドチェーン用)
    • withSchemaName

      SimpleJdbcInsertOperations withSchemaName(StringSE schemaName)
      挿入に使用するスキーマ名があれば、それを指定します。
      パラメーター:
      schemaName - スキーマの名前
      戻り値:
      この SimpleJdbcInsert (メソッドチェーン用)
    • withCatalogName

      SimpleJdbcInsertOperations withCatalogName(StringSE catalogName)
      挿入に使用するカタログ名があれば、指定します。
      パラメーター:
      catalogName - カタログの名前
      戻り値:
      この SimpleJdbcInsert (メソッドチェーン用)
    • usingColumns

      SimpleJdbcInsertOperations usingColumns(StringSE... columnNames)
      insert ステートメントの使用を制限する列名を指定します。
      パラメーター:
      columnNames - 1 つ以上の列名
      戻り値:
      この SimpleJdbcInsert (メソッドチェーン用)
    • usingGeneratedKeyColumns

      SimpleJdbcInsertOperations usingGeneratedKeyColumns(StringSE... columnNames)
      自動生成されたキーを持つ列の名前を指定します。
      パラメーター:
      columnNames - 1 つ以上の列名
      戻り値:
      この SimpleJdbcInsert (メソッドチェーン用)
    • usingQuotedIdentifiers

      SimpleJdbcInsertOperations usingQuotedIdentifiers()
      SQL 識別子を引用符で囲むように指定します。

      このメソッドが呼び出されると、基になるデータベースの識別子引用文字列が、生成された SQL ステートメント内の SQL 識別子を引用するために使用されます。この文脈では、SQL 識別子はスキーマ、テーブル、列の名前を指します。

      識別子を引用符で囲む場合は、usingColumns(String...) を介して明示的な列名を指定する必要があります。さらに、スキーマ名、テーブル名、列名のすべての識別子は、大文字と小文字 (大文字と小文字の混合、大文字、小文字) に関するデータベースのメタデータ内の対応する識別子と一致する必要があります。

      戻り値:
      この SimpleJdbcInsert (メソッドチェーン用)
      導入:
      6.1
      関連事項:
    • withoutTableColumnMetaDataAccess

      SimpleJdbcInsertOperations withoutTableColumnMetaDataAccess()
      JDBC を介して取得した列メタデータ情報の処理をオフにします。
      戻り値:
      この SimpleJdbcInsert (メソッドチェーン用)
    • includeSynonymsForTableColumnMetaData

      SimpleJdbcInsertOperations includeSynonymsForTableColumnMetaData()
      JDBC を介した列メタデータ検索のシノニムを含めます。

      メモ: シノニムをサポートする他のデータベースにはシノニムが自動的に含まれるようであるため、これを含める必要があるのは Oracle の場合のみです。

      戻り値:
      この SimpleJdbcInsert (メソッドチェーン用)
    • execute

      int execute(MapSE<StringSE,?> args)
      渡された値を使用して挿入を実行します。
      パラメーター:
      args - 列名と対応する値を含むマップ
      戻り値:
      JDBC ドライバーによって返される影響を受ける行の数
    • execute

      int execute(SqlParameterSource parameterSource)
      渡された値を使用して挿入を実行します。
      パラメーター:
      parameterSource - 挿入に使用する値を含む SqlParameterSource
      戻り値:
      JDBC ドライバーによって返される影響を受ける行の数
    • executeAndReturnKey

      NumberSE executeAndReturnKey(MapSE<StringSE,?> args)
      渡された値を使用して挿入を実行し、生成されたキーを返します。

      これには、自動生成されたキーを持つ列の名前が指定されている必要があります。このメソッドは常に KeyHolder を返しますが、呼び出し元は生成されたキーが実際に含まれていることを確認する必要があります。

      パラメーター:
      args - 列名と対応する値を含むマップ
      戻り値:
      生成されたキー値
    • executeAndReturnKey

      NumberSE executeAndReturnKey(SqlParameterSource parameterSource)
      渡された値を使用して挿入を実行し、生成されたキーを返します。

      これには、自動生成されたキーを持つ列の名前が指定されている必要があります。このメソッドは常に KeyHolder を返しますが、呼び出し元は生成されたキーが実際に含まれていることを確認する必要があります。

      パラメーター:
      parameterSource - 挿入に使用する値を含む SqlParameterSource
      戻り値:
      生成されたキー値。
    • executeAndReturnKeyHolder

      KeyHolder executeAndReturnKeyHolder(MapSE<StringSE,?> args)
      渡された値を使用して挿入を実行し、生成されたキーを返します。

      これには、自動生成されたキーを持つ列の名前が指定されている必要があります。このメソッドは常に KeyHolder を返しますが、呼び出し元は生成されたキーが実際に含まれていることを確認する必要があります。

      パラメーター:
      args - 列名と対応する値を含むマップ
      戻り値:
      生成されたすべてのキーを含む KeyHolder
    • executeAndReturnKeyHolder

      KeyHolder executeAndReturnKeyHolder(SqlParameterSource parameterSource)
      渡された値を使用して挿入を実行し、生成されたキーを返します。

      これには、自動生成されたキーを持つ列の名前が指定されている必要があります。このメソッドは常に KeyHolder を返しますが、呼び出し元は生成されたキーが実際に含まれていることを確認する必要があります。

      パラメーター:
      parameterSource - 挿入に使用する値を含む SqlParameterSource
      戻り値:
      生成されたすべてのキーを含む KeyHolder
    • executeBatch

      int[] executeBatch(MapSE<StringSE,?>... batch)
      渡された値のバッチを使用してバッチ挿入を実行します。
      パラメーター:
      batch - 列名と対応する値のバッチを含むマップの配列
      戻り値:
      JDBC ドライバーによって返される影響を受ける行数の配列
    • executeBatch

      int[] executeBatch(SqlParameterSource... batch)
      渡された値のバッチを使用してバッチ挿入を実行します。
      パラメーター:
      batch - バッチの値を含む SqlParameterSource の配列
      戻り値:
      JDBC ドライバーによって返される影響を受ける行数の配列