/*
* Copyright 2002-2018 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.springframework.jdbc.support.incrementer;
import javax.sql.DataSource;
DataFieldMaxValueIncrementer
that increments the maximum value of a given Sybase 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 Sybase Anywhere.
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 values(DEFAULT)
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 Sybase Anywhere supports the JDBC 3.0 getGeneratedKeys
method, it is recommended to use IDENTITY columns directly in the tables and then using a SimpleJdbcInsert
or utilizing a KeyHolder
when calling the with the update(PreparedStatementCreator psc, KeyHolder generatedKeyHolder)
method of the JdbcTemplate
. Thanks to Tarald Saxi Stormark for the suggestion!
Author: Thomas Risberg Since: 3.0.5
/**
* {@link DataFieldMaxValueIncrementer} that increments the maximum value of a given Sybase 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}
* 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)}
* 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 Also:
/**
* Default constructor for bean property style usage.
* @see #setDataSource
* @see #setIncrementerName
* @see #setColumnName
*/
public SybaseAnywhereMaxValueIncrementer() {
}
Convenience constructor.
Params: - dataSource – the DataSource to use
- incrementerName – the name of the sequence/table to use
- columnName – the name of the column in the sequence table to use
/**
* 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)";
}
}