org.springframework.data.mapping.model

Class BasicPersistentEntity<T,P extends PersistentProperty<P>>

java.lang.Object

org.springframework.data.mapping.model.BasicPersistentEntity<T,P>

All Implemented Interfaces:

MutablePersistentEntity<T,P>, PersistentEntity<T,P>

public class BasicPersistentEntity<T,P extends PersistentProperty<P>>
extends Object
implements MutablePersistentEntity<T,P>

Simple value object to capture information of PersistentEntitys.

Author:

Oliver Gierke, Jon Brisbin, Patryk Wasik, Thomas Darimont, Christoph Strobl, Mark Paluch

Property Summary

Type	Property and Description
boolean	hasId Returns whether the PersistentEntity has an id property.
boolean	hasVersion Returns whether the PersistentEntity has a version property.

Constructor Summary

Constructors

Constructor and Description
BasicPersistentEntity(TypeInformation<T> information) Creates a new BasicPersistentEntity from the given TypeInformation.
BasicPersistentEntity(TypeInformation<T> information, Comparator<P> comparator) Creates a new BasicPersistentEntity for the given TypeInformation and Comparator.

Method Summary

Modifier and Type	Method and Description
void	addAssociation(Association<P> association) Adds an Association to the entity.
void	addPersistentProperty(P property) Adds a PersistentProperty to the entity.
void	doWithAssociations(AssociationHandler<P> handler) Applies the given AssociationHandler to all Association contained in this PersistentEntity.
void	doWithAssociations(SimpleAssociationHandler handler)
void	doWithProperties(PropertyHandler<P> handler) Applies the given PropertyHandler to all PersistentPropertys contained in this PersistentEntity.
void	doWithProperties(SimplePropertyHandler handler)
<A extends Annotation> A	findAnnotation(Class<A> annotationType) Looks up the annotation of the given type on the PersistentEntity.
IdentifierAccessor	getIdentifierAccessor(Object bean) Returns the IdentifierAccessor for the given bean.
P	getIdProperty() Returns the id property of the PersistentEntity.
String	getName() The entity name including any package prefix.
PreferredConstructor<T,P>	getPersistenceConstructor() Returns the PreferredConstructor to be used to instantiate objects of this PersistentEntity.
P	getPersistentProperty(Class<? extends Annotation> annotationType) Returns the property equipped with an annotation of the given type.
P	getPersistentProperty(String name) Obtains a PersistentProperty instance by name.
PersistentPropertyAccessor	getPropertyAccessor(Object bean) Returns a PersistentPropertyAccessor to access property values of the given bean.
Class<T>	getType() Returns the resolved Java type of this entity.
Object	getTypeAlias() Returns the alias to be used when storing type information.
TypeInformation<T>	getTypeInformation() Returns the TypeInformation backing this PersistentEntity.
P	getVersionProperty() Returns the version property of the PersistentEntity.
boolean	hasIdProperty() Returns whether the PersistentEntity has an id property.
boolean	hasVersionProperty() Returns whether the PersistentEntity has a version property.
boolean	isConstructorArgument(PersistentProperty<?> property) Returns whether the given PersistentProperty is referred to by a constructor argument of the PersistentEntity.
boolean	isIdProperty(PersistentProperty<?> property) Returns whether the given PersistentProperty is the id property of the entity.
boolean	isVersionProperty(PersistentProperty<?> property) Returns whether the given PersistentProperty is the version property of the entity.
protected P	returnPropertyIfBetterIdPropertyCandidateOrNull(P property) Returns the given property if it is a better candidate for the id property than the current id property.
void	setPersistentPropertyAccessorFactory(PersistentPropertyAccessorFactory factory) Sets the PersistentPropertyAccessorFactory for the entity.
void	verify() Callback method to trigger validation of the PersistentEntity.

Methods inherited from class java.lang.Object

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

Property Detail

hasId

public boolean hasIdProperty

Specified by:

hasIdProperty in interface PersistentEntity<T,P extends PersistentProperty<P>>

hasVersion

public boolean hasVersionProperty

Specified by:

hasVersionProperty in interface PersistentEntity<T,P extends PersistentProperty<P>>

Constructor Detail

BasicPersistentEntity

public BasicPersistentEntity(TypeInformation<T> information)

Creates a new BasicPersistentEntity from the given TypeInformation.

Parameters:

information - must not be null.

BasicPersistentEntity

public BasicPersistentEntity(TypeInformation<T> information,
                             Comparator<P> comparator)

Creates a new BasicPersistentEntity for the given TypeInformation and Comparator. The given Comparator will be used to define the order of the PersistentProperty instances added to the entity.

Parameters:

information - must not be null.

comparator - can be null.

Method Detail

getPersistenceConstructor

public PreferredConstructor<T,P> getPersistenceConstructor()

Description copied from interface: PersistentEntity

Returns the PreferredConstructor to be used to instantiate objects of this PersistentEntity.

Specified by:

getPersistenceConstructor in interface PersistentEntity<T,P extends PersistentProperty<P>>

Returns:

null in case no suitable constructor for automatic construction can be found. This usually indicates that the instantiation of the object of that persistent entity is done through either a customer EntityInstantiator or handled by custom conversion mechanisms entirely.

isConstructorArgument

public boolean isConstructorArgument(PersistentProperty<?> property)

Description copied from interface: PersistentEntity

Returns whether the given PersistentProperty is referred to by a constructor argument of the PersistentEntity.

Specified by:

isConstructorArgument in interface PersistentEntity<T,P extends PersistentProperty<P>>

Returns:

true if the given PersistentProperty is referred to by a constructor argument or false if not or null.

isIdProperty

public boolean isIdProperty(PersistentProperty<?> property)

Description copied from interface: PersistentEntity

Returns whether the given PersistentProperty is the id property of the entity.

Specified by:

isIdProperty in interface PersistentEntity<T,P extends PersistentProperty<P>>

Returns:

isVersionProperty

public boolean isVersionProperty(PersistentProperty<?> property)

Description copied from interface: PersistentEntity

Returns whether the given PersistentProperty is the version property of the entity.

Specified by:

isVersionProperty in interface PersistentEntity<T,P extends PersistentProperty<P>>

Returns:

getName

public String getName()

Description copied from interface: PersistentEntity

The entity name including any package prefix.

Specified by:

getName in interface PersistentEntity<T,P extends PersistentProperty<P>>

Returns:

must never return null

getIdProperty

public P getIdProperty()

Description copied from interface: PersistentEntity

Returns the id property of the PersistentEntity. Can be null in case this is an entity completely handled by a custom conversion.

Specified by:

getIdProperty in interface PersistentEntity<T,P extends PersistentProperty<P>>

Returns:

the id property of the PersistentEntity.

getVersionProperty

public P getVersionProperty()

Description copied from interface: PersistentEntity

Returns the version property of the PersistentEntity. Can be null in case no version property is available on the entity.

Specified by:

getVersionProperty in interface PersistentEntity<T,P extends PersistentProperty<P>>

Returns:

the version property of the PersistentEntity.

hasIdProperty

public boolean hasIdProperty()

Description copied from interface: PersistentEntity

Returns whether the PersistentEntity has an id property. If this call returns true, PersistentEntity.getIdProperty() will return a non-null value.

Specified by:

hasIdProperty in interface PersistentEntity<T,P extends PersistentProperty<P>>

hasVersionProperty

public boolean hasVersionProperty()

Description copied from interface: PersistentEntity

Returns whether the PersistentEntity has a version property. If this call returns true, PersistentEntity.getVersionProperty() will return a non-null value.

Specified by:

hasVersionProperty in interface PersistentEntity<T,P extends PersistentProperty<P>>

addPersistentProperty

public void addPersistentProperty(P property)

Description copied from interface: MutablePersistentEntity

Adds a PersistentProperty to the entity.

Specified by:

addPersistentProperty in interface MutablePersistentEntity<T,P extends PersistentProperty<P>>

returnPropertyIfBetterIdPropertyCandidateOrNull

protected P returnPropertyIfBetterIdPropertyCandidateOrNull(P property)

Returns the given property if it is a better candidate for the id property than the current id property.

Parameters:

property - the new id property candidate, will never be null.

Returns:

the given id property or null if the given property is not an id property.

addAssociation

public void addAssociation(Association<P> association)

Description copied from interface: MutablePersistentEntity

Adds an Association to the entity.

Specified by:

addAssociation in interface MutablePersistentEntity<T,P extends PersistentProperty<P>>

getPersistentProperty

public P getPersistentProperty(String name)

Description copied from interface: PersistentEntity

Obtains a PersistentProperty instance by name.

Specified by:

getPersistentProperty in interface PersistentEntity<T,P extends PersistentProperty<P>>

Parameters:

name - The name of the property

Returns:

the PersistentProperty or null if it doesn't exist.

getPersistentProperty

public P getPersistentProperty(Class<? extends Annotation> annotationType)

Description copied from interface: PersistentEntity

Returns the property equipped with an annotation of the given type.

Specified by:

getPersistentProperty in interface PersistentEntity<T,P extends PersistentProperty<P>>

Parameters:

annotationType - must not be null.

Returns:

getType

public Class<T> getType()

Description copied from interface: PersistentEntity

Returns the resolved Java type of this entity.

Specified by:

getType in interface PersistentEntity<T,P extends PersistentProperty<P>>

Returns:

The underlying Java class for this entity

getTypeAlias

public Object getTypeAlias()

Description copied from interface: PersistentEntity

Returns the alias to be used when storing type information. Might be null to indicate that there was no alias defined through the mapping metadata.

Specified by:

getTypeAlias in interface PersistentEntity<T,P extends PersistentProperty<P>>

Returns:

getTypeInformation

public TypeInformation<T> getTypeInformation()

Description copied from interface: PersistentEntity

Returns the TypeInformation backing this PersistentEntity.

Specified by:

getTypeInformation in interface PersistentEntity<T,P extends PersistentProperty<P>>

Returns:

doWithProperties

public void doWithProperties(PropertyHandler<P> handler)

Description copied from interface: PersistentEntity

Applies the given PropertyHandler to all PersistentPropertys contained in this PersistentEntity.

Specified by:

doWithProperties in interface PersistentEntity<T,P extends PersistentProperty<P>>

Parameters:

handler - must not be null.

doWithProperties

public void doWithProperties(SimplePropertyHandler handler)

Specified by:

doWithProperties in interface PersistentEntity<T,P extends PersistentProperty<P>>

doWithAssociations

public void doWithAssociations(AssociationHandler<P> handler)

Description copied from interface: PersistentEntity

Applies the given AssociationHandler to all Association contained in this PersistentEntity.

Specified by:

doWithAssociations in interface PersistentEntity<T,P extends PersistentProperty<P>>

Parameters:

handler - must not be null.

doWithAssociations

public void doWithAssociations(SimpleAssociationHandler handler)

Specified by:

doWithAssociations in interface PersistentEntity<T,P extends PersistentProperty<P>>

findAnnotation

public <A extends Annotation> A findAnnotation(Class<A> annotationType)

Description copied from interface: PersistentEntity

Looks up the annotation of the given type on the PersistentEntity.

Specified by:

findAnnotation in interface PersistentEntity<T,P extends PersistentProperty<P>>

Parameters:

annotationType - must not be null.

Returns:

verify

public void verify()

Description copied from interface: MutablePersistentEntity

Callback method to trigger validation of the PersistentEntity. As MutablePersistentEntity is not immutable there might be some verification steps necessary after the object has reached is final state.

Specified by:

verify in interface MutablePersistentEntity<T,P extends PersistentProperty<P>>

setPersistentPropertyAccessorFactory

public void setPersistentPropertyAccessorFactory(PersistentPropertyAccessorFactory factory)

Description copied from interface: MutablePersistentEntity

Sets the PersistentPropertyAccessorFactory for the entity. A PersistentPropertyAccessorFactory creates PersistentPropertyAccessors for instances of this entity.

Specified by:

setPersistentPropertyAccessorFactory in interface MutablePersistentEntity<T,P extends PersistentProperty<P>>

Parameters:

factory - must not be null.

getPropertyAccessor

public PersistentPropertyAccessor getPropertyAccessor(Object bean)

Description copied from interface: PersistentEntity

Returns a PersistentPropertyAccessor to access property values of the given bean.

Specified by:

getPropertyAccessor in interface PersistentEntity<T,P extends PersistentProperty<P>>

Parameters:

bean - must not be null.

Returns:

getIdentifierAccessor

public IdentifierAccessor getIdentifierAccessor(Object bean)

Description copied from interface: PersistentEntity

Returns the IdentifierAccessor for the given bean.

Specified by:

getIdentifierAccessor in interface PersistentEntity<T,P extends PersistentProperty<P>>

Parameters:

bean - must not be null.

Returns: