org.broadleafcommerce.openadmin.server.service.persistence.module

Class BasicPersistenceModule

java.lang.Object

org.broadleafcommerce.openadmin.server.service.persistence.module.BasicPersistenceModule

All Implemented Interfaces:

DataFormatProvider, PersistenceModule, RecordHelper, org.springframework.beans.factory.Aware, org.springframework.context.ApplicationContextAware

Direct Known Subclasses:

AdornedTargetListPersistenceModule, MapStructurePersistenceModule

@Component(value="blBasicPersistenceModule")
 @Scope(value="prototype")
public class BasicPersistenceModule
extends java.lang.Object
implements PersistenceModule, RecordHelper, org.springframework.context.ApplicationContextAware

Author:

jfischer

Field Summary

Fields

Modifier and Type	Field and Description
protected org.springframework.context.ApplicationContext	applicationContext
protected CriteriaTranslator	criteriaTranslator
protected java.text.DecimalFormat	decimalFormat
protected FieldPersistenceProvider	defaultFieldPersistenceProvider
protected EntityValidatorService	entityValidatorService
protected java.util.List<FieldPersistenceProvider>	fieldPersistenceProviders
static java.lang.String	MAIN_ENTITY_NAME_PROPERTY
protected PersistenceManager	persistenceManager
protected java.util.List<PopulateValueRequestValidator>	populateValidators
protected RestrictionFactory	restrictionFactory

Constructor Summary

Constructors

Constructor and Description
BasicPersistenceModule()

Method Summary

Modifier and Type	Method and Description
Entity	add(PersistencePackage persistencePackage)
EntityResult	add(PersistencePackage persistencePackage, boolean includeRealEntityObject)
java.io.Serializable	createPopulatedInstance(java.io.Serializable instance, Entity entity, java.util.Map<java.lang.String,FieldMetadata> unfilteredProperties, java.lang.Boolean setId) Populates a Hibernate entity instance based on the values from entity (the DTO representation of instance) and the metadata from mergedProperties.
void	extractProperties(java.lang.Class<?>[] inheritanceLine, java.util.Map<MergedPropertyType,java.util.Map<java.lang.String,FieldMetadata>> mergedProperties, java.util.List<Property> properties)
protected void	extractPropertiesFromMetadata(java.lang.Class<?>[] inheritanceLine, java.util.Map<java.lang.String,FieldMetadata> mergedProperties, java.util.List<Property> properties, java.lang.Boolean isHiddenOverride, MergedPropertyType type)
protected void	extractPropertiesFromPersistentEntity(java.util.Map<java.lang.String,FieldMetadata> mergedProperties, java.io.Serializable entity, java.util.List<Property> props)
DynamicResultSet	fetch(PersistencePackage persistencePackage, CriteriaTransferObject cto)
protected java.util.Map<java.lang.String,FieldMetadata>	filterOutCollectionMetadata(java.util.Map<java.lang.String,FieldMetadata> metadata)
java.lang.String	formatValue(java.lang.Object value) Formats a aw value from an entity into its string representation used by the system.
protected java.lang.Class<?>	getBasicBroadleafType(SupportedFieldType fieldType)
PersistenceModule	getCompatibleModule(OperationType operationType)
CriteriaTranslator	getCriteriaTranslator()
java.text.DecimalFormat	getDecimalFormatter()
FieldPersistenceProvider	getDefaultFieldPersistenceProvider()
EntityValidatorService	getEntityValidatorService()
FieldManager	getFieldManager()
java.util.List<FieldPersistenceProvider>	getFieldPersistenceProviders()
java.util.List<FilterMapping>	getFilterMappings(PersistencePerspective persistencePerspective, CriteriaTransferObject cto, java.lang.String ceilingEntityFullyQualifiedClassname, java.util.Map<java.lang.String,FieldMetadata> mergedUnfilteredProperties)
java.util.List<FilterMapping>	getFilterMappings(PersistencePerspective persistencePerspective, CriteriaTransferObject cto, java.lang.String ceilingEntityFullyQualifiedClassname, java.util.Map<java.lang.String,FieldMetadata> mergedUnfilteredProperties, RestrictionFactory customRestrictionFactory)
protected java.lang.Class<?>	getMapFieldType(java.io.Serializable instance, FieldManager fieldManager, Property property)
PersistenceManager	getPersistenceManager()
java.util.List<java.io.Serializable>	getPersistentRecords(java.lang.String ceilingEntity, java.util.List<FilterMapping> filterMappings, java.lang.Integer firstResult, java.lang.Integer maxResults)
java.lang.Object	getPrimaryKey(Entity entity, java.util.Map<java.lang.String,FieldMetadata> mergedUnfilteredProperties)
Entity	getRecord(java.lang.Class<?> ceilingEntityClass, PersistencePerspective persistencePerspective, java.io.Serializable record)
Entity	getRecord(java.util.Map<java.lang.String,FieldMetadata> primaryMergedProperties, java.io.Serializable record, java.util.Map<java.lang.String,FieldMetadata> alternateMergedProperties, java.lang.String pathToTargetObject)
Entity[]	getRecords(java.lang.Class<?> ceilingEntityClass, PersistencePerspective persistencePerspective, java.util.List<? extends java.io.Serializable> records)
Entity[]	getRecords(java.util.Map<java.lang.String,FieldMetadata> primaryMergedProperties, java.util.List<? extends java.io.Serializable> records)
Entity[]	getRecords(java.util.Map<java.lang.String,FieldMetadata> primaryUnfilteredMergedProperties, java.util.List<? extends java.io.Serializable> records, java.util.Map<java.lang.String,FieldMetadata> alternateUnfilteredMergedProperties, java.lang.String pathToTargetObject)
RestrictionFactory	getRestrictionFactory()
java.text.SimpleDateFormat	getSimpleDateFormatter()
java.util.Map<java.lang.String,FieldMetadata>	getSimpleMergedProperties(java.lang.String entityName, PersistencePerspective persistencePerspective)
java.lang.String	getStringValueFromGetter(java.io.Serializable instance, java.lang.String propertyName) Returns a string representation of the field on the given instance specified by the property name.
java.lang.Integer	getTotalRecords(java.lang.String ceilingEntity, java.util.List<FilterMapping> filterMappings)
boolean	isCompatible(OperationType operationType)
void	remove(PersistencePackage persistencePackage)
void	setApplicationContext(org.springframework.context.ApplicationContext applicationContext)
void	setCriteriaTranslator(CriteriaTranslator criteriaTranslator)
void	setDefaultFieldPersistenceProvider(FieldPersistenceProvider defaultFieldPersistenceProvider)
void	setEntityValidatorService(EntityValidatorService entityValidatorService)
void	setFieldPersistenceProviders(java.util.List<FieldPersistenceProvider> fieldPersistenceProviders)
void	setPersistenceManager(PersistenceManager persistenceManager)
void	setRestrictionFactory(RestrictionFactory restrictionFactory)
Entity	update(PersistencePackage persistencePackage)
EntityResult	update(PersistencePackage persistencePackage, boolean includeRealEntityObject)
protected EntityResult	update(PersistencePackage persistencePackage, java.lang.Object primaryKey, boolean includeRealEntity)
void	updateMergedProperties(PersistencePackage persistencePackage, java.util.Map<MergedPropertyType,java.util.Map<java.lang.String,FieldMetadata>> allMergedProperties)
boolean	validate(Entity entity, java.io.Serializable populatedInstance, java.util.Map<java.lang.String,FieldMetadata> mergedProperties) Validates the Entity based on the validators associated with each property

Methods inherited from class java.lang.Object

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

Field Detail

MAIN_ENTITY_NAME_PROPERTY

public static final java.lang.String MAIN_ENTITY_NAME_PROPERTY

See Also:

Constant Field Values

decimalFormat

protected java.text.DecimalFormat decimalFormat

applicationContext

protected org.springframework.context.ApplicationContext applicationContext

persistenceManager

protected PersistenceManager persistenceManager

entityValidatorService

protected EntityValidatorService entityValidatorService

fieldPersistenceProviders

protected java.util.List<FieldPersistenceProvider> fieldPersistenceProviders

populateValidators

protected java.util.List<PopulateValueRequestValidator> populateValidators

defaultFieldPersistenceProvider

protected FieldPersistenceProvider defaultFieldPersistenceProvider

criteriaTranslator

protected CriteriaTranslator criteriaTranslator

restrictionFactory

protected RestrictionFactory restrictionFactory

Constructor Detail

BasicPersistenceModule

public BasicPersistenceModule()

Method Detail

setApplicationContext

public void setApplicationContext(org.springframework.context.ApplicationContext applicationContext)
                           throws org.springframework.beans.BeansException

Specified by:

setApplicationContext in interface org.springframework.context.ApplicationContextAware

Throws:

org.springframework.beans.BeansException

isCompatible

public boolean isCompatible(OperationType operationType)

Specified by:

isCompatible in interface PersistenceModule

getFieldManager

public FieldManager getFieldManager()

Specified by:

getFieldManager in interface RecordHelper

getDecimalFormatter

public java.text.DecimalFormat getDecimalFormatter()

Specified by:

getDecimalFormatter in interface DataFormatProvider

getSimpleDateFormatter

public java.text.SimpleDateFormat getSimpleDateFormatter()

Specified by:

getSimpleDateFormatter in interface DataFormatProvider

filterOutCollectionMetadata

protected java.util.Map<java.lang.String,FieldMetadata> filterOutCollectionMetadata(java.util.Map<java.lang.String,FieldMetadata> metadata)

getBasicBroadleafType

protected java.lang.Class<?> getBasicBroadleafType(SupportedFieldType fieldType)

createPopulatedInstance

public java.io.Serializable createPopulatedInstance(java.io.Serializable instance,
                                                    Entity entity,
                                                    java.util.Map<java.lang.String,FieldMetadata> unfilteredProperties,
                                                    java.lang.Boolean setId)
                                             throws ValidationException

Description copied from interface: RecordHelper

Populates a Hibernate entity instance based on the values from entity (the DTO representation of instance) and the metadata from mergedProperties.

While populating instance, validation is also performed using the EntityValidatorService. If this validation fails, then the instance is left unchanged and a ValidationExcpetion is thrown. In the common case, this exception bubbles up to the DynamicRemoteService which catches the exception and communicates appropriately to the invoker

Specified by:

createPopulatedInstance in interface RecordHelper

Returns:

instance populated with the property values from entity according to the metadata specified in mergedProperties

Throws:

ValidationException - if after populating instance via the values in entity then EntityValidatorService.validate(Entity, Serializable, Map) returns false

See Also:

EntityValidatorService}

getMapFieldType

protected java.lang.Class<?> getMapFieldType(java.io.Serializable instance,
                                             FieldManager fieldManager,
                                             Property property)

getRecord

public Entity getRecord(java.util.Map<java.lang.String,FieldMetadata> primaryMergedProperties,
                        java.io.Serializable record,
                        java.util.Map<java.lang.String,FieldMetadata> alternateMergedProperties,
                        java.lang.String pathToTargetObject)

Specified by:

getRecord in interface RecordHelper

getRecord

public Entity getRecord(java.lang.Class<?> ceilingEntityClass,
                        PersistencePerspective persistencePerspective,
                        java.io.Serializable record)

Specified by:

getRecord in interface RecordHelper

getRecords

public Entity[] getRecords(java.lang.Class<?> ceilingEntityClass,
                           PersistencePerspective persistencePerspective,
                           java.util.List<? extends java.io.Serializable> records)

Specified by:

getRecords in interface RecordHelper

getSimpleMergedProperties

public java.util.Map<java.lang.String,FieldMetadata> getSimpleMergedProperties(java.lang.String entityName,
                                                                               PersistencePerspective persistencePerspective)

Specified by:

getSimpleMergedProperties in interface RecordHelper

getRecords

public Entity[] getRecords(java.util.Map<java.lang.String,FieldMetadata> primaryMergedProperties,
                           java.util.List<? extends java.io.Serializable> records)

Specified by:

getRecords in interface RecordHelper

getRecords

public Entity[] getRecords(java.util.Map<java.lang.String,FieldMetadata> primaryUnfilteredMergedProperties,
                           java.util.List<? extends java.io.Serializable> records,
                           java.util.Map<java.lang.String,FieldMetadata> alternateUnfilteredMergedProperties,
                           java.lang.String pathToTargetObject)

Specified by:

getRecords in interface RecordHelper

extractPropertiesFromPersistentEntity

protected void extractPropertiesFromPersistentEntity(java.util.Map<java.lang.String,FieldMetadata> mergedProperties,
                                                     java.io.Serializable entity,
                                                     java.util.List<Property> props)

getStringValueFromGetter

public java.lang.String getStringValueFromGetter(java.io.Serializable instance,
                                                 java.lang.String propertyName)
                                          throws java.lang.IllegalAccessException,
                                                 java.lang.reflect.InvocationTargetException,
                                                 java.lang.NoSuchMethodException

Description copied from interface: RecordHelper

Returns a string representation of the field on the given instance specified by the property name. The propertyName should start from the root of the given instance

Specified by:

getStringValueFromGetter in interface RecordHelper

Returns:

Throws:

java.lang.IllegalAccessException

java.lang.reflect.InvocationTargetException

java.lang.NoSuchMethodException

formatValue

public java.lang.String formatValue(java.lang.Object value)

Description copied from interface: DataFormatProvider

Formats a aw value from an entity into its string representation used by the system. For instance, this might use the DataFormatProvider.getDecimalFormatter() to ensure that BigDecimals only show 2 decimal places or dates are formatted a certain way.

Specified by:

formatValue in interface DataFormatProvider

Returns:

update

protected EntityResult update(PersistencePackage persistencePackage,
                              java.lang.Object primaryKey,
                              boolean includeRealEntity)
                       throws ServiceException

Throws:

ServiceException

getPrimaryKey

public java.lang.Object getPrimaryKey(Entity entity,
                                      java.util.Map<java.lang.String,FieldMetadata> mergedUnfilteredProperties)

Specified by:

getPrimaryKey in interface RecordHelper

getFilterMappings

public java.util.List<FilterMapping> getFilterMappings(PersistencePerspective persistencePerspective,
                                                       CriteriaTransferObject cto,
                                                       java.lang.String ceilingEntityFullyQualifiedClassname,
                                                       java.util.Map<java.lang.String,FieldMetadata> mergedUnfilteredProperties,
                                                       RestrictionFactory customRestrictionFactory)

Specified by:

getFilterMappings in interface RecordHelper

getFilterMappings

public java.util.List<FilterMapping> getFilterMappings(PersistencePerspective persistencePerspective,
                                                       CriteriaTransferObject cto,
                                                       java.lang.String ceilingEntityFullyQualifiedClassname,
                                                       java.util.Map<java.lang.String,FieldMetadata> mergedUnfilteredProperties)

Specified by:

getFilterMappings in interface RecordHelper

extractProperties

public void extractProperties(java.lang.Class<?>[] inheritanceLine,
                              java.util.Map<MergedPropertyType,java.util.Map<java.lang.String,FieldMetadata>> mergedProperties,
                              java.util.List<Property> properties)

Specified by:

extractProperties in interface PersistenceModule

extractPropertiesFromMetadata

protected void extractPropertiesFromMetadata(java.lang.Class<?>[] inheritanceLine,
                                             java.util.Map<java.lang.String,FieldMetadata> mergedProperties,
                                             java.util.List<Property> properties,
                                             java.lang.Boolean isHiddenOverride,
                                             MergedPropertyType type)

updateMergedProperties

public void updateMergedProperties(PersistencePackage persistencePackage,
                                   java.util.Map<MergedPropertyType,java.util.Map<java.lang.String,FieldMetadata>> allMergedProperties)
                            throws ServiceException

Specified by:

updateMergedProperties in interface PersistenceModule

Throws:

ServiceException

update

public EntityResult update(PersistencePackage persistencePackage,
                           boolean includeRealEntityObject)
                    throws ServiceException

Specified by:

update in interface RecordHelper

Throws:

ServiceException

update

public Entity update(PersistencePackage persistencePackage)
              throws ServiceException

Specified by:

update in interface PersistenceModule

Throws:

ServiceException

add

public Entity add(PersistencePackage persistencePackage)
           throws ServiceException

Specified by:

add in interface PersistenceModule

Throws:

ServiceException

add

public EntityResult add(PersistencePackage persistencePackage,
                        boolean includeRealEntityObject)
                 throws ServiceException

Specified by:

add in interface RecordHelper

Throws:

ServiceException

remove

public void remove(PersistencePackage persistencePackage)
            throws ServiceException

Specified by:

remove in interface PersistenceModule

Throws:

ServiceException

fetch

public DynamicResultSet fetch(PersistencePackage persistencePackage,
                              CriteriaTransferObject cto)
                       throws ServiceException

Specified by:

fetch in interface PersistenceModule

Throws:

ServiceException

getTotalRecords

public java.lang.Integer getTotalRecords(java.lang.String ceilingEntity,
                                         java.util.List<FilterMapping> filterMappings)

Specified by:

getTotalRecords in interface RecordHelper

getPersistentRecords

public java.util.List<java.io.Serializable> getPersistentRecords(java.lang.String ceilingEntity,
                                                                 java.util.List<FilterMapping> filterMappings,
                                                                 java.lang.Integer firstResult,
                                                                 java.lang.Integer maxResults)

Specified by:

getPersistentRecords in interface RecordHelper

validate

public boolean validate(Entity entity,
                        java.io.Serializable populatedInstance,
                        java.util.Map<java.lang.String,FieldMetadata> mergedProperties)

Description copied from interface: RecordHelper

Validates the Entity based on the validators associated with each property

Specified by:

validate in interface RecordHelper

Parameters:

entity - the instance that is attempted to be saved from. Implementers should set Entity.isValidationFailure() accordingly as a result of the validation

mergedProperties - TODO

Returns:

whether or not the entity passed validation. This yields the same result as calling !Entity.isValidationFailure() after invoking this method

setPersistenceManager

public void setPersistenceManager(PersistenceManager persistenceManager)

Specified by:

setPersistenceManager in interface PersistenceModule

getCompatibleModule

public PersistenceModule getCompatibleModule(OperationType operationType)

Specified by:

getCompatibleModule in interface RecordHelper

getDefaultFieldPersistenceProvider

public FieldPersistenceProvider getDefaultFieldPersistenceProvider()

setDefaultFieldPersistenceProvider

public void setDefaultFieldPersistenceProvider(FieldPersistenceProvider defaultFieldPersistenceProvider)

getFieldPersistenceProviders

public java.util.List<FieldPersistenceProvider> getFieldPersistenceProviders()

setFieldPersistenceProviders

public void setFieldPersistenceProviders(java.util.List<FieldPersistenceProvider> fieldPersistenceProviders)

getCriteriaTranslator

public CriteriaTranslator getCriteriaTranslator()

setCriteriaTranslator

public void setCriteriaTranslator(CriteriaTranslator criteriaTranslator)

getEntityValidatorService

public EntityValidatorService getEntityValidatorService()

setEntityValidatorService

public void setEntityValidatorService(EntityValidatorService entityValidatorService)

getRestrictionFactory

public RestrictionFactory getRestrictionFactory()

setRestrictionFactory

public void setRestrictionFactory(RestrictionFactory restrictionFactory)

getPersistenceManager

public PersistenceManager getPersistenceManager()