java.lang.ObjectSE

org.springframework.jdbc.core.simple.AbstractJdbcInsert

org.springframework.jdbc.core.simple.SimpleJdbcInsert

実装されたすべてのインターフェース:: SimpleJdbcInsertOperations

public class SimpleJdbcInsert extends AbstractJdbcInsert implements 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 の作成時に使用する JDBC DataSourceSE を受け入れるコンストラクター。
SimpleJdbcInsert(JdbcTemplate jdbcTemplate)
使用する JdbcTemplate を受け入れる代替コンストラクター。
メソッドのサマリー
修飾子と型
メソッド
説明
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)
渡された値のバッチを使用してバッチ挿入を実行します。
SimpleJdbcInsert
includeSynonymsForTableColumnMetaData()
JDBC を介した列メタデータ検索のシノニムを含めます。
SimpleJdbcInsert
usingColumns(StringSE... columnNames)
insert ステートメントの使用を制限する列名を指定します。
SimpleJdbcInsert
usingGeneratedKeyColumns(StringSE... columnNames)
自動生成されたキーを持つ列の名前を指定します。
SimpleJdbcInsert
usingQuotedIdentifiers()
SQL 識別子を引用符で囲むように指定します。
SimpleJdbcInsert
withCatalogName(StringSE catalogName)
挿入に使用するカタログ名があれば、指定します。
SimpleJdbcInsert
withoutTableColumnMetaDataAccess()
JDBC を介して取得した列メタデータ情報の処理をオフにします。
SimpleJdbcInsert
withSchemaName(StringSE schemaName)
挿入に使用するスキーマ名があれば、それを指定します。
SimpleJdbcInsert
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
クラス java.lang.ObjectSE から継承されたメソッド
clone, equalsSE, finalize, getClass, hashCode, notify, notifyAll, toString, wait, waitSE, waitSE

コンストラクターの詳細
- SimpleJdbcInsert
  public SimpleJdbcInsert(DataSourceSE dataSource)
  JdbcTemplate の作成時に使用する JDBC DataSourceSE を受け入れるコンストラクター。
  パラメーター:
  dataSource - 使用する DataSource
  関連事項:
  JdbcAccessor.setDataSource(javax.sql.DataSource)
- SimpleJdbcInsert
  public SimpleJdbcInsert(JdbcTemplate jdbcTemplate)
  使用する JdbcTemplate を受け入れる代替コンストラクター。
  パラメーター:
  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 (メソッドチェーン用)
- usingQuotedIdentifiers
  public 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
  public SimpleJdbcInsert withoutTableColumnMetaDataAccess()
  インターフェースからコピーされた説明: SimpleJdbcInsertOperations
  JDBC を介して取得した列メタデータ情報の処理をオフにします。
  次で指定:
  インターフェース SimpleJdbcInsertOperations の withoutTableColumnMetaDataAccess
  戻り値:
  この SimpleJdbcInsert (メソッドチェーン用)
- includeSynonymsForTableColumnMetaData
  public SimpleJdbcInsert 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

usingQuotedIdentifiers

withoutTableColumnMetaDataAccess

includeSynonymsForTableColumnMetaData

execute

execute

executeAndReturnKey

executeAndReturnKey

executeAndReturnKeyHolder

executeAndReturnKeyHolder

executeBatch

executeBatch