SimpleJdbcInsert (Spring Framework API)

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
関連事項:
DatabaseMetaDataSE, JdbcTemplate

フィールドサマリー
- クラス org.springframework.jdbc.core.simple.AbstractJdbcInsert から継承されたフィールド
  logger

コンストラクターのサマリー

コンストラクター
コンストラクターと説明
`SimpleJdbcInsert(DataSourceSE dataSource)` JdbcTemplate を作成するときに使用する JDBC DataSource で 1 つのパラメーターを取るコンストラクター。
`SimpleJdbcInsert(JdbcTemplate jdbcTemplate)` 使用する JdbcTemplate で 1 つのパラメーターを取る代替コンストラクター。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`int`	`execute(MapSE<StringSE,?> args)` 渡された値を使用して挿入を実行します。
`int`	`execute(SqlParameterSource parameterSource)` 渡された値を使用して挿入を実行します。
`NumberSE`	`executeAndReturnKey(MapSE<StringSE,?> args)` 渡された値を使用して挿入を実行し、生成されたキーを返します。
`NumberSE`	`executeAndReturnKey(SqlParameterSource parameterSource)` 渡された値を使用して挿入を実行し、生成されたキーを返します。
`KeyHolder`	`executeAndReturnKeyHolder(MapSE<StringSE,?> args)` 渡された値を使用して挿入を実行し、生成されたキーを返します。
`KeyHolder`	`executeAndReturnKeyHolder(SqlParameterSource parameterSource)` 渡された値を使用して挿入を実行し、生成されたキーを返します。
`int[]`	`executeBatch(MapSE<StringSE,?>... batch)` 渡された値のバッチを使用してバッチ挿入を実行します。
`int[]`	`executeBatch(SqlParameterSource... batch)` 渡された値のバッチを使用してバッチ挿入を実行します。
`SimpleJdbcInsertOperations`	`includeSynonymsForTableColumnMetaData()` JDBC を介した列メタデータ検索のシノニムを含めます。
`SimpleJdbcInsert`	`usingColumns(StringSE... columnNames)` insert ステートメントの使用を制限する列名を指定します。
`SimpleJdbcInsert`	`usingGeneratedKeyColumns(StringSE... columnNames)` 自動生成キーを持つ列の名前を指定します。
`SimpleJdbcInsert`	`withCatalogName(StringSE catalogName)` 挿入に使用するカタログ名があれば、指定します。
`SimpleJdbcInsertOperations`	`withoutTableColumnMetaDataAccess()` JDBC を介して取得した列メタデータ情報の処理をオフにします。
`SimpleJdbcInsert`	`withSchemaName(StringSE schemaName)` 挿入に使用するスキーマ名があれば、それを指定します。
`SimpleJdbcInsert`	`withTableName(StringSE tableName)` 挿入に使用するテーブル名を指定します。

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

- コンストラクターの詳細
  - SimpleJdbcInsert
```
public SimpleJdbcInsert(DataSourceSE dataSource)
```
    JdbcTemplate を作成するときに使用する JDBC DataSource で 1 つのパラメーターを取るコンストラクター。
    パラメーター:
    dataSource - 使用する DataSource
    関連事項:
    JdbcAccessor.setDataSource(javax.sql.DataSource)
  - SimpleJdbcInsert
```
public SimpleJdbcInsert(JdbcTemplate jdbcTemplate)
```
    使用する JdbcTemplate で 1 つのパラメーターを取る代替コンストラクター。
    パラメーター:
    jdbcTemplate - 使用する JdbcTemplate
    関連事項:
    JdbcAccessor.setDataSource(javax.sql.DataSource)
- メソッドの詳細
  - 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 ドライバーによって返される影響を受ける行数の配列

クラス SimpleJdbcInsert

フィールドサマリー

クラス org.springframework.jdbc.core.simple.AbstractJdbcInsert から継承されたフィールド

コンストラクターのサマリー

メソッドのサマリー

クラス org.springframework.jdbc.core.simple.AbstractJdbcInsert から継承されたメソッド

クラス java.lang.ObjectSE から継承されたメソッド

コンストラクターの詳細

SimpleJdbcInsert

SimpleJdbcInsert

メソッドの詳細

withTableName

withSchemaName

withCatalogName

usingColumns

usingGeneratedKeyColumns

withoutTableColumnMetaDataAccess

includeSynonymsForTableColumnMetaData

execute

execute

executeAndReturnKey

executeAndReturnKey

executeAndReturnKeyHolder

executeAndReturnKeyHolder

executeBatch

executeBatch