org.fastnate.generator.context

Class IdGenerator

java.lang.Object

org.fastnate.generator.context.IdGenerator

Direct Known Subclasses:

IdentityValue, SequenceIdGenerator, TableIdGenerator

public abstract class IdGenerator
extends Object

Saves the current value and increments the value for a GeneratedIdProperty.

Author:

Tobias Liefke

Constructor Summary

Constructors

Constructor and Description
IdGenerator()

Method Summary

Modifier and Type	Method and Description
abstract void	addNextValue(InsertStatement statement, String column, Number nextValue) Adds the generated value to the given statement.
abstract List<? extends EntityStatement>	alignNextValue() Creates all statements that are necessary to set the next value created from the database is currentValue + 1.
protected abstract long	createNextValue() Resolves the next value of this generator.
<N extends Number> N	createNextValue(Class<N> propertyClass) Resolves the next value of this generator.
abstract List<? extends EntityStatement>	createPreInsertStatements() Creates the statements that are needed in the output before addNextValue(InsertStatement, String, Number).
IdGenerator	derive(String table) Some implementations (like the Hibernate table generator) create a different generator, depending on the table name.
abstract long	getCurrentValue() The last value returned by createNextValue(Class).
abstract String	getExpression(String table, String column, Number id, boolean whereExpression) Builds the reference to another entity that has the given ID.
abstract boolean	isPostIncrement() Indicates that createNextValue(Class) should be called after the entity was written - as the value is not available before.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IdGenerator

public IdGenerator()

Method Detail

addNextValue

public abstract void addNextValue(InsertStatement statement,
                                  String column,
                                  Number nextValue)

Adds the generated value to the given statement. Depending on the generator this may add the value itself or a reference to the value.

Parameters:

statement - the current insert statement

column - the name of the ID column

nextValue - the current value of the column, previously generated with createNextValue()

alignNextValue

public abstract List<? extends EntityStatement> alignNextValue()

Creates all statements that are necessary to set the next value created from the database is currentValue + 1.

Returns:

the statements - an empty list if nothing is necessary

createNextValue

protected abstract long createNextValue()

Resolves the next value of this generator.

Returns:

the generated value

createNextValue

public <N extends Number> N createNextValue(Class<N> propertyClass)

Resolves the next value of this generator.

Parameters:

propertyClass - the type of the generated value

Returns:

the generated value

createPreInsertStatements

public abstract List<? extends EntityStatement> createPreInsertStatements()

Creates the statements that are needed in the output before addNextValue(InsertStatement, String, Number).

Returns:

statements that increase the sequence value before the insert statement

derive

public IdGenerator derive(String table)

Some implementations (like the Hibernate table generator) create a different generator, depending on the table name.

Parameters:

table - the name of the current entity table

Returns:

the generator

getCurrentValue

public abstract long getCurrentValue()

The last value returned by createNextValue(Class).

Returns:

the current value

getExpression

public abstract String getExpression(String table,
                                     String column,
                                     Number id,
                                     boolean whereExpression)

Builds the reference to another entity that has the given ID.

Parameters:

table - the name of the table of the entity

column - the name of the column of the ID

id - the current value of the ID

whereExpression - indicates if this expression is needed for a "SELECT ... WHERE ..." - some dialects behave differently in this situation

Returns:

the expression for selecting the ID

isPostIncrement

public abstract boolean isPostIncrement()

Indicates that createNextValue(Class) should be called after the entity was written - as the value is not available before.

Returns:

true if the database increments the value _after_ the insert statement was executed, true if it is incremented before or during the execution