Class DefaultCartItemMergingService<I extends com.broadleafcommerce.cart.client.domain.CartItem>
java.lang.Object
com.broadleafcommerce.cartoperation.service.AbstractItemMergingService<com.broadleafcommerce.cart.client.domain.Cart,I>
com.broadleafcommerce.cartoperation.service.DefaultCartItemMergingService<I>
- All Implemented Interfaces:
CartItemMergingService<I>,ItemMergingService<com.broadleafcommerce.cart.client.domain.Cart,I>
public class DefaultCartItemMergingService<I extends com.broadleafcommerce.cart.client.domain.CartItem>
extends AbstractItemMergingService<com.broadleafcommerce.cart.client.domain.Cart,I>
implements CartItemMergingService<I>
The default implementation of a cart item merging service.
- Author:
- Skye Pekerti
-
Constructor Summary
ConstructorsConstructorDescriptionDefaultCartItemMergingService(CartOperationServiceProviders providers, CartOperationServiceProperties properties, com.fasterxml.jackson.databind.ObjectMapper objectMapper) -
Method Summary
Modifier and TypeMethodDescriptionprotected CatalogItemRequestbuildCatalogItemRequest(@NonNull MergeItemPair<I> mergeItemPair, com.broadleafcommerce.data.tracking.core.context.ContextInfo context) Hook point to build theCatalogItemRequestand populate any additional attributes that should be passed to theCatalogProviderwhen fetching the catalog representation for merging the cart item.protected Collection<CatalogItemRequest>buildCatalogItemRequestsForMergeItem(@NonNull List<MergeItemPair<I>> mergeItemPairs, com.broadleafcommerce.data.tracking.core.context.ContextInfo context) protected voiddoMergeCombine(@NonNull MergeItemPair<I> itemPair) Perform the actual combination of two items (quantity change) for the combination merge type.protected Collection<I>getItemsFromContainer(@NonNull com.broadleafcommerce.cart.client.domain.Cart container, com.broadleafcommerce.data.tracking.core.context.ContextInfo context) Gets the from the item container.protected com.fasterxml.jackson.databind.ObjectMapperprotected CartOperationServicePropertiesprotected CartOperationServiceProvidersprotected com.broadleafcommerce.common.extension.TypeFactoryprotected StringhashMatchingCriteria(I item) Generates a hash for any information on the item that should be used to determine if they represent the same item configuration.protected StringidentifyCatalogItemKey(@NonNull MergeItemPair<I> mergeItemPair, com.broadleafcommerce.data.tracking.core.context.ContextInfo context) protected booleanisSameItem(@NonNull com.broadleafcommerce.cart.client.domain.CartItem item1, @NonNull com.broadleafcommerce.cart.client.domain.CartItem item2) Tells if two item instances are actually the same instance.protected voidresolveMergeTypes(@NonNull List<MergeItemPair<I>> mergeItemPairs, com.broadleafcommerce.data.tracking.core.context.ContextInfo context) Determines what merge types should be used for the items and applies it to the merge item pairs.voidsetTypeFactory(com.broadleafcommerce.common.extension.TypeFactory typeFactory) Methods inherited from class com.broadleafcommerce.cartoperation.service.AbstractItemMergingService
findMatchingItems, findMatchingItems, handleRejectedMerges, merge, mergeCombine, mergeIgnore, mergeItems, mergeSeparateMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface com.broadleafcommerce.cartoperation.service.ItemMergingService
mergeItems
-
Constructor Details
-
DefaultCartItemMergingService
public DefaultCartItemMergingService(CartOperationServiceProviders providers, CartOperationServiceProperties properties, com.fasterxml.jackson.databind.ObjectMapper objectMapper)
-
-
Method Details
-
getItemsFromContainer
protected Collection<I> getItemsFromContainer(@NonNull @NonNull com.broadleafcommerce.cart.client.domain.Cart container, @Nullable com.broadleafcommerce.data.tracking.core.context.ContextInfo context) Description copied from class:AbstractItemMergingServiceGets the from the item container.- Specified by:
getItemsFromContainerin classAbstractItemMergingService<com.broadleafcommerce.cart.client.domain.Cart,I extends com.broadleafcommerce.cart.client.domain.CartItem> - Parameters:
container- the container to fetch the items fromcontext- the context of the request- Returns:
- the items from the container
-
isSameItem
protected boolean isSameItem(@NonNull @NonNull com.broadleafcommerce.cart.client.domain.CartItem item1, @NonNull @NonNull com.broadleafcommerce.cart.client.domain.CartItem item2) Description copied from class:AbstractItemMergingServiceTells if two item instances are actually the same instance. This would typically be determined by something like the item ID. Note that this does NOT indicate that "these items are the same so they should be merged". This is used to prevent creating an item match with itself during an update scenario.- Specified by:
isSameItemin classAbstractItemMergingService<com.broadleafcommerce.cart.client.domain.Cart,I extends com.broadleafcommerce.cart.client.domain.CartItem> - Parameters:
item1- an item to compareitem2- another item to compare- Returns:
- true if the two items are referring to the same instance
-
hashMatchingCriteria
Generates a hash for any information on the item that should be used to determine if they represent the same item configuration. This implementation uses the following criteria:
- attribute choices, which are product options of type CART_ITEM_ATTRIBUTE or VARIANT_DISTINGUISHING
- sku, which uniquely identifies products and their variations
- merchandising context, which identifies selector products
- pricing key- Specified by:
hashMatchingCriteriain classAbstractItemMergingService<com.broadleafcommerce.cart.client.domain.Cart,I extends com.broadleafcommerce.cart.client.domain.CartItem> - Parameters:
item- the item to generate a hash for- Returns:
- a hashed string of some subset of the items attributes
-
resolveMergeTypes
protected void resolveMergeTypes(@NonNull @NonNull List<MergeItemPair<I>> mergeItemPairs, @Nullable com.broadleafcommerce.data.tracking.core.context.ContextInfo context) Description copied from class:AbstractItemMergingServiceDetermines what merge types should be used for the items and applies it to the merge item pairs.- Specified by:
resolveMergeTypesin classAbstractItemMergingService<com.broadleafcommerce.cart.client.domain.Cart,I extends com.broadleafcommerce.cart.client.domain.CartItem> - Parameters:
mergeItemPairs- the item pairs to resolve the merge types for
-
buildCatalogItemRequestsForMergeItem
protected Collection<CatalogItemRequest> buildCatalogItemRequestsForMergeItem(@NonNull @NonNull List<MergeItemPair<I>> mergeItemPairs, @Nullable com.broadleafcommerce.data.tracking.core.context.ContextInfo context) -
buildCatalogItemRequest
protected CatalogItemRequest buildCatalogItemRequest(@NonNull @NonNull MergeItemPair<I> mergeItemPair, @Nullable com.broadleafcommerce.data.tracking.core.context.ContextInfo context) Hook point to build theCatalogItemRequestand populate any additional attributes that should be passed to theCatalogProviderwhen fetching the catalog representation for merging the cart item.- Parameters:
mergeItemPair- theMergeItemPaircontaining the details for the item mergecontext- context information around sandbox and multitenant state- Returns:
- the populated
CatalogItemRequestfor theMergeItemPair
-
identifyCatalogItemKey
protected String identifyCatalogItemKey(@NonNull @NonNull MergeItemPair<I> mergeItemPair, @Nullable com.broadleafcommerce.data.tracking.core.context.ContextInfo context) -
doMergeCombine
Description copied from class:AbstractItemMergingServicePerform the actual combination of two items (quantity change) for the combination merge type.- Specified by:
doMergeCombinein classAbstractItemMergingService<com.broadleafcommerce.cart.client.domain.Cart,I extends com.broadleafcommerce.cart.client.domain.CartItem> - Parameters:
itemPair- the item pair to combine
-
getProviders
-
getProperties
-
getObjectMapper
protected com.fasterxml.jackson.databind.ObjectMapper getObjectMapper() -
getTypeFactory
protected com.broadleafcommerce.common.extension.TypeFactory getTypeFactory() -
setTypeFactory
@Autowired public void setTypeFactory(com.broadleafcommerce.common.extension.TypeFactory typeFactory)
-