org.broadleafcommerce.admin.server.service.handler

Class SkuCustomPersistenceHandler

java.lang.Object

org.broadleafcommerce.openadmin.server.service.handler.CustomPersistenceHandlerAdapter

org.broadleafcommerce.admin.server.service.handler.SkuCustomPersistenceHandler

All Implemented Interfaces:

CustomPersistenceHandler, org.springframework.core.Ordered

@Component(value="blSkuCustomPersistenceHandler")
public class SkuCustomPersistenceHandler
extends CustomPersistenceHandlerAdapter

Author:

Phillip Verheyden

Field Summary

Fields

Modifier and Type	Field and Description
protected PersistenceModule	adornedPersistenceModule
protected int	cacheEntityMetaDataTtl
protected CatalogService	catalogService
static String	CONSOLIDATED_PRODUCT_OPTIONS_DELIMETER
static String	CONSOLIDATED_PRODUCT_OPTIONS_FIELD_NAME This represents the field that all of the product option values will be stored in.
protected javax.persistence.EntityManager	em
protected SkuCustomPersistenceHandlerExtensionManager	extensionManager
protected long	lastCacheFlushTime
protected static Map<String,Map<String,FieldMetadata>>	METADATA_CACHE
static String	PRODUCT_OPTION_FIELD_PREFIX
protected boolean	useSku

Fields inherited from interface org.broadleafcommerce.openadmin.server.service.handler.CustomPersistenceHandler

DEFAULT_ORDER

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor and Description
SkuCustomPersistenceHandler()

Method Summary

Methods

Modifier and Type	Method and Description
Entity	add(PersistencePackage persistencePackage, DynamicEntityDao dynamicEntityDao, RecordHelper helper)
void	applyAdditionalFetchCriteria(List<FilterMapping> filterMappings, CriteriaTransferObject cto, PersistencePackage persistencePackage) Available override point for subclasses if they would like to add additional criteria via the queryCritiera.
void	applyProductOptionValueCriteria(List<FilterMapping> filterMappings, CriteriaTransferObject cto, PersistencePackage persistencePackage, String skuPropertyPrefix)
protected void	associateProductOptionValuesToSku(Entity entity, Sku adminInstance, DynamicEntityDao dynamicEntityDao) This initially removes all of the product option values that are currently related to the Sku and then re-associates the ProductOptionValues
protected Boolean	canHandle(PersistencePackage persistencePackage, OperationType operationType) Since this is the default for all Skus, it's possible that we are providing custom criteria for this Sku lookup.
Boolean	canHandleAdd(PersistencePackage persistencePackage) Is this persistence handler capable of dealing with an add request from the admin
Boolean	canHandleFetch(PersistencePackage persistencePackage) Is this persistence handler capable of dealing with an fetch request from the admin
Boolean	canHandleInspect(PersistencePackage persistencePackage) Is this persistence handler capable of dealing with an inspect request from the admin
Boolean	canHandleUpdate(PersistencePackage persistencePackage) Is this persistence handler capable of dealing with an update request from the admin
FieldMetadata	createConsolidatedOptionField(Class<?> inheritedFromType) Creates the metadata necessary for displaying all of the product option values in a single field.
FieldMetadata	createIndividualOptionField(ProductOption option, int order) Creates an individual property for the specified product option.
DynamicResultSet	fetch(PersistencePackage persistencePackage, CriteriaTransferObject cto, DynamicEntityDao dynamicEntityDao, RecordHelper helper)
protected void	filterOutProductMetadata(Map<String,FieldMetadata> map)
Property	getBlankConsolidatedOptionProperty()
Property	getConsolidatedOptionProperty(Collection<ProductOptionValue> values) Returns a Property filled out with a delimited list of the values that are passed in.
protected String[]	getPolymorphicClasses(Class<?> clazz)
protected List<Property>	getProductOptionProperties(Entity entity)
DynamicResultSet	inspect(PersistencePackage persistencePackage, DynamicEntityDao dynamicEntityDao, InspectHelper helper) Build out the extra fields for the product options
Entity	update(PersistencePackage persistencePackage, DynamicEntityDao dynamicEntityDao, RecordHelper helper)
protected boolean	useCache()
protected Entity	validateUniqueProductOptionValueCombination(Product product, List<Property> productOptionProperties, Sku currentSku) Ensures that the given list of ProductOptionValue IDs is unique for the given Product.

Methods inherited from class org.broadleafcommerce.openadmin.server.service.handler.CustomPersistenceHandlerAdapter

canHandleRemove, getMetadata, getOrder, getResultSet, remove, willHandleSecurity

Methods inherited from class java.lang.Object

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

Field Detail

PRODUCT_OPTION_FIELD_PREFIX

public static String PRODUCT_OPTION_FIELD_PREFIX

useSku

@Value(value="${solr.index.use.sku}")
protected boolean useSku

cacheEntityMetaDataTtl

@Value(value="${cache.entity.dao.metadata.ttl}")
protected int cacheEntityMetaDataTtl

lastCacheFlushTime

protected long lastCacheFlushTime

METADATA_CACHE

protected static final Map<String,Map<String,FieldMetadata>> METADATA_CACHE

adornedPersistenceModule

protected PersistenceModule adornedPersistenceModule

extensionManager

protected SkuCustomPersistenceHandlerExtensionManager extensionManager

CONSOLIDATED_PRODUCT_OPTIONS_FIELD_NAME

public static String CONSOLIDATED_PRODUCT_OPTIONS_FIELD_NAME

This represents the field that all of the product option values will be stored in. This would be used in the case where there are a bunch of product options and displaying each option as a grid header would have everything squashed together. Filtering on this field is currently unsupported.

CONSOLIDATED_PRODUCT_OPTIONS_DELIMETER

public static String CONSOLIDATED_PRODUCT_OPTIONS_DELIMETER

catalogService

protected CatalogService catalogService

em

protected javax.persistence.EntityManager em

Constructor Detail

SkuCustomPersistenceHandler

public SkuCustomPersistenceHandler()

Method Detail

canHandleInspect

public Boolean canHandleInspect(PersistencePackage persistencePackage)

Description copied from interface: CustomPersistenceHandler

Is this persistence handler capable of dealing with an inspect request from the admin

Specified by:

canHandleInspect in interface CustomPersistenceHandler

Overrides:

canHandleInspect in class CustomPersistenceHandlerAdapter

Parameters:

persistencePackage - details about the inspect operation

Returns:

whether or not this handler supports inspects

canHandleFetch

public Boolean canHandleFetch(PersistencePackage persistencePackage)

Description copied from interface: CustomPersistenceHandler

Is this persistence handler capable of dealing with an fetch request from the admin

Specified by:

canHandleFetch in interface CustomPersistenceHandler

Overrides:

canHandleFetch in class CustomPersistenceHandlerAdapter

Parameters:

persistencePackage - details about the fetch operation

Returns:

whether or not this handler supports fetches

canHandleAdd

public Boolean canHandleAdd(PersistencePackage persistencePackage)

Description copied from interface: CustomPersistenceHandler

Is this persistence handler capable of dealing with an add request from the admin

Specified by:

canHandleAdd in interface CustomPersistenceHandler

Overrides:

canHandleAdd in class CustomPersistenceHandlerAdapter

Parameters:

persistencePackage - details about the add operation

Returns:

whether or not this handler supports adds

canHandleUpdate

public Boolean canHandleUpdate(PersistencePackage persistencePackage)

Description copied from interface: CustomPersistenceHandler

Is this persistence handler capable of dealing with an update request from the admin

Specified by:

canHandleUpdate in interface CustomPersistenceHandler

Overrides:

canHandleUpdate in class CustomPersistenceHandlerAdapter

Parameters:

persistencePackage - details about the update operation

Returns:

whether or not this handler supports updatess

useCache

protected boolean useCache()

canHandle

protected Boolean canHandle(PersistencePackage persistencePackage,
                OperationType operationType)

Since this is the default for all Skus, it's possible that we are providing custom criteria for this Sku lookup. In that case, we probably want to delegate to a child class, so only use this particular persistence handler if there is no custom criteria being used and the ceiling entity is an instance of Sku. The exception to this rule is when we are pulling back Media, since the admin actually uses Sku for the ceiling entity class name. That should be handled by the map structure module though, so only handle things in the Sku custom persistence handler for OperationType.BASIC

inspect

public DynamicResultSet inspect(PersistencePackage persistencePackage,
                       DynamicEntityDao dynamicEntityDao,
                       InspectHelper helper)
                         throws ServiceException

Build out the extra fields for the product options

Specified by:

inspect in interface CustomPersistenceHandler

Overrides:

inspect in class CustomPersistenceHandlerAdapter

Throws:

ServiceException

filterOutProductMetadata

protected void filterOutProductMetadata(Map<String,FieldMetadata> map)

createConsolidatedOptionField

public FieldMetadata createConsolidatedOptionField(Class<?> inheritedFromType)

Creates the metadata necessary for displaying all of the product option values in a single field. The display of this field is a single string with every product option value appended to it separated by a semicolon. This method should be invoked on an inspect for whatever is utilizing this so that the property will be ready to be populated on fetch. The metadata that is returned will also be set to prominent by default so that it will be ready to display on whatever grid is being inspected. If you do not want this behavior you will need to override this functionality in the metadata that is returned.

Parameters:

inheritedFromType - which type this should appear on. This would normally be SkuImpl.class, but if you want to display this field with a different entity then this should be that entity

Returns:

getPolymorphicClasses

protected String[] getPolymorphicClasses(Class<?> clazz)

getConsolidatedOptionProperty

public Property getConsolidatedOptionProperty(Collection<ProductOptionValue> values)

Returns a Property filled out with a delimited list of the values that are passed in. This should be invoked on a fetch and the returned property should be added to the fetched Entity dto.

Parameters:

values -

Returns:

See Also:

#createConsolidatedOptionField(Class)};

getBlankConsolidatedOptionProperty

public Property getBlankConsolidatedOptionProperty()

Returns:

a blank Property corresponding to the CONSOLIDATED_PRODUCT_OPTIONS_FIELD_NAME

createIndividualOptionField

public FieldMetadata createIndividualOptionField(ProductOption option,
                                        int order)

Creates an individual property for the specified product option. This should set up an enum field whose values will be the option values for this option. This is useful when you would like to display each product option in as its own field in a grid so that you can further filter by product option values.

In order for these fields to be utilized property on the fetch, in the GWT frontend you must use the for your datasource.

Parameters:

option -

order -

Returns:

fetch

public DynamicResultSet fetch(PersistencePackage persistencePackage,
                     CriteriaTransferObject cto,
                     DynamicEntityDao dynamicEntityDao,
                     RecordHelper helper)
                       throws ServiceException

Specified by:

fetch in interface CustomPersistenceHandler

Overrides:

fetch in class CustomPersistenceHandlerAdapter

Throws:

ServiceException

applyProductOptionValueCriteria

public void applyProductOptionValueCriteria(List<FilterMapping> filterMappings,
                                   CriteriaTransferObject cto,
                                   PersistencePackage persistencePackage,
                                   String skuPropertyPrefix)

applyAdditionalFetchCriteria

public void applyAdditionalFetchCriteria(List<FilterMapping> filterMappings,
                                CriteriaTransferObject cto,
                                PersistencePackage persistencePackage)

Available override point for subclasses if they would like to add additional criteria via the queryCritiera. At the point that this method has been called, criteria from the frontend has already been applied, thus allowing you to override from there as well.

Subclasses that choose to override this should also call this super method so that correct filter criteria can be applied for product option values

add

public Entity add(PersistencePackage persistencePackage,
         DynamicEntityDao dynamicEntityDao,
         RecordHelper helper)
           throws ServiceException

Specified by:

add in interface CustomPersistenceHandler

Overrides:

add in class CustomPersistenceHandlerAdapter

Throws:

ServiceException

update

public Entity update(PersistencePackage persistencePackage,
            DynamicEntityDao dynamicEntityDao,
            RecordHelper helper)
              throws ServiceException

Specified by:

update in interface CustomPersistenceHandler

Overrides:

update in class CustomPersistenceHandlerAdapter

Throws:

ServiceException

associateProductOptionValuesToSku

protected void associateProductOptionValuesToSku(Entity entity,
                                     Sku adminInstance,
                                     DynamicEntityDao dynamicEntityDao)

This initially removes all of the product option values that are currently related to the Sku and then re-associates the ProductOptionValues

Parameters:

entity -

adminInstance -

getProductOptionProperties

protected List<Property> getProductOptionProperties(Entity entity)

validateUniqueProductOptionValueCombination

protected Entity validateUniqueProductOptionValueCombination(Product product,
                                                 List<Property> productOptionProperties,
                                                 Sku currentSku)

Ensures that the given list of ProductOptionValue IDs is unique for the given Product. If sku browsing is enabled, then it is assumed that a single combination of ProductOptionValue IDs is not unique and more than one Sku could have the exact same combination of ProductOptionValue IDs. In this case, the following validation is skipped.

Parameters:

product -

productOptionValueIds -

currentSku - - for update operations, this is the current Sku that is being updated; should be excluded from attempting validation

Returns:

null if successfully validation, the error entity otherwise