クラス SimpleJdbcInsert
- 実装されたすべてのインターフェース:
SimpleJdbcInsertOperations
SimpleJdbcInsert
は、テーブルへの簡単な (バッチ) 挿入機能を提供するマルチスレッドの再利用可能なオブジェクトです。基本的な挿入ステートメントの構築に必要なコードを簡素化するメタデータ処理を提供します。指定する必要があるのは、テーブルの名前と、列名と列値を含む Map
だけです。 メタデータ処理は、JDBC ドライバーが提供する DatabaseMetaData
に基づいています。JDBC ドライバーが指定されたテーブルの列の名前を提供できる限り、この自動検出機能を利用できます。そうでない場合は、列名を明示的に指定する必要があります。
実際の (バッチ) 挿入は、Spring の JdbcTemplate
を使用して処理されます。
構成メソッドの多くは、SimpleJdbcInsert
の現在のインスタンスを返し、複数のインスタンスを「流れるような」 API スタイルで チェーン する機能を提供します。
- 導入:
- 2.5
- 作成者:
- Thomas Risberg, Juergen Hoeller, Sam Brannen
- 関連事項:
フィールドサマリー
クラス org.springframework.jdbc.core.simple.AbstractJdbcInsert から継承されたフィールド
logger
コンストラクターのサマリー
コンストラクター説明SimpleJdbcInsert
(DataSourceSE dataSource) JdbcTemplate
の作成時に使用する JDBCDataSource
SE を受け入れるコンストラクター。SimpleJdbcInsert
(JdbcTemplate jdbcTemplate) 使用するJdbcTemplate
を受け入れる代替コンストラクター。メソッドのサマリー
修飾子と型メソッド説明int
渡された値を使用して挿入を実行します。int
execute
(SqlParameterSource parameterSource) 渡された値を使用して挿入を実行します。executeAndReturnKey
(MapSE<StringSE, ?> args) 渡された値を使用して挿入を実行し、生成されたキーを返します。executeAndReturnKey
(SqlParameterSource parameterSource) 渡された値を使用して挿入を実行し、生成されたキーを返します。executeAndReturnKeyHolder
(MapSE<StringSE, ?> args) 渡された値を使用して挿入を実行し、生成されたキーを返します。executeAndReturnKeyHolder
(SqlParameterSource parameterSource) 渡された値を使用して挿入を実行し、生成されたキーを返します。int[]
executeBatch
(MapSE<StringSE, ?>... batch) 渡された値のバッチを使用してバッチ挿入を実行します。int[]
executeBatch
(SqlParameterSource... batch) 渡された値のバッチを使用してバッチ挿入を実行します。JDBC を介した列メタデータ検索のシノニムを含めます。usingColumns
(StringSE... columnNames) insert ステートメントの使用を制限する列名を指定します。usingGeneratedKeyColumns
(StringSE... columnNames) 自動生成されたキーを持つ列の名前を指定します。SQL 識別子を引用符で囲むように指定します。withCatalogName
(StringSE catalogName) 挿入に使用するカタログ名があれば、指定します。JDBC を介して取得した列メタデータ情報の処理をオフにします。withSchemaName
(StringSE schemaName) 挿入に使用するスキーマ名があれば、それを指定します。withTableName
(StringSE tableName) 挿入に使用するテーブル名を指定します。クラス org.springframework.jdbc.core.simple.AbstractJdbcInsert から継承されたメソッド
checkCompiled, checkIfConfigurationModificationIsAllowed, compile, compileInternal, doExecute, doExecute, doExecuteAndReturnKey, doExecuteAndReturnKey, doExecuteAndReturnKeyHolder, doExecuteAndReturnKeyHolder, doExecuteBatch, doExecuteBatch, getCatalogName, getColumnNames, getGeneratedKeyNames, getInsertString, getInsertTypes, getJdbcTemplate, getSchemaName, getTableName, isCompiled, isQuoteIdentifiers, matchInParameterValuesWithInsertColumns, matchInParameterValuesWithInsertColumns, onCompileInternal, setAccessTableColumnMetaData, setCatalogName, setColumnNames, setGeneratedKeyName, setGeneratedKeyNames, setOverrideIncludeSynonymsDefault, setQuoteIdentifiers, setSchemaName, setTableName
コンストラクターの詳細
SimpleJdbcInsert
JdbcTemplate
の作成時に使用する JDBCDataSource
SE を受け入れるコンストラクター。- パラメーター:
dataSource
- 使用するDataSource
- 関連事項:
SimpleJdbcInsert
使用するJdbcTemplate
を受け入れる代替コンストラクター。- パラメーター:
jdbcTemplate
- 使用するJdbcTemplate
- 関連事項:
メソッドの詳細
withTableName
インターフェースからコピーされた説明:SimpleJdbcInsertOperations
挿入に使用するテーブル名を指定します。- 次で指定:
- インターフェース
SimpleJdbcInsertOperations
のwithTableName
- パラメーター:
tableName
- 格納されたテーブルの名前- 戻り値:
- この
SimpleJdbcInsert
(メソッドチェーン用)
withSchemaName
インターフェースからコピーされた説明:SimpleJdbcInsertOperations
挿入に使用するスキーマ名があれば、それを指定します。- 次で指定:
- インターフェース
SimpleJdbcInsertOperations
のwithSchemaName
- パラメーター:
schemaName
- スキーマの名前- 戻り値:
- この
SimpleJdbcInsert
(メソッドチェーン用)
withCatalogName
インターフェースからコピーされた説明:SimpleJdbcInsertOperations
挿入に使用するカタログ名があれば、指定します。- 次で指定:
- インターフェース
SimpleJdbcInsertOperations
のwithCatalogName
- パラメーター:
catalogName
- カタログの名前- 戻り値:
- この
SimpleJdbcInsert
(メソッドチェーン用)
usingColumns
インターフェースからコピーされた説明:SimpleJdbcInsertOperations
insert ステートメントの使用を制限する列名を指定します。- 次で指定:
- インターフェース
SimpleJdbcInsertOperations
のusingColumns
- パラメーター:
columnNames
- 1 つ以上の列名- 戻り値:
- この
SimpleJdbcInsert
(メソッドチェーン用)
usingGeneratedKeyColumns
インターフェースからコピーされた説明:SimpleJdbcInsertOperations
自動生成されたキーを持つ列の名前を指定します。- 次で指定:
- インターフェース
SimpleJdbcInsertOperations
のusingGeneratedKeyColumns
- パラメーター:
columnNames
- 1 つ以上の列名- 戻り値:
- この
SimpleJdbcInsert
(メソッドチェーン用)
usingQuotedIdentifiers
インターフェースからコピーされた説明:SimpleJdbcInsertOperations
SQL 識別子を引用符で囲むように指定します。このメソッドが呼び出されると、基になるデータベースの識別子引用文字列が、生成された SQL ステートメント内の SQL 識別子を引用するために使用されます。この文脈では、SQL 識別子はスキーマ、テーブル、列の名前を指します。
識別子を引用符で囲む場合は、
SimpleJdbcInsertOperations.usingColumns(String...)
を介して明示的な列名を指定する必要があります。さらに、スキーマ名、テーブル名、列名のすべての識別子は、大文字と小文字 (大文字と小文字の混合、大文字、小文字) に関するデータベースのメタデータ内の対応する識別子と一致する必要があります。- 次で指定:
- インターフェース
SimpleJdbcInsertOperations
のusingQuotedIdentifiers
- 戻り値:
- この
SimpleJdbcInsert
(メソッドチェーン用) - 関連事項:
SimpleJdbcInsertOperations.withSchemaName(String)
SimpleJdbcInsertOperations.withTableName(String)
SimpleJdbcInsertOperations.usingColumns(String...)
DatabaseMetaData.getIdentifierQuoteString()
DatabaseMetaData.storesMixedCaseIdentifiers()
DatabaseMetaData.storesMixedCaseQuotedIdentifiers()
DatabaseMetaData.storesUpperCaseIdentifiers()
DatabaseMetaData.storesUpperCaseQuotedIdentifiers()
DatabaseMetaData.storesLowerCaseIdentifiers()
DatabaseMetaData.storesLowerCaseQuotedIdentifiers()
withoutTableColumnMetaDataAccess
インターフェースからコピーされた説明:SimpleJdbcInsertOperations
JDBC を介して取得した列メタデータ情報の処理をオフにします。- 次で指定:
- インターフェース
SimpleJdbcInsertOperations
のwithoutTableColumnMetaDataAccess
- 戻り値:
- この
SimpleJdbcInsert
(メソッドチェーン用)
includeSynonymsForTableColumnMetaData
インターフェースからコピーされた説明:SimpleJdbcInsertOperations
JDBC を介した列メタデータ検索のシノニムを含めます。メモ: シノニムをサポートする他のデータベースにはシノニムが自動的に含まれるようであるため、これを含める必要があるのは Oracle の場合のみです。
- 次で指定:
- インターフェース
SimpleJdbcInsertOperations
のincludeSynonymsForTableColumnMetaData
- 戻り値:
- この
SimpleJdbcInsert
(メソッドチェーン用)
execute
インターフェースからコピーされた説明:SimpleJdbcInsertOperations
渡された値を使用して挿入を実行します。- 次で指定:
- インターフェース
SimpleJdbcInsertOperations
のexecute
- パラメーター:
args
- 列名と対応する値を含むマップ- 戻り値:
- JDBC ドライバーによって返される影響を受ける行の数
execute
インターフェースからコピーされた説明:SimpleJdbcInsertOperations
渡された値を使用して挿入を実行します。- 次で指定:
- インターフェース
SimpleJdbcInsertOperations
のexecute
- パラメーター:
parameterSource
- 挿入に使用する値を含む SqlParameterSource- 戻り値:
- JDBC ドライバーによって返される影響を受ける行の数
executeAndReturnKey
インターフェースからコピーされた説明:SimpleJdbcInsertOperations
渡された値を使用して挿入を実行し、生成されたキーを返します。これには、自動生成されたキーを持つ列の名前が指定されている必要があります。このメソッドは常に KeyHolder を返しますが、呼び出し元は生成されたキーが実際に含まれていることを確認する必要があります。
- 次で指定:
- インターフェース
SimpleJdbcInsertOperations
のexecuteAndReturnKey
- パラメーター:
args
- 列名と対応する値を含むマップ- 戻り値:
- 生成されたキー値
executeAndReturnKey
インターフェースからコピーされた説明:SimpleJdbcInsertOperations
渡された値を使用して挿入を実行し、生成されたキーを返します。これには、自動生成されたキーを持つ列の名前が指定されている必要があります。このメソッドは常に KeyHolder を返しますが、呼び出し元は生成されたキーが実際に含まれていることを確認する必要があります。
- 次で指定:
- インターフェース
SimpleJdbcInsertOperations
のexecuteAndReturnKey
- パラメーター:
parameterSource
- 挿入に使用する値を含む SqlParameterSource- 戻り値:
- 生成されたキー値。
executeAndReturnKeyHolder
インターフェースからコピーされた説明:SimpleJdbcInsertOperations
渡された値を使用して挿入を実行し、生成されたキーを返します。これには、自動生成されたキーを持つ列の名前が指定されている必要があります。このメソッドは常に KeyHolder を返しますが、呼び出し元は生成されたキーが実際に含まれていることを確認する必要があります。
- 次で指定:
- インターフェース
SimpleJdbcInsertOperations
のexecuteAndReturnKeyHolder
- パラメーター:
args
- 列名と対応する値を含むマップ- 戻り値:
- 生成されたすべてのキーを含む KeyHolder
executeAndReturnKeyHolder
インターフェースからコピーされた説明:SimpleJdbcInsertOperations
渡された値を使用して挿入を実行し、生成されたキーを返します。これには、自動生成されたキーを持つ列の名前が指定されている必要があります。このメソッドは常に KeyHolder を返しますが、呼び出し元は生成されたキーが実際に含まれていることを確認する必要があります。
- 次で指定:
- インターフェース
SimpleJdbcInsertOperations
のexecuteAndReturnKeyHolder
- パラメーター:
parameterSource
- 挿入に使用する値を含む SqlParameterSource- 戻り値:
- 生成されたすべてのキーを含む KeyHolder
executeBatch
インターフェースからコピーされた説明:SimpleJdbcInsertOperations
渡された値のバッチを使用してバッチ挿入を実行します。- 次で指定:
- インターフェース
SimpleJdbcInsertOperations
のexecuteBatch
- パラメーター:
batch
- 列名と対応する値のバッチを含むマップの配列- 戻り値:
- JDBC ドライバーによって返される影響を受ける行数の配列
executeBatch
インターフェースからコピーされた説明:SimpleJdbcInsertOperations
渡された値のバッチを使用してバッチ挿入を実行します。- 次で指定:
- インターフェース
SimpleJdbcInsertOperations
のexecuteBatch
- パラメーター:
batch
- バッチの値を含む SqlParameterSource の配列- 戻り値:
- JDBC ドライバーによって返される影響を受ける行数の配列