org.batoo.jpa.core.impl.model.mapping

Class SingularAssociationMappingImpl<Z,X>

java.lang.Object

org.batoo.jpa.core.impl.model.mapping.AbstractMapping<Z,X,Y>

org.batoo.jpa.core.impl.model.mapping.AssociationMappingImpl<Z,X,X>

org.batoo.jpa.core.impl.model.mapping.SingularAssociationMappingImpl<Z,X>

Type Parameters:

Z - the source type

X - the destination type

All Implemented Interfaces:

JoinedMapping<Z,X,X>, SingularMappingEx<Z,X>, AssociationMapping<Z,X,X>, Mapping<Z,X,X>, SingularAssociationMapping<Z,X>, SingularMapping<Z,X>

public class SingularAssociationMappingImpl<Z,X>
extends AssociationMappingImpl<Z,X,X>
implements SingularAssociationMapping<Z,X>, SingularMappingEx<Z,X>

Mappings for one-to-one and many-to-one associations.

Since:

2.0.0

Author:

hceylan

Constructor Summary

Constructors

Constructor and Description
SingularAssociationMappingImpl(AbstractParentMapping<?,Z> parent, AssociatedSingularAttribute<? super Z,X> attribute)

Method Summary

Methods

Modifier and Type	Method and Description
void	checkTransient(ManagedInstance<?> managedInstance) Checks that the association references not a transient instance
Object	extractKey(Object value) Extracts key from the value.
boolean	fillValue(EntityTypeImpl<?> type, ManagedInstance<?> managedInstance, Object instance) Fills the sequence / table generated value.
void	flush(Connection connection, ManagedInstance<?> managedInstance, boolean removals, boolean force) Flushes the associates.
AssociatedSingularAttribute<? super Z,X>	getAttribute() Returns the attribute of the mapping.
ForeignKey	getForeignKey()
IdType	getIdType()
AssociationMappingImpl<?,?,?>	getInverse() Returns the inverse attribute.
JoinTable	getJoinTable() Returns the join table of the mapping.
MappingType	getMappingType() Returns the type of the mapping.
String	getMapsId()
EntityTypeImpl<X>	getType() Returns the associate type of the mapping.
void	initialize(ManagedInstance<?> managedInstance) Initializes the mapping.
boolean	isAssociation() Returns if the mapping is an association.
boolean	isId()
boolean	isJoined() Returns if the mapping is a joined mapping.
boolean	isMap() Returns if the mapping is a map collection.
void	link() Links the attribute to its associate entity type and inverse attribute if bidirectional.
void	mergeWith(EntityManagerImpl entityManager, ManagedInstance<?> instance, Object entity, org.apache.commons.lang.mutable.MutableBoolean requiresFlush, IdentityHashMap<Object,Object> processed, LinkedList<ManagedInstance<?>> instances) Merges the association of the instance with the entity.
boolean	references(Object instance, Object reference)
void	refresh(ManagedInstance<?> instance, Set<Object> processed) Refreshes the association
void	setInverse(AssociationMappingImpl<?,?,?> inverse) Sets the inverse attribute.

Methods inherited from class org.batoo.jpa.core.impl.model.mapping.AssociationMappingImpl

cascadesDetach, cascadesMerge, cascadesPersist, cascadesRefresh, cascadesRemove, getAssociationMetadata, getFetchStrategy, getMappedBy, getMaxFetchJoinDepth, getSelectCriteria, isEager, isOwner, isOwnerSelect, join, removesOrphans

Methods inherited from class org.batoo.jpa.core.impl.model.mapping.AbstractMapping

equals, get, getJavaMember, getJavaType, getLocator, getName, getParent, getPath, getRoot, hashCode, isCollection, set, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.batoo.jpa.jdbc.mapping.Mapping

get, getJavaMember, getJavaType, getLocator, getName, getParent, getPath, getRoot, isCollection, set

Constructor Detail

SingularAssociationMappingImpl

public SingularAssociationMappingImpl(AbstractParentMapping<?,Z> parent,
                              AssociatedSingularAttribute<? super Z,X> attribute)

Parameters:

parent - the parent mapping

attribute - the attribute

Since:

2.0.0

Method Detail

checkTransient

public void checkTransient(ManagedInstance<?> managedInstance)

Checks that the association references not a transient instance

Specified by:

checkTransient in class AssociationMappingImpl<Z,X,X>

Parameters:

managedInstance - the managed instance

extractKey

public Object extractKey(Object value)

Extracts key from the value.

Specified by:

extractKey in interface JoinedMapping<Z,X,X>

Parameters:

value - the value

Returns:

the key of the value

fillValue

public boolean fillValue(EntityTypeImpl<?> type,
                ManagedInstance<?> managedInstance,
                Object instance)

Fills the sequence / table generated value.

The operation returns false if at least one entity needs to obtain identity from the database.

Specified by:

fillValue in interface SingularMappingEx<Z,X>

Parameters:

type - the entity type

managedInstance - the managed instance

instance - the instance to fill ids.

Returns:

false if all OK, true if if at least one entity needs to obtain identity from the database

flush

public void flush(Connection connection,
         ManagedInstance<?> managedInstance,
         boolean removals,
         boolean force)
           throws SQLException

Flushes the associates.

Specified by:

flush in interface JoinedMapping<Z,X,X>

Specified by:

flush in class AssociationMappingImpl<Z,X,X>

Parameters:

connection - the connection to use

managedInstance - the managed instance

removals - true if the removals should be flushed and false for the additions

force - true to force, effective only for insertions and for new entities.

Throws:

SQLException - thrown if there is an underlying SQL Exception

getAttribute

public AssociatedSingularAttribute<? super Z,X> getAttribute()

Returns the attribute of the mapping.

Specified by:

getAttribute in interface JoinedMapping<Z,X,X>

Specified by:

getAttribute in interface SingularMappingEx<Z,X>

Overrides:

getAttribute in class AbstractMapping<Z,X,X>

Returns:

the attribute of the mapping

getForeignKey

public ForeignKey getForeignKey()

Specified by:

getForeignKey in interface AssociationMapping<Z,X,X>

getIdType

public IdType getIdType()

Specified by:

getIdType in interface SingularMapping<Z,X>

getInverse

public AssociationMappingImpl<?,?,?> getInverse()

Returns the inverse attribute.

Specified by:

getInverse in class AssociationMappingImpl<Z,X,X>

Returns:

the inverse attribute or null

getJoinTable

public JoinTable getJoinTable()

Returns the join table of the mapping.

Specified by:

getJoinTable in interface JoinedMapping<Z,X,X>

Specified by:

getJoinTable in interface AssociationMapping<Z,X,X>

Specified by:

getJoinTable in class AssociationMappingImpl<Z,X,X>

Returns:

the join table of the mapping

getMappingType

public MappingType getMappingType()

Returns the type of the mapping.

Specified by:

getMappingType in interface JoinedMapping<Z,X,X>

Returns:

the type of the mapping

getMapsId

public String getMapsId()

Specified by:

getMapsId in interface SingularAssociationMapping<Z,X>

getType

public EntityTypeImpl<X> getType()

Returns the associate type of the mapping.

Specified by:

getType in interface JoinedMapping<Z,X,X>

Specified by:

getType in class AssociationMappingImpl<Z,X,X>

Returns:

the associate type of the mapping

initialize

public void initialize(ManagedInstance<?> managedInstance)

Initializes the mapping.

Specified by:

initialize in interface JoinedMapping<Z,X,X>

Specified by:

initialize in class AssociationMappingImpl<Z,X,X>

Parameters:

managedInstance - the instance

isAssociation

public boolean isAssociation()

Returns if the mapping is an association.

Specified by:

isAssociation in interface JoinedMapping<Z,X,X>

Returns:

true if the mapping is an association, false otherwise

isId

public boolean isId()

Specified by:

isId in interface SingularMapping<Z,X>

isJoined

public boolean isJoined()

Returns if the mapping is a joined mapping.

Specified by:

isJoined in interface JoinedMapping<Z,X,X>

Returns:

true if the mapping is a joined mapping, false otherwise

isMap

public boolean isMap()

Returns if the mapping is a map collection.

Specified by:

isMap in interface JoinedMapping<Z,X,X>

Returns:

true if the mapping is a map collection, false otherwise

link

public void link()
          throws MappingException

Links the attribute to its associate entity type and inverse attribute if bidirectional.

Specified by:

link in class AssociationMappingImpl<Z,X,X>

Throws:

MappingException - thrown in case of a linkage error

mergeWith

public void mergeWith(EntityManagerImpl entityManager,
             ManagedInstance<?> instance,
             Object entity,
             org.apache.commons.lang.mutable.MutableBoolean requiresFlush,
             IdentityHashMap<Object,Object> processed,
             LinkedList<ManagedInstance<?>> instances)

Merges the association of the instance with the entity.

Specified by:

mergeWith in class AssociationMappingImpl<Z,X,X>

Parameters:

entityManager - the entity manager

instance - the instance

entity - the entity

requiresFlush - if an implicit flush is required

processed - registry of processed entities

instances - the persisted instances

references

public boolean references(Object instance,
                 Object reference)

Specified by:

references in class AssociationMappingImpl<Z,X,X>

Parameters:

instance - the source instance

reference - the associate instance

Returns:

true if source contains reference to the associate, false otherwise

refresh

public void refresh(ManagedInstance<?> instance,
           Set<Object> processed)

Refreshes the association

Specified by:

refresh in class AssociationMappingImpl<Z,X,X>

Parameters:

instance - the instance that is the owner of the association

processed - the set of processed instances

setInverse

public void setInverse(AssociationMappingImpl<?,?,?> inverse)

Sets the inverse attribute.

Specified by:

setInverse in class AssociationMappingImpl<Z,X,X>

Parameters:

inverse - the inverse association