Package org.broadleafcommerce.core.offer.service

Class OfferServiceUtilitiesImpl

java.lang.Object

org.broadleafcommerce.core.offer.service.OfferServiceUtilitiesImpl

All Implemented Interfaces:

OfferServiceUtilities

@Service("blOfferServiceUtilities")
public class OfferServiceUtilitiesImpl
extends Object
implements OfferServiceUtilities

Author:

bpolster

Field Summary

Fields

Modifier and Type	Field	Description
protected org.broadleafcommerce.common.service.GenericEntityService	entityService
protected OfferServiceExtensionManager	extensionManager
protected static final org.apache.commons.logging.Log	LOG
protected OfferDao	offerDao
protected PromotableItemFactory	promotableItemFactory
protected final PromotableOfferUtility	promotableOfferUtility

Constructor Summary

Constructors

Constructor	Description
OfferServiceUtilitiesImpl(PromotableOfferUtility promotableOfferUtility)

Method Summary

Modifier and Type	Method	Description
protected boolean	adjustmentIsNotGoodEnoughToBeApplied(PromotableCandidateItemOffer itemOffer, PromotableOrderItemPriceDetail detail)	The adjustment might not be better than the sale price.
void	applyAdjustmentsForItemPriceDetails(PromotableCandidateItemOffer itemOffer, List<PromotableOrderItemPriceDetail> itemPriceDetails)	Takes in a list of PromotableOrderItemPriceDetails and applies adjustments for all of the discounts that match the passed in offer.
void	applyOrderItemAdjustment(PromotableCandidateItemOffer itemOffer, PromotableOrderItemPriceDetail itemPriceDetail)	Used by applyAdjustments to create an OrderItemAdjustment from a CandidateOrderOffer and associates the OrderItemAdjustment to the OrderItem.
Map<Long,OrderItemPriceDetailAdjustment>	buildItemDetailAdjustmentMap(OrderItemPriceDetail itemDetail)	Builds a map from itemDetails for adjustment processing.
List<OrderItem>	buildOrderItemList(Order order)	Builds the list of order-items at the level they are being priced which includes splitting bundles that are being priced at the item level.
Map<OrderItem,PromotableOrderItem>	buildPromotableItemMap(PromotableOrder promotableOrder)	Builds a map from orderItem to promotableOrderItem.
OrderItem	findRelatedQualifierRoot(OrderItem relatedQualifier)	Given an orderItem, finds the top most parent order item.
org.broadleafcommerce.common.service.GenericEntityService	getGenericEntityService()
OfferDao	getOfferDao()
protected Comparator<PromotableOrderItemPriceDetail>	getPromotableItemComparator(boolean applyToSalePrice)
PromotableItemFactory	getPromotableItemFactory()
boolean	isAddOnOrderItem(OrderItem orderItem)	Determines whether or not the OrderItem was added by a Product Add-On
boolean	itemOfferCanBeApplied(PromotableCandidateItemOffer itemOffer, List<PromotableOrderItemPriceDetail> details)	Return false if a totalitarian or non-combinable offer has already been applied or if this offer is totalitarian or non-combinable and this order already has adjustments applied.
int	markQualifiersForCriteria(PromotableCandidateItemOffer itemOffer, OfferItemCriteria itemCriteria, List<PromotableOrderItemPriceDetail> priceDetails)	Returns the number of qualifiers marked for the passed in itemCriteria
int	markRelatedQualifiersAndTargetsForItemCriteria(PromotableCandidateItemOffer itemOffer, PromotableOrder order, OrderItemHolder orderItemHolder, OfferItemCriteria itemCriteria, List<PromotableOrderItemPriceDetail> priceDetails, ItemOfferMarkTargets itemOfferMarkTargets)	Returns the number of targets marked for the passed in itemCriteria
int	markTargetsForCriteria(PromotableCandidateItemOffer itemOffer, OrderItem relatedQualifier, boolean checkOnly, Offer promotion, OrderItem relatedQualifierRoot, OfferItemCriteria itemCriteria, List<PromotableOrderItemPriceDetail> priceDetails, int targetQtyNeeded)	Returns the number of targets marked for the passed in itemCriteria
boolean	markTargetsForOfferPriceData(PromotableCandidateItemOffer itemOffer, OrderItem relatedQualifier, boolean checkOnly, Offer promotion, OrderItem relatedQualifierRoot, OfferPriceData offerPriceData, List<PromotableOrderItemPriceDetail> priceDetails)
protected boolean	orderMeetsProvidedSubtotalRequirement(Offer offer, HashMap<OfferItemCriteria,List<PromotableOrderItem>> promotableOrderItems, org.broadleafcommerce.common.money.Money minSubTotal)
boolean	orderMeetsQualifyingSubtotalRequirements(PromotableOrder order, Offer offer, HashMap<OfferItemCriteria,List<PromotableOrderItem>> qualifiersMap)	Determines whether or not an PromotableOrder meets the qualifying subtotal requirement of an Offer
boolean	orderMeetsSubtotalRequirements(PromotableOrder order, Offer offer)	Determines whether or not an PromotableOrder meets the subtotal requirement of an Offer
boolean	orderMeetsTargetSubtotalRequirements(PromotableOrder order, Offer offer, HashMap<OfferItemCriteria,List<PromotableOrderItem>> targetsMap)	Determines whether or not an PromotableOrder meets the target subtotal requirement of an Offer
void	removeUnmatchedPriceDetails(Map<Long,? extends OrderItemPriceDetail> unmatchedDetailsMap, Iterator<? extends OrderItemPriceDetail> pdIterator)	Removes price details from the iterator that are contained in the passed in map.
void	removeUnmatchedQualifiers(Map<Long,? extends OrderItemQualifier> unmatchedQualifiersMap, Iterator<? extends OrderItemQualifier> qIterator)	Removes qualifiers from the iterator that are contained in the passed in map.
void	setGenericEntityService(org.broadleafcommerce.common.service.GenericEntityService entityService)
void	setOfferDao(OfferDao offerDao)
void	setPromotableItemFactory(PromotableItemFactory promotableItemFactory)
void	sortQualifierItemDetails(List<PromotableOrderItemPriceDetail> itemPriceDetails, boolean applyToSalePrice)	Used in ItemOfferProcessorImpl.applyItemQualifiersAndTargets(PromotableCandidateItemOffer, PromotableOrder) Allow for customized sorting for which qualifier items should be attempted to be used first for a promotion.
void	sortTargetItemDetails(List<PromotableOrderItemPriceDetail> itemPriceDetails, boolean applyToSalePrice)	Used in ItemOfferProcessorImpl.applyItemQualifiersAndTargets(PromotableCandidateItemOffer, PromotableOrder) Allow for customized sorting for which qualifier items should be attempted to be used first for a promotion.
protected void	updateItemAdjustment(OrderItemPriceDetailAdjustment itemAdjustment, PromotableOrderItemPriceDetailAdjustment promotableAdjustment)
void	updatePriceDetail(OrderItemPriceDetail itemDetail, PromotableOrderItemPriceDetail promotableDetail)	Updates the passed in price detail and its associated adjustments.

Methods inherited from class java.lang.Object

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

Field Details

LOG

protected static final org.apache.commons.logging.Log LOG

promotableOfferUtility

protected final PromotableOfferUtility promotableOfferUtility

promotableItemFactory

protected PromotableItemFactory promotableItemFactory

offerDao

protected OfferDao offerDao

extensionManager

protected OfferServiceExtensionManager extensionManager

entityService

protected org.broadleafcommerce.common.service.GenericEntityService entityService

Constructor Details

OfferServiceUtilitiesImpl

public OfferServiceUtilitiesImpl(PromotableOfferUtility promotableOfferUtility)

Method Details

sortTargetItemDetails

public void sortTargetItemDetails(List<PromotableOrderItemPriceDetail> itemPriceDetails,
 boolean applyToSalePrice)

Description copied from interface: OfferServiceUtilities

Used in ItemOfferProcessorImpl.applyItemQualifiersAndTargets(PromotableCandidateItemOffer, PromotableOrder) Allow for customized sorting for which qualifier items should be attempted to be used first for a promotion.

Default behavior is to sort descending, so higher-value items are attempted to be discounted first.

Specified by:

sortTargetItemDetails in interface OfferServiceUtilities

sortQualifierItemDetails

public void sortQualifierItemDetails(List<PromotableOrderItemPriceDetail> itemPriceDetails,
 boolean applyToSalePrice)

Description copied from interface: OfferServiceUtilities

Used in ItemOfferProcessorImpl.applyItemQualifiersAndTargets(PromotableCandidateItemOffer, PromotableOrder) Allow for customized sorting for which qualifier items should be attempted to be used first for a promotion.

Default behavior is to sort descending, so higher-value items are attempted to be qualified first.

Specified by:

sortQualifierItemDetails in interface OfferServiceUtilities

getPromotableItemComparator

protected Comparator<PromotableOrderItemPriceDetail> getPromotableItemComparator(boolean applyToSalePrice)

findRelatedQualifierRoot

public OrderItem findRelatedQualifierRoot(OrderItem relatedQualifier)

Description copied from interface: OfferServiceUtilities

Given an orderItem, finds the top most parent order item.

Specified by:

findRelatedQualifierRoot in interface OfferServiceUtilities

Returns:

itemOfferCanBeApplied

public boolean itemOfferCanBeApplied(PromotableCandidateItemOffer itemOffer,
 List<PromotableOrderItemPriceDetail> details)

Description copied from interface: OfferServiceUtilities

Return false if a totalitarian or non-combinable offer has already been applied or if this offer is totalitarian or non-combinable and this order already has adjustments applied.

Specified by:

itemOfferCanBeApplied in interface OfferServiceUtilities

Returns:

markQualifiersForCriteria

public int markQualifiersForCriteria(PromotableCandidateItemOffer itemOffer,
 OfferItemCriteria itemCriteria,
 List<PromotableOrderItemPriceDetail> priceDetails)

Description copied from interface: OfferServiceUtilities

Returns the number of qualifiers marked for the passed in itemCriteria

Specified by:

markQualifiersForCriteria in interface OfferServiceUtilities

Returns:

markTargetsForCriteria

public int markTargetsForCriteria(PromotableCandidateItemOffer itemOffer,
 OrderItem relatedQualifier,
 boolean checkOnly,
 Offer promotion,
 OrderItem relatedQualifierRoot,
 OfferItemCriteria itemCriteria,
 List<PromotableOrderItemPriceDetail> priceDetails,
 int targetQtyNeeded)

Description copied from interface: OfferServiceUtilities

Returns the number of targets marked for the passed in itemCriteria

Specified by:

markTargetsForCriteria in interface OfferServiceUtilities

Returns:

markTargetsForOfferPriceData

public boolean markTargetsForOfferPriceData(PromotableCandidateItemOffer itemOffer,
 OrderItem relatedQualifier,
 boolean checkOnly,
 Offer promotion,
 OrderItem relatedQualifierRoot,
 OfferPriceData offerPriceData,
 List<PromotableOrderItemPriceDetail> priceDetails)

Specified by:

markTargetsForOfferPriceData in interface OfferServiceUtilities

markRelatedQualifiersAndTargetsForItemCriteria

public int markRelatedQualifiersAndTargetsForItemCriteria(PromotableCandidateItemOffer itemOffer,
 PromotableOrder order,
 OrderItemHolder orderItemHolder,
 OfferItemCriteria itemCriteria,
 List<PromotableOrderItemPriceDetail> priceDetails,
 ItemOfferMarkTargets itemOfferMarkTargets)

Description copied from interface: OfferServiceUtilities

Returns the number of targets marked for the passed in itemCriteria

Specified by:

markRelatedQualifiersAndTargetsForItemCriteria in interface OfferServiceUtilities

Returns:

applyAdjustmentsForItemPriceDetails

public void applyAdjustmentsForItemPriceDetails(PromotableCandidateItemOffer itemOffer,
 List<PromotableOrderItemPriceDetail> itemPriceDetails)

Description copied from interface: OfferServiceUtilities

Takes in a list of PromotableOrderItemPriceDetails and applies adjustments for all of the discounts that match the passed in offer.

Specified by:

applyAdjustmentsForItemPriceDetails in interface OfferServiceUtilities

isAddOnOrderItem

public boolean isAddOnOrderItem(OrderItem orderItem)

Description copied from interface: OfferServiceUtilities

Determines whether or not the OrderItem was added by a Product Add-On

Specified by:

isAddOnOrderItem in interface OfferServiceUtilities

Returns:

adjustmentIsNotGoodEnoughToBeApplied

protected boolean adjustmentIsNotGoodEnoughToBeApplied(PromotableCandidateItemOffer itemOffer,
 PromotableOrderItemPriceDetail detail)

The adjustment might not be better than the sale price.

Parameters:

itemOffer -

detail -

Returns:

applyOrderItemAdjustment

public void applyOrderItemAdjustment(PromotableCandidateItemOffer itemOffer,
 PromotableOrderItemPriceDetail itemPriceDetail)

Description copied from interface: OfferServiceUtilities

Used by applyAdjustments to create an OrderItemAdjustment from a CandidateOrderOffer and associates the OrderItemAdjustment to the OrderItem.

Specified by:

applyOrderItemAdjustment in interface OfferServiceUtilities

Parameters:

itemOffer - a CandidateOrderOffer to apply to an Order

buildOrderItemList

public List<OrderItem> buildOrderItemList(Order order)

Description copied from interface: OfferServiceUtilities

Builds the list of order-items at the level they are being priced which includes splitting bundles that are being priced at the item level.

Specified by:

buildOrderItemList in interface OfferServiceUtilities

Returns:

buildPromotableItemMap

public Map<OrderItem,PromotableOrderItem> buildPromotableItemMap(PromotableOrder promotableOrder)

Description copied from interface: OfferServiceUtilities

Builds a map from orderItem to promotableOrderItem.

Specified by:

buildPromotableItemMap in interface OfferServiceUtilities

Returns:

buildItemDetailAdjustmentMap

public Map<Long,OrderItemPriceDetailAdjustment> buildItemDetailAdjustmentMap(OrderItemPriceDetail itemDetail)

Description copied from interface: OfferServiceUtilities

Builds a map from itemDetails for adjustment processing.

Specified by:

buildItemDetailAdjustmentMap in interface OfferServiceUtilities

Returns:

updatePriceDetail

public void updatePriceDetail(OrderItemPriceDetail itemDetail,
 PromotableOrderItemPriceDetail promotableDetail)

Description copied from interface: OfferServiceUtilities

Updates the passed in price detail and its associated adjustments.

Specified by:

updatePriceDetail in interface OfferServiceUtilities

updateItemAdjustment

protected void updateItemAdjustment(OrderItemPriceDetailAdjustment itemAdjustment,
 PromotableOrderItemPriceDetailAdjustment promotableAdjustment)

removeUnmatchedPriceDetails

public void removeUnmatchedPriceDetails(Map<Long,? extends OrderItemPriceDetail> unmatchedDetailsMap,
 Iterator<? extends OrderItemPriceDetail> pdIterator)

Description copied from interface: OfferServiceUtilities

Removes price details from the iterator that are contained in the passed in map.

Specified by:

removeUnmatchedPriceDetails in interface OfferServiceUtilities

removeUnmatchedQualifiers

public void removeUnmatchedQualifiers(Map<Long,? extends OrderItemQualifier> unmatchedQualifiersMap,
 Iterator<? extends OrderItemQualifier> qIterator)

Description copied from interface: OfferServiceUtilities

Removes qualifiers from the iterator that are contained in the passed in map.

Specified by:

removeUnmatchedQualifiers in interface OfferServiceUtilities

orderMeetsQualifyingSubtotalRequirements

public boolean orderMeetsQualifyingSubtotalRequirements(PromotableOrder order,
 Offer offer,
 HashMap<OfferItemCriteria,List<PromotableOrderItem>> qualifiersMap)

Description copied from interface: OfferServiceUtilities

Determines whether or not an PromotableOrder meets the qualifying subtotal requirement of an Offer

Specified by:

orderMeetsQualifyingSubtotalRequirements in interface OfferServiceUtilities

Returns:

boolean

orderMeetsTargetSubtotalRequirements

public boolean orderMeetsTargetSubtotalRequirements(PromotableOrder order,
 Offer offer,
 HashMap<OfferItemCriteria,List<PromotableOrderItem>> targetsMap)

Description copied from interface: OfferServiceUtilities

Determines whether or not an PromotableOrder meets the target subtotal requirement of an Offer

Specified by:

orderMeetsTargetSubtotalRequirements in interface OfferServiceUtilities

Returns:

orderMeetsProvidedSubtotalRequirement

protected boolean orderMeetsProvidedSubtotalRequirement(Offer offer,
 HashMap<OfferItemCriteria,List<PromotableOrderItem>> promotableOrderItems,
 org.broadleafcommerce.common.money.Money minSubTotal)

orderMeetsSubtotalRequirements

public boolean orderMeetsSubtotalRequirements(PromotableOrder order,
 Offer offer)

Description copied from interface: OfferServiceUtilities

Determines whether or not an PromotableOrder meets the subtotal requirement of an Offer

Specified by:

orderMeetsSubtotalRequirements in interface OfferServiceUtilities

Returns:

boolean

getPromotableItemFactory

public PromotableItemFactory getPromotableItemFactory()

setPromotableItemFactory

public void setPromotableItemFactory(PromotableItemFactory promotableItemFactory)

getOfferDao

public OfferDao getOfferDao()

setOfferDao

public void setOfferDao(OfferDao offerDao)

getGenericEntityService

public org.broadleafcommerce.common.service.GenericEntityService getGenericEntityService()

setGenericEntityService

public void setGenericEntityService(org.broadleafcommerce.common.service.GenericEntityService entityService)