パッケージ org.springframework.jdbc.core.simple

クラス SimpleJdbcInsert

java.lang.ObjectSE
org.springframework.jdbc.core.simple.AbstractJdbcInsert
org.springframework.jdbc.core.simple.SimpleJdbcInsert
実装されたすべてのインターフェース:
SimpleJdbcInsertOperations
public class SimpleJdbcInsert extends AbstractJdbcInsert implements SimpleJdbcInsertOperations
SimpleJdbcInsert は、マルチスレッドで再利用可能なオブジェクトであり、テーブルに簡単に挿入する機能を提供します。基本的な挿入ステートメントを作成するために必要なコードを簡素化するためのメタデータ処理を提供します。提供する必要があるのは、テーブルの名前と、列名と列値を含むマップだけです。

メタデータ処理は、JDBC ドライバーによって提供される DatabaseMetaData に基づいています。JDBC ドライバーが指定されたテーブルの列の名前を提供できる限り、この自動検出機能を信頼できます。そうでない場合は、列名を明示的に指定する必要があります。

実際の挿入は、Spring の JdbcTemplate を使用して処理されます。

構成メソッドの多くは、SimpleJdbcInsert の現在のインスタンスを返し、「流れるような」インターフェーススタイルで複数のチェーンを 1 つにまとめる機能を提供します。

導入:
2.5
作成者:
Thomas Risberg, Juergen Hoeller
関連事項:

  • コンストラクターの詳細

    • SimpleJdbcInsert

      public SimpleJdbcInsert(DataSourceSE dataSource)
      JdbcTemplate を作成するときに使用する JDBC DataSource で 1 つのパラメーターを取るコンストラクター。
      パラメーター:
      dataSource - 使用する DataSource 
      関連事項:

    • SimpleJdbcInsert

      public SimpleJdbcInsert(JdbcTemplate jdbcTemplate)
      使用する JdbcTemplate で 1 つのパラメーターを取る代替コンストラクター。
      パラメーター:
      jdbcTemplate - 使用する JdbcTemplate 
      関連事項:

  • メソッドの詳細

    • withTableName

      public SimpleJdbcInsert withTableName(StringSE tableName)
      インターフェースからコピーされた説明: SimpleJdbcInsertOperations
      挿入に使用するテーブル名を指定します。
      次で指定:
      インターフェース SimpleJdbcInsertOperations の withTableName 
      パラメーター:
      tableName - 格納されたテーブルの名前
      戻り値:
      この SimpleJdbcInsert のインスタンス

    • withSchemaName

      public SimpleJdbcInsert withSchemaName(StringSE schemaName)
      インターフェースからコピーされた説明: SimpleJdbcInsertOperations
      挿入に使用するスキーマ名があれば、それを指定します。
      次で指定:
      インターフェース SimpleJdbcInsertOperations の withSchemaName 
      パラメーター:
      schemaName - スキーマの名前
      戻り値:
      この SimpleJdbcInsert のインスタンス

    • withCatalogName

      public SimpleJdbcInsert withCatalogName(StringSE catalogName)
      インターフェースからコピーされた説明: SimpleJdbcInsertOperations
      挿入に使用するカタログ名があれば、指定します。
      次で指定:
      インターフェース SimpleJdbcInsertOperations の withCatalogName 
      パラメーター:
      catalogName - カタログの名前
      戻り値:
      この SimpleJdbcInsert のインスタンス

    • usingColumns

      public SimpleJdbcInsert usingColumns(StringSE... columnNames)
      インターフェースからコピーされた説明: SimpleJdbcInsertOperations
      insert ステートメントの使用を制限する列名を指定します。
      次で指定:
      インターフェース SimpleJdbcInsertOperations の usingColumns 
      パラメーター:
      columnNames - 1 つ以上の列名
      戻り値:
      この SimpleJdbcInsert のインスタンス

    • usingGeneratedKeyColumns

      public SimpleJdbcInsert usingGeneratedKeyColumns(StringSE... columnNames)
      インターフェースからコピーされた説明: SimpleJdbcInsertOperations
      自動生成キーを持つ列の名前を指定します。
      次で指定:
      インターフェース SimpleJdbcInsertOperations の usingGeneratedKeyColumns 
      パラメーター:
      columnNames - 1 つ以上の列名
      戻り値:
      この SimpleJdbcInsert のインスタンス

    • withoutTableColumnMetaDataAccess

      public SimpleJdbcInsertOperations withoutTableColumnMetaDataAccess()
      インターフェースからコピーされた説明: SimpleJdbcInsertOperations
      JDBC を介して取得した列メタデータ情報の処理をオフにします。
      次で指定:
      インターフェース SimpleJdbcInsertOperations の withoutTableColumnMetaDataAccess 
      戻り値:
      この SimpleJdbcInsert のインスタンス

    • includeSynonymsForTableColumnMetaData

      public SimpleJdbcInsertOperations includeSynonymsForTableColumnMetaData()
      インターフェースからコピーされた説明: SimpleJdbcInsertOperations
      JDBC を介した列メタデータ検索のシノニムを含めます。

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

      次で指定:
      インターフェース SimpleJdbcInsertOperations の includeSynonymsForTableColumnMetaData 
      戻り値:
      この SimpleJdbcInsert のインスタンス

    • execute

      public int execute(MapSE<StringSE,?> args)
      インターフェースからコピーされた説明: SimpleJdbcInsertOperations
      渡された値を使用して挿入を実行します。
      次で指定:
      インターフェース SimpleJdbcInsertOperations の execute 
      パラメーター:
      args - 列名と対応する値を含むマップ
      戻り値:
      JDBC ドライバーによって返される影響を受ける行の数

    • execute

      public int execute(SqlParameterSource parameterSource)
      インターフェースからコピーされた説明: SimpleJdbcInsertOperations
      渡された値を使用して挿入を実行します。
      次で指定:
      インターフェース SimpleJdbcInsertOperations の execute 
      パラメーター:
      parameterSource - 挿入に使用する値を含む SqlParameterSource
      戻り値:
      JDBC ドライバーによって返される影響を受ける行の数

    • executeAndReturnKey

      public NumberSE executeAndReturnKey(MapSE<StringSE,?> args)
      インターフェースからコピーされた説明: SimpleJdbcInsertOperations
      渡された値を使用して挿入を実行し、生成されたキーを返します。

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

      次で指定:
      インターフェース SimpleJdbcInsertOperations の executeAndReturnKey 
      パラメーター:
      args - 列名と対応する値を含むマップ
      戻り値:
      生成されたキー値

    • executeAndReturnKey

      public NumberSE executeAndReturnKey(SqlParameterSource parameterSource)
      インターフェースからコピーされた説明: SimpleJdbcInsertOperations
      渡された値を使用して挿入を実行し、生成されたキーを返します。

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

      次で指定:
      インターフェース SimpleJdbcInsertOperations の executeAndReturnKey 
      パラメーター:
      parameterSource - 挿入に使用する値を含む SqlParameterSource
      戻り値:
      生成されたキー値。

    • executeAndReturnKeyHolder

      public KeyHolder executeAndReturnKeyHolder(MapSE<StringSE,?> args)
      インターフェースからコピーされた説明: SimpleJdbcInsertOperations
      渡された値を使用して挿入を実行し、生成されたキーを返します。

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

      次で指定:
      インターフェース SimpleJdbcInsertOperations の executeAndReturnKeyHolder 
      パラメーター:
      args - 列名と対応する値を含むマップ
      戻り値:
      生成されたすべてのキーを含む KeyHolder

    • executeAndReturnKeyHolder

      public KeyHolder executeAndReturnKeyHolder(SqlParameterSource parameterSource)
      インターフェースからコピーされた説明: SimpleJdbcInsertOperations
      渡された値を使用して挿入を実行し、生成されたキーを返します。

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

      次で指定:
      インターフェース SimpleJdbcInsertOperations の executeAndReturnKeyHolder 
      パラメーター:
      parameterSource - 挿入に使用する値を含む SqlParameterSource
      戻り値:
      生成されたすべてのキーを含む KeyHolder

    • executeBatch

      public int[] executeBatch(MapSE<StringSE,?>... batch)
      インターフェースからコピーされた説明: SimpleJdbcInsertOperations
      渡された値のバッチを使用してバッチ挿入を実行します。
      次で指定:
      インターフェース SimpleJdbcInsertOperations の executeBatch 
      パラメーター:
      batch - 列名と対応する値のバッチを含むマップの配列
      戻り値:
      JDBC ドライバーによって返される影響を受ける行数の配列

    • executeBatch

      public int[] executeBatch(SqlParameterSource... batch)
      インターフェースからコピーされた説明: SimpleJdbcInsertOperations
      渡された値のバッチを使用してバッチ挿入を実行します。
      次で指定:
      インターフェース SimpleJdbcInsertOperations の executeBatch 
      パラメーター:
      batch - バッチの値を含む SqlParameterSource の配列
      戻り値:
      JDBC ドライバーによって返される影響を受ける行数の配列