Top Description Constructors Methods
org.springframework.jdbc.support.incrementer

public Class SqlServerMaxValueIncrementer

extends AbstractIdentityColumnMaxValueIncrementer
Class Inheritance
Imports
javax.sql.DataSource

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 getGeneratedKeys method, it is recommended to use IDENTITY columns directly in the tables and then use a org.springframework.jdbc.core.simple.SimpleJdbcInsert or a org.springframework.jdbc.support.KeyHolder when calling the update(PreparedStatementCreator psc, KeyHolder generatedKeyHolder) method of the org.springframework.jdbc.core.JdbcTemplate.

Thanks to Preben Nilsson for the suggestion!

Authors
Thomas Risberg, Juergen Hoeller
Since
2.5.5

Constructor Summary

AccessConstructor and Description
public
SqlServerMaxValueIncrementer()

Default constructor for bean property style usage.

public
SqlServerMaxValueIncrementer(DataSource
the DataSource to use
dataSource
,
String
the name of the sequence/table to use
incrementerName
,
String
the name of the column in the sequence table to use
columnName
)

Convenience constructor.

Method Summary

Modifier and TypeMethod and Description
protected String
protected String
Inherited from org.springframework.jdbc.support.incrementer.AbstractIdentityColumnMaxValueIncrementer:
getDeleteStatementgetNextKeyisDeleteSpecificValuessetDeleteSpecificValues

Constructor Detail

SqlServerMaxValueIncrementerback to summary
public SqlServerMaxValueIncrementer()

Default constructor for bean property style usage.

See Also
setDataSource, setIncrementerName, setColumnName
SqlServerMaxValueIncrementerback to summary
public SqlServerMaxValueIncrementer(DataSource dataSource, String incrementerName, String columnName)

Convenience constructor.

Parameters
dataSource:DataSource

the DataSource to use

incrementerName:String

the name of the sequence/table to use

columnName:String

the name of the column in the sequence table to use

Method Detail

getIdentityStatementback to summary
protected String getIdentityStatement()

Implements abstract org.springframework.jdbc.support.incrementer.AbstractIdentityColumnMaxValueIncrementer.getIdentityStatement.

Doc from org.springframework.jdbc.support.incrementer.AbstractIdentityColumnMaxValueIncrementer.getIdentityStatement.

Statement to use to obtain the current identity value.

Returns:String

the SQL statement to use

Annotations
@Override
getIncrementStatementback to summary
protected String getIncrementStatement()

Implements abstract org.springframework.jdbc.support.incrementer.AbstractIdentityColumnMaxValueIncrementer.getIncrementStatement.

Doc from org.springframework.jdbc.support.incrementer.AbstractIdentityColumnMaxValueIncrementer.getIncrementStatement.

Statement to use to increment the "sequence" value.

Returns:String

the SQL statement to use

Annotations
@Override