org.fastnate.generator.context

Class PluralProperty<E,C,T>

java.lang.Object

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

org.fastnate.generator.context.PluralProperty<E,C,T>

Type Parameters:

E - The type of the container class

C - The type of the collection or map

T - The type of the elements in the collection

Direct Known Subclasses:

CollectionProperty, MapProperty

public abstract class PluralProperty<E,C,T>
extends Property<E,C>

Base class for MapProperty and CollectionProperty.

Author:

Tobias Liefke

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	PluralProperty.EntityMappingInformation Helper for evaluating correct mapping information from the annotations.

Field Summary

Fields

Modifier and Type	Field and Description
private AnyMapping<T>	anyMapping Contains information about an addition class column, if ManyToAny is used.
private boolean	composition Indicates that, according to the CascadeType, we should remove the target entities when the current entity is removed.
private GeneratorContext	context The current context.
private GeneratorDialect	dialect The current database dialect, as defined in the context.
private List<Property<T,?>>	embeddedProperties Contains all properties of an embedded element collection.
private Map<String,Property<T,?>>	embeddedPropertiesByName Contains all properties of an embedded element collection by their name.
private boolean	entityReference Indicates that entities are referenced by the collection.
private GeneratorColumn	idColumn The column that contains the id of the entity.
private Property<T,?>	inverseProperty The opposite property of a bidirectional mapping.
private String	mappedBy Indicates that this property is defined by another property on the target type.
private String	mappedId The property to use, if an id is embedded.
private List<EntityProperty<T,?>>	requiredEmbeddedProperties Contains all properties of an embedded element collection which reference a required entity.
private GeneratorTable	table The modified table.
private boolean	useTargetTable Indicates to use a column of the target table.
private Class<T>	valueClass The class of the value of the collection.
private GeneratorColumn	valueColumn The column that contains the value (or the id of the value).
private Constructor<T>	valueConstructor The noargs constructor for the values of the collection.
private ValueConverter<T>	valueConverter The converter for the value of the collection, null if not a primitive value.
private EntityClass<T>	valueEntityClass The description of the valueClass, null if not an entity or ManyToAny is used.

Constructor Summary

Constructors

Constructor and Description
PluralProperty(EntityClass<?> sourceClass, AttributeAccessor attribute, javax.persistence.AssociationOverride associationOverride, javax.persistence.AttributeOverride attributeOverride, int valueClassParamIndex) Creates a new property.

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.
protected void	buildEmbeddedProperties(EntityClass<?> sourceClass, Class<?> targetType) Builds the embedded properties of this property.
protected static String	buildIdColumn(AttributeAccessor attribute, javax.persistence.AssociationOverride override, javax.persistence.CollectionTable collectionMetadata, String defaultIdColumn) Builds the name of the column that contains the ID of the entity for the given attribute.
private static String	buildIdColumn(AttributeAccessor attribute, javax.persistence.AssociationOverride override, javax.persistence.JoinColumn[] joinColumns, String defaultIdColumn)
private static String	buildIdColumn(AttributeAccessor attribute, javax.persistence.AssociationOverride override, javax.persistence.JoinTable joinTable, javax.persistence.CollectionTable tableMetadata, String defaultIdColumn)
private static GeneratorColumn	buildValueColumn(GeneratorTable table, javax.persistence.AssociationOverride asscoiationOverride, javax.persistence.AttributeOverride attributeOverride, AttributeAccessor attribute, String defaultColumnName) Builds the column that contains the value for the collection / map.
protected void	createDirectValueStatement(StatementsWriter writer, E entity, ColumnExpression sourceId, ColumnExpression key, T value) Creates the statements for a (not embeddable) value from the collection.
private void	createEmbeddedValueStatement(StatementsWriter writer, E entity, ColumnExpression sourceId, ColumnExpression key, T value) Writes all embedded properties of a value of a collection table.
protected ColumnExpression	createValueExpression(E entity, ColumnExpression sourceId, T value, ColumnExpression key) Creates a SQL expression for a value of the collection, as long as it is not embedded.
protected void	createValueStatement(StatementsWriter writer, E entity, ColumnExpression sourceId, ColumnExpression key, T value) Adds a value statement to the list of collection statements.
private static String	findMappedId(AttributeAccessor attribute)
private static <T> Constructor<T>	findValueConstructor(Class<T> valueClass)
void	generatePendingStatements(StatementsWriter writer, E entity, Object writtenEntity, Object... arguments) Generates the update statements for an entity that are required after another entity was generated.
AnyMapping<T>	getAnyMapping() Contains information about an addition class column, if ManyToAny is used.
GeneratorContext	getContext() The current context.
GeneratorDialect	getDialect() The current database dialect, as defined in the context.
List<Property<T,?>>	getEmbeddedProperties() Contains all properties of an embedded element collection.
Map<String,Property<T,?>>	getEmbeddedPropertiesByName() Contains all properties of an embedded element collection by their name.
GeneratorColumn	getIdColumn() The column that contains the id of the entity.
Property<T,?>	getInverseProperty() The opposite property of a bidirectional mapping.
private static String	getJoinColumnName(javax.persistence.JoinColumn[] joinColumns)
protected abstract GeneratorColumn	getKeyColumn() An optional column that contains the index / key of the values.
String	getMappedBy() Indicates that this property is defined by another property on the target type.
String	getMappedId() The property to use, if an id is embedded.
protected static <T> Class<T>	getPropertyArgument(AttributeAccessor attribute, Class<T> explicitClass, int argumentIndex) Inspects the given attribute and searches for a generic type argument.
List<EntityProperty<T,?>>	getRequiredEmbeddedProperties() Contains all properties of an embedded element collection which reference a required entity.
GeneratorTable	getTable() The modified table.
Class<T>	getValueClass() The class of the value of the collection.
GeneratorColumn	getValueColumn() The column that contains the value (or the id of the value).
Constructor<T>	getValueConstructor() The noargs constructor for the values of the collection.
ValueConverter<T>	getValueConverter() The converter for the value of the collection, null if not a primitive value.
EntityClass<T>	getValueEntityClass() The description of the valueClass, null if not an entity or ManyToAny is used.
protected static boolean	hasPluralAnnotation(AttributeAccessor attribute) Indicates, that the given attribute has an annotation that indicates a plural property.
private void	initializeIdColumnForMappingTable(EntityClass<?> sourceClass, AttributeAccessor attribute, javax.persistence.AssociationOverride override, javax.persistence.JoinTable joinTable, javax.persistence.CollectionTable collectionTable)
private void	initializeInverseProperty()
boolean	isComposition() Indicates that, according to the CascadeType, we should remove the target entities when the current entity is removed.
boolean	isEmbedded() Indicates that this propery is a ElementCollection that references Embeddables.
boolean	isEntityReference() Indicates that entities are referenced by the collection.
boolean	isRequired() Indicates if this property is an required field in the database (needs to exist when the insert statement is written).
boolean	isTableColumn() Indicates that this property maps to a column from the parent table.
boolean	isUseTargetTable() Indicates to use a column of the target table.
T	newElement() Tries to create a new instance of an element using the parameter-less constructor.
private static String	resolveAnnotationAttribute(javax.persistence.AssociationOverride override, javax.persistence.JoinTable joinTable, javax.persistence.CollectionTable collectionTable, Function<javax.persistence.JoinTable,String> joinTableAttribute, Function<javax.persistence.CollectionTable,String> collectionTableAttribute, String defaultAttribute)
private static GeneratorTable	resolveTable(GeneratorContext context, javax.persistence.AssociationOverride override, javax.persistence.JoinTable joinTable, javax.persistence.CollectionTable collectionTable, GeneratorTable sourceEntityTable, String targetEntityTable)

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

createPostInsertStatements, createPreInsertStatements, failIfRequired, findReferencedEntities, getAttribute, getExpression, getName, getPredicate, getType, getValue, isComposition, setValue, toString

Methods inherited from class java.lang.Object

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

Field Detail

context

private final GeneratorContext context

The current context.

dialect

private final GeneratorDialect dialect

The current database dialect, as defined in the context.

embeddedProperties

private List<Property<T,?>> embeddedProperties

Contains all properties of an embedded element collection.

embeddedPropertiesByName

private Map<String,Property<T,?>> embeddedPropertiesByName

Contains all properties of an embedded element collection by their name.

requiredEmbeddedProperties

private List<EntityProperty<T,?>> requiredEmbeddedProperties

Contains all properties of an embedded element collection which reference a required entity.

mappedId

private final String mappedId

The property to use, if an id is embedded.

table

private final GeneratorTable table

The modified table.

idColumn

private GeneratorColumn idColumn

The column that contains the id of the entity.

composition

private final boolean composition

Indicates that, according to the CascadeType, we should remove the target entities when the current entity is removed. Always true for ElementCollections.

mappedBy

private final String mappedBy

Indicates that this property is defined by another property on the target type.

inverseProperty

private Property<T,?> inverseProperty

The opposite property of a bidirectional mapping. Can either be another PluralProperty (it the relationship is a ManyToMany) or an EntityProperty (if the relationship is a OneToMany.

useTargetTable

private final boolean useTargetTable

Indicates to use a column of the target table.

valueColumn

private final GeneratorColumn valueColumn

The column that contains the value (or the id of the value).

valueClass

private final Class<T> valueClass

The class of the value of the collection.

valueConstructor

private final Constructor<T> valueConstructor

The noargs constructor for the values of the collection.

entityReference

private final boolean entityReference

Indicates that entities are referenced by the collection.

valueEntityClass

private final EntityClass<T> valueEntityClass

The description of the valueClass, null if not an entity or ManyToAny is used.

valueConverter

private final ValueConverter<T> valueConverter

The converter for the value of the collection, null if not a primitive value.

anyMapping

private final AnyMapping<T> anyMapping

Contains information about an addition class column, if ManyToAny is used.

Constructor Detail

PluralProperty

public PluralProperty(EntityClass<?> sourceClass,
                      AttributeAccessor attribute,
                      javax.persistence.AssociationOverride associationOverride,
                      javax.persistence.AttributeOverride attributeOverride,
                      int valueClassParamIndex)

Creates a new property.

Parameters:

sourceClass - the description of the current inspected class that contains this property

attribute - accessor to the represented attribute

associationOverride - the configured assocation override

attributeOverride - the configured attribute override, if we reference an ElementCollection

valueClassParamIndex - the index of the value argument in the collection class (0 for collection, 1 for map)

Method Detail

buildIdColumn

protected static String buildIdColumn(AttributeAccessor attribute,
                                      javax.persistence.AssociationOverride override,
                                      javax.persistence.CollectionTable collectionMetadata,
                                      String defaultIdColumn)

Builds the name of the column that contains the ID of the entity for the given attribute.

Parameters:

attribute - the accessor for the inspected attribute

override - contains optional override options

collectionMetadata - the default join column

defaultIdColumn - the default name for the column, if joinColumn is empty or null

Returns:

the column name

buildIdColumn

private static String buildIdColumn(AttributeAccessor attribute,
                                    javax.persistence.AssociationOverride override,
                                    javax.persistence.JoinColumn[] joinColumns,
                                    String defaultIdColumn)

buildIdColumn

private static String buildIdColumn(AttributeAccessor attribute,
                                    javax.persistence.AssociationOverride override,
                                    javax.persistence.JoinTable joinTable,
                                    javax.persistence.CollectionTable tableMetadata,
                                    String defaultIdColumn)

buildValueColumn

private static GeneratorColumn buildValueColumn(GeneratorTable table,
                                                javax.persistence.AssociationOverride asscoiationOverride,
                                                javax.persistence.AttributeOverride attributeOverride,
                                                AttributeAccessor attribute,
                                                String defaultColumnName)

Builds the column that contains the value for the collection / map.

Parameters:

table - the collection table

asscoiationOverride - contains optional override options for association

attributeOverride - contains optional override options for element collections

attribute - the inspected attribute

defaultColumnName - the default column name

Returns:

the column definition

findMappedId

private static String findMappedId(AttributeAccessor attribute)

findValueConstructor

private static <T> Constructor<T> findValueConstructor(Class<T> valueClass)

getJoinColumnName

private static String getJoinColumnName(javax.persistence.JoinColumn[] joinColumns)

getPropertyArgument

protected static <T> Class<T> getPropertyArgument(AttributeAccessor attribute,
                                                  Class<T> explicitClass,
                                                  int argumentIndex)

Inspects the given attribute and searches for a generic type argument.

Parameters:

attribute - the attribute to inspect

explicitClass - an explicit class to use, if the metadata specified one

argumentIndex - the index of the argument, for maps there are two: the key and the value

Returns:

the found class

hasPluralAnnotation

protected static boolean hasPluralAnnotation(AttributeAccessor attribute)

Indicates, that the given attribute has an annotation that indicates a plural property.

Parameters:

attribute - the attribute to check

Returns:

true if one of the plural annotations is defined for the attribute

resolveAnnotationAttribute

private static String resolveAnnotationAttribute(javax.persistence.AssociationOverride override,
                                                 javax.persistence.JoinTable joinTable,
                                                 javax.persistence.CollectionTable collectionTable,
                                                 Function<javax.persistence.JoinTable,String> joinTableAttribute,
                                                 Function<javax.persistence.CollectionTable,String> collectionTableAttribute,
                                                 String defaultAttribute)

resolveTable

private static GeneratorTable resolveTable(GeneratorContext context,
                                           javax.persistence.AssociationOverride override,
                                           javax.persistence.JoinTable joinTable,
                                           javax.persistence.CollectionTable collectionTable,
                                           GeneratorTable sourceEntityTable,
                                           String targetEntityTable)

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 Property<E,C>

Parameters:

statement - the created statement

entity - the inspected entity

buildEmbeddedProperties

protected void buildEmbeddedProperties(EntityClass<?> sourceClass,
                                       Class<?> targetType)

Builds the embedded properties of this property.

Parameters:

sourceClass - the class that contains our property

targetType - the target type

createDirectValueStatement

protected void createDirectValueStatement(StatementsWriter writer,
                                          E entity,
                                          ColumnExpression sourceId,
                                          ColumnExpression key,
                                          T value)
                                   throws IOException

Creates the statements for a (not embeddable) value from the collection.

Parameters:

writer - the target of created statements

entity - the entity that contains the collection resp. map.

sourceId - the ID of the current entity

key - the value of the getKeyColumn() - either the index or the map key

value - the current value in the collection

Throws:

IOException - if the writer throws one

createEmbeddedValueStatement

private void createEmbeddedValueStatement(StatementsWriter writer,
                                          E entity,
                                          ColumnExpression sourceId,
                                          ColumnExpression key,
                                          T value)
                                   throws IOException

Writes all embedded properties of a value of a collection table.

Parameters:

writer - the target of the created statement

entity - the entity that contains the collection resp. map.

sourceId - the ID of the current entity

key - the value of the getKeyColumn() - either the index or the map key

value - the current value in the collection

Throws:

IOException - if the writer throws one

createValueExpression

protected ColumnExpression createValueExpression(E entity,
                                                 ColumnExpression sourceId,
                                                 T value,
                                                 ColumnExpression key)

Creates a SQL expression for a value of the collection, as long as it is not embedded.

Parameters:

entity - the entity that contains the collection

sourceId - the id of the entity as SQL expression

key - the key/index of the entity in the collection as SQL expression

value - the value that is written

Returns:

the expression or null if the insert is still pending

createValueStatement

protected void createValueStatement(StatementsWriter writer,
                                    E entity,
                                    ColumnExpression sourceId,
                                    ColumnExpression key,
                                    T value)
                             throws IOException

Adds a value statement to the list of collection statements.

Parameters:

writer - the target of the created statements

entity - the entity that contains the collection

sourceId - the id of the entity as SQL expression

key - the key/index of the entity in the collection as SQL expression

value - the value that is written

Throws:

IOException - if the writer throws one

generatePendingStatements

public void generatePendingStatements(StatementsWriter writer,
                                      E entity,
                                      Object writtenEntity,
                                      Object... arguments)
                               throws IOException

Description copied from class: Property

Generates the update statements for an entity that are required after another entity was generated. Only called, if EntityClass.markPendingUpdates(E, V, org.fastnate.generator.context.Property<V, ?>, java.lang.Object...) was called before for writtenEntity

Overrides:

generatePendingStatements in class Property<E,C>

Parameters:

writer - the target of the generated statements

entity - the entity that needs to be updated

writtenEntity - the entity that exists now in the database

arguments - additional arguments that where given to markPendingUpdates

Throws:

IOException - if the writer throws one

getKeyColumn

protected abstract GeneratorColumn getKeyColumn()

An optional column that contains the index / key of the values.

Returns:

the key column for map properties resp. the index column for list properties

initializeIdColumnForMappingTable

private void initializeIdColumnForMappingTable(EntityClass<?> sourceClass,
                                               AttributeAccessor attribute,
                                               javax.persistence.AssociationOverride override,
                                               javax.persistence.JoinTable joinTable,
                                               javax.persistence.CollectionTable collectionTable)

initializeInverseProperty

private void initializeInverseProperty()

isEmbedded

public boolean isEmbedded()

Indicates that this propery is a ElementCollection that references Embeddables.

Returns:

true if getEmbeddedProperties() returns a list of properties

isRequired

public boolean isRequired()

Description copied from class: Property

Indicates if this property is an required field in the database (needs to exist when the insert statement is written).

Overrides:

isRequired in class Property<E,C>

Returns:

true if the field is required

isTableColumn

public boolean isTableColumn()

Description copied from class: Property

Indicates that this property maps to a column from the parent table.

Specified by:

isTableColumn in class Property<E,C>

Returns:

true if Property.addInsertExpression(org.fastnate.generator.statements.TableStatement, E) will add the corresponding value to the given statement

newElement

public T newElement()

Tries to create a new instance of an element using the parameter-less constructor.

Returns:

the new element

getContext

@Generated(value="lombok")
public GeneratorContext getContext()

The current context.

getDialect

@Generated(value="lombok")
public GeneratorDialect getDialect()

The current database dialect, as defined in the context.

getEmbeddedProperties

@Generated(value="lombok")
public List<Property<T,?>> getEmbeddedProperties()

Contains all properties of an embedded element collection.

getEmbeddedPropertiesByName

@Generated(value="lombok")
public Map<String,Property<T,?>> getEmbeddedPropertiesByName()

Contains all properties of an embedded element collection by their name.

getRequiredEmbeddedProperties

@Generated(value="lombok")
public List<EntityProperty<T,?>> getRequiredEmbeddedProperties()

Contains all properties of an embedded element collection which reference a required entity.

getMappedId

@Generated(value="lombok")
public String getMappedId()

The property to use, if an id is embedded.

getTable

@Generated(value="lombok")
public GeneratorTable getTable()

The modified table.

getIdColumn

@Generated(value="lombok")
public GeneratorColumn getIdColumn()

The column that contains the id of the entity.

isComposition

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

Indicates that, according to the CascadeType, we should remove the target entities when the current entity is removed. Always true for ElementCollections.

getMappedBy

@Generated(value="lombok")
public String getMappedBy()

Indicates that this property is defined by another property on the target type.

getInverseProperty

@Generated(value="lombok")
public Property<T,?> getInverseProperty()

The opposite property of a bidirectional mapping. Can either be another PluralProperty (it the relationship is a ManyToMany) or an EntityProperty (if the relationship is a OneToMany.

isUseTargetTable

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

Indicates to use a column of the target table.

getValueColumn

@Generated(value="lombok")
public GeneratorColumn getValueColumn()

The column that contains the value (or the id of the value).

getValueClass

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

The class of the value of the collection.

getValueConstructor

@Generated(value="lombok")
public Constructor<T> getValueConstructor()

The noargs constructor for the values of the collection.

isEntityReference

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

Indicates that entities are referenced by the collection.

getValueEntityClass

@Generated(value="lombok")
public EntityClass<T> getValueEntityClass()

The description of the valueClass, null if not an entity or ManyToAny is used.

getValueConverter

@Generated(value="lombok")
public ValueConverter<T> getValueConverter()

The converter for the value of the collection, null if not a primitive value.

getAnyMapping

@Generated(value="lombok")
public AnyMapping<T> getAnyMapping()

Contains information about an addition class column, if ManyToAny is used.