package org.springframework.jdbc.support.incrementer;
import javax.sql.DataSource;
/**
* {@link org.springframework.jdbc.support.incrementer.DataFieldMaxValueIncrementer} that increments
* the maximum value of a given Sybase SQL Anywhere table
* with the equivalent of an auto-increment column. Note: If you use this class, your table key
* column should <i>NOT</i> be defined as an IDENTITY column, as the sequence table does the job.
*
* <p>This class is intended to be used with Sybase Anywhere.
*
* <p>The sequence is kept in a table. There should be one sequence table per
* table that needs an auto-generated key.
*
* <p>Example:
*
* <pre class="code"> create table tab (id int not null primary key, text varchar(100))
* create table tab_sequence (id bigint identity)
* insert into tab_sequence values(DEFAULT)</pre>
*
* 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.
*
* <b>HINT:</b> Since Sybase Anywhere supports the JDBC 3.0 <code>getGeneratedKeys</code> method,
* it is recommended to use IDENTITY columns directly in the tables and then using a
* {@link org.springframework.jdbc.core.simple.SimpleJdbcInsert} or utilizing
* a {@link org.springframework.jdbc.support.KeyHolder} when calling the with the
* <code>update(PreparedStatementCreator psc, KeyHolder generatedKeyHolder)</code>
* method of the {@link org.springframework.jdbc.core.JdbcTemplate}.
*
* <p>Thanks to Tarald Saxi Stormark for the suggestion!
*
* @author Thomas Risberg
* @since 3.0.5
*/
public class SybaseAnywhereMaxValueIncrementer extends SybaseMaxValueIncrementer {
/**
* Default constructor for bean property style usage.
* @see #setDataSource
* @see #setIncrementerName
* @see #setColumnName
*/
public SybaseAnywhereMaxValueIncrementer() {
}
/**
* Convenience constructor.
* @param dataSource the DataSource to use
* @param incrementerName the name of the sequence/table to use
* @param columnName the name of the column in the sequence table to use
*/
public SybaseAnywhereMaxValueIncrementer(DataSource dataSource, String incrementerName, String columnName) {
super(dataSource, incrementerName, columnName);
}
@Override
protected String getIncrementStatement() {
return "insert into " + getIncrementerName() + " values(DEFAULT)";
}
}
|