Class SqlServerMaxValueIncrementer
- java.lang.Object
- org.springframework.jdbc.support.incrementer.AbstractDataFieldMaxValueIncrementer
- org.springframework.jdbc.support.incrementer.AbstractColumnMaxValueIncrementer
- org.springframework.jdbc.support.incrementer.AbstractIdentityColumnMaxValueIncrementer
- org.springframework.jdbc.support.incrementer.SqlServerMaxValueIncrementer
- All Implemented Interfaces:
InitializingBean
,DataFieldMaxValueIncrementer
public class SqlServerMaxValueIncrementer extends AbstractIdentityColumnMaxValueIncrementer
DataFieldMaxValueIncrementer
that increments the maximum value of a given SQL Server table with the equivalent of an auto-increment column. Note: If you use this class, your table key column should NOT be defined as an IDENTITY column, as the sequence table does the job.This class is intended to be used with Microsoft SQL Server.
The sequence is kept in a table. There should be one sequence table per table that needs an auto-generated key.
Example:
create table tab (id int not null primary key, text varchar(100)) create table tab_sequence (id bigint identity) insert into tab_sequence default values
If "cacheSize" is set, the intermediate values are served without querying the database. If the server or your application is stopped or crashes or a transaction is rolled back, the unused values will never be served. The maximum hole size in numbering is consequently the value of cacheSize. HINT: Since Microsoft SQL Server supports the JDBC 3.0getGeneratedKeys
method, it is recommended to use IDENTITY columns directly in the tables and then using aSimpleJdbcInsert
or utilizing aKeyHolder
when calling the with theupdate(PreparedStatementCreator psc, KeyHolder generatedKeyHolder)
method of theJdbcTemplate
.Thanks to Preben Nilsson for the suggestion!
- Since:
- 2.5.5
- Author:
- Thomas Risberg, Juergen Hoeller
Field Summary
Fields inherited from class org.springframework.jdbc.support.incrementer.AbstractDataFieldMaxValueIncrementer
paddingLength
Constructor Summary
Constructors Constructor Description SqlServerMaxValueIncrementer()
Default constructor for bean property style usage.SqlServerMaxValueIncrementer(DataSource dataSource, String incrementerName, String columnName)
Convenience constructor.
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected String
getIdentityStatement()
Statement to use to obtain the current identity value.protected String
getIncrementStatement()
Statement to use to increment the "sequence" value.Methods inherited from class org.springframework.jdbc.support.incrementer.AbstractIdentityColumnMaxValueIncrementer
getDeleteStatement, getNextKey, isDeleteSpecificValues, setDeleteSpecificValues
Methods inherited from class org.springframework.jdbc.support.incrementer.AbstractColumnMaxValueIncrementer
afterPropertiesSet, getCacheSize, getColumnName, setCacheSize, setColumnName
Methods inherited from class org.springframework.jdbc.support.incrementer.AbstractDataFieldMaxValueIncrementer
getDataSource, getIncrementerName, getPaddingLength, nextIntValue, nextLongValue, nextStringValue, setDataSource, setIncrementerName, setPaddingLength
Constructor Detail
SqlServerMaxValueIncrementer
public SqlServerMaxValueIncrementer()
Default constructor for bean property style usage.
SqlServerMaxValueIncrementer
public SqlServerMaxValueIncrementer(DataSource dataSource, String incrementerName, String columnName)
Convenience constructor.- Parameters:
dataSource
- the DataSource to useincrementerName
- the name of the sequence/table to usecolumnName
- the name of the column in the sequence table to use
Method Detail
getIncrementStatement
protected String getIncrementStatement()
Description copied from class:AbstractIdentityColumnMaxValueIncrementer
Statement to use to increment the "sequence" value.- Specified by:
getIncrementStatement
in classAbstractIdentityColumnMaxValueIncrementer
- Returns:
- the SQL statement to use
getIdentityStatement
protected String getIdentityStatement()
Description copied from class:AbstractIdentityColumnMaxValueIncrementer
Statement to use to obtain the current identity value.- Specified by:
getIdentityStatement
in classAbstractIdentityColumnMaxValueIncrementer
- Returns:
- the SQL statement to use