org.fastnate.generator.context

Class GeneratedIdProperty<E,T extends Number>

java.lang.Object

org.fastnate.generator.context.Property<E,T>

org.fastnate.generator.context.SingularProperty<E,T>

org.fastnate.generator.context.PrimitiveProperty<E,T>

org.fastnate.generator.context.GeneratedIdProperty<E,T>

Type Parameters:

E - The type of the container class

T - The type of the property

public class GeneratedIdProperty<E,T extends Number>
extends PrimitiveProperty<E,T>

Describes an Id property of an EntityClass.

Author:

Tobias Liefke

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	absoluteIds Shortcut for the inverse of GeneratorContext.isWriteRelativeIds().
private EntityClass<E>	entityClass The entity class that contains our property.
private IdGenerator	generator The generator used for generating new values of this property.
private boolean	primitive Indicates that the ID is never "null", because we have a primitive ID value.
private Class<T>	type The type of the numbers.
private T	unknownIdMarker Marker for the ID of an entity which needs to be referenced by its unique properties.

Constructor Summary

Constructors

Constructor and Description
GeneratedIdProperty(EntityClass<E> entityClass, AttributeAccessor attribute, javax.persistence.Column column) Creates a new instance of GeneratedIdProperty.

Method Summary

Modifier and Type	Method and Description
void	addInsertExpression(TableStatement statement, E entity) Adds an expression according to the current value of the property for the given entity to an SQL insert statement.
void	createPreInsertStatements(StatementsWriter writer, E entity) Creates SQL statements that are necessary before this property is written (e.g. for updating the table generator).
private void	ensureIsNew(E entity)
EntityClass<E>	getEntityClass() The entity class that contains our property.
ColumnExpression	getExpression(E entity, boolean whereExpression) Creates the reference of an entity in SQL using its (relative or absolute) id.
IdGenerator	getGenerator() The generator used for generating new values of this property.
Class<T>	getType() The type of the numbers.
T	getUnknownIdMarker() Marker for the ID of an entity which needs to be referenced by its unique properties.
boolean	isAbsoluteIds() Shortcut for the inverse of GeneratorContext.isWriteRelativeIds().
boolean	isNew(E entity) Indicates that the given entity needs to be written.
boolean	isPrimitive() Indicates that the ID is never "null", because we have a primitive ID value.
boolean	isReference(E entity) Indicates that the given entity was not written before, but exists already in the database.
void	markReference(E entity) Marks an entity as reference, where we don't know the ID database.
void	markReference(E entity, T id) Marks an entity as reference, where we know the id in the database.
void	postInsert(E entity) Called after the insert statement was written, to update any nessecary state in the context.

Methods inherited from class org.fastnate.generator.context.PrimitiveProperty

getColumn, getContext, getConverter, getDefaultValue, getDefaultValue, getDialect, getPredicate, getTable, isRequired

Methods inherited from class org.fastnate.generator.context.SingularProperty

isTableColumn

Methods inherited from class org.fastnate.generator.context.Property

createPostInsertStatements, failIfRequired, findReferencedEntities, generatePendingStatements, getAttribute, getName, getValue, isComposition, setValue, toString

Methods inherited from class java.lang.Object

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

Field Detail

absoluteIds

private final boolean absoluteIds

Shortcut for the inverse of GeneratorContext.isWriteRelativeIds().

primitive

private final boolean primitive

Indicates that the ID is never "null", because we have a primitive ID value.

entityClass

private final EntityClass<E> entityClass

The entity class that contains our property.

type

private final Class<T extends Number> type

The type of the numbers.

unknownIdMarker

private final T extends Number unknownIdMarker

Marker for the ID of an entity which needs to be referenced by its unique properties.

generator

private final IdGenerator generator

The generator used for generating new values of this property.

Constructor Detail

GeneratedIdProperty

public GeneratedIdProperty(EntityClass<E> entityClass,
                           AttributeAccessor attribute,
                           javax.persistence.Column column)

Creates a new instance of GeneratedIdProperty.

Parameters:

entityClass - the entity class

attribute - the accessor of the id attribute

column - the column annotation

Method Detail

addInsertExpression

public void addInsertExpression(TableStatement statement,
                                E entity)

Description copied from class: Property

Adds an expression according to the current value of the property for the given entity to an SQL insert statement.

Overrides:

addInsertExpression in class PrimitiveProperty<E,T extends Number>

Parameters:

statement - the created statement

entity - the inspected entity

createPreInsertStatements

public void createPreInsertStatements(StatementsWriter writer,
                                      E entity)
                               throws IOException

Description copied from class: Property

Creates SQL statements that are necessary before this property is written (e.g. for updating the table generator).

Overrides:

createPreInsertStatements in class Property<E,T extends Number>

Parameters:

writer - the target of the created statements

entity - the inspected entity

Throws:

IOException - if the writer throws an exception

ensureIsNew

private void ensureIsNew(E entity)

getExpression

public ColumnExpression getExpression(E entity,
                                      boolean whereExpression)

Creates the reference of an entity in SQL using its (relative or absolute) id.

Overrides:

getExpression in class PrimitiveProperty<E,T extends Number>

Parameters:

entity - the entity

whereExpression - indicates that the reference is used in a "where" statement

Returns:

the expression for the ID of that entity or null if the entity was not written up to now

Throws:

IllegalArgumentException - if the entity is a reference without any id

isNew

public boolean isNew(E entity)

Indicates that the given entity needs to be written.

Parameters:

entity - the entity to check

Returns:

true if the id of the given entity is not set up to now

isReference

public boolean isReference(E entity)

Indicates that the given entity was not written before, but exists already in the database.

Parameters:

entity - the entity to check

Returns:

true if the entity was marked as reference

markReference

public void markReference(E entity)

Marks an entity as reference, where we don't know the ID database. A reference is not written during SQL generation, because it exists already in the database when the script is executed. As we don't know the ID during build time we have to reference it using some unique properties.

Parameters:

entity - the entity to mark

markReference

public void markReference(E entity,
                          T id)

Marks an entity as reference, where we know the id in the database. A reference is not written during SQL generation, because it exists already in the database when the script is executed.

Parameters:

entity - the entity to mark

id - the id of the entity in the database

postInsert

public void postInsert(E entity)

Called after the insert statement was written, to update any nessecary state in the context.

Parameters:

entity - the current entity

isAbsoluteIds

@Generated(value="lombok")
public boolean isAbsoluteIds()

Shortcut for the inverse of GeneratorContext.isWriteRelativeIds().

isPrimitive

@Generated(value="lombok")
public boolean isPrimitive()

Indicates that the ID is never "null", because we have a primitive ID value.

getEntityClass

@Generated(value="lombok")
public EntityClass<E> getEntityClass()

The entity class that contains our property.

getType

@Generated(value="lombok")
public Class<T> getType()

The type of the numbers.

Overrides:

getType in class Property<E,T extends Number>

Returns:

the type of the attribute

getUnknownIdMarker

@Generated(value="lombok")
public T getUnknownIdMarker()

Marker for the ID of an entity which needs to be referenced by its unique properties.

getGenerator

@Generated(value="lombok")
public IdGenerator getGenerator()

The generator used for generating new values of this property.