Package org.broadleafcommerce.core.offer.service

Class OfferServiceExtensionManager

java.lang.Object

org.broadleafcommerce.common.extension.ExtensionManager<OfferServiceExtensionHandler>

org.broadleafcommerce.core.offer.service.OfferServiceExtensionManager

All Implemented Interfaces:

InvocationHandler, org.broadleafcommerce.common.extension.ExtensionHandler, OfferServiceExtensionHandler

@Service("blOfferServiceExtensionManager")
public class OfferServiceExtensionManager
extends org.broadleafcommerce.common.extension.ExtensionManager<OfferServiceExtensionHandler>
implements OfferServiceExtensionHandler

Author:

Andre Azzolini (apazzolini), bpolster, Jeff Fischer

Field Summary

Fields

Modifier and Type	Field	Description
static final org.broadleafcommerce.common.extension.ExtensionManagerOperation	addAdditionalOffersForCode
static final org.broadleafcommerce.common.extension.ExtensionManagerOperation	applyAdditionalFilters
static final org.broadleafcommerce.common.extension.ExtensionManagerOperation	applyAdditionalRuleVariablesForItemOfferEvaluation
static final org.broadleafcommerce.common.extension.ExtensionManagerOperation	applyItemOffer
static final org.broadleafcommerce.common.extension.ExtensionManagerOperation	buildOfferCodeListForCustomer
static final org.broadleafcommerce.common.extension.ExtensionManagerOperation	calculatePotentialSavings
static final org.broadleafcommerce.common.extension.ExtensionManagerOperation	chooseSaleOrRetailAdjustments
static final org.broadleafcommerce.common.extension.ExtensionManagerOperation	createOrderItemPriceDetailAdjustment
static final org.broadleafcommerce.common.extension.ExtensionManagerOperation	removeOfferCodeFromOrder
static final org.broadleafcommerce.common.extension.ExtensionManagerOperation	resetPriceDetails
static final String	STOP_PROCESSING
static final org.broadleafcommerce.common.extension.ExtensionManagerOperation	synchronizeAdjustmentsAndPrices

Fields inherited from class org.broadleafcommerce.common.extension.ExtensionManager

extensionHandler, handlers, handlersSorted, LOCK_OBJECT

Constructor Summary

Constructors

Constructor	Description
OfferServiceExtensionManager()

Method Summary

Modifier and Type	Method	Description
org.broadleafcommerce.common.extension.ExtensionResultStatusType	addAdditionalOffersForCode(List<Offer> offers, OfferCode offerCode)	Allows module extensions to add additional offers for a given offer code.
org.broadleafcommerce.common.extension.ExtensionResultStatusType	applyAdditionalFilters(List<Offer> offers, Order order)
org.broadleafcommerce.common.extension.ExtensionResultStatusType	applyAdditionalRuleVariablesForItemOfferEvaluation(PromotableOrderItem orderItem, HashMap<String,Object> vars)	Allows a module to append additional rule variables that may be needed for order item evaluation
org.broadleafcommerce.common.extension.ExtensionResultStatusType	applyItemOffer(PromotableOrder order, PromotableCandidateItemOffer itemOffer, Map<String,Object> contextMap)	Modules may need to extend the applyItemOffer logic
org.broadleafcommerce.common.extension.ExtensionResultStatusType	buildOfferCodeListForCustomer(org.broadleafcommerce.profile.core.domain.Customer customer, List<OfferCode> offerCodes)	Allows module extension to add additional offer codes to the list, given the customer
org.broadleafcommerce.common.extension.ExtensionResultStatusType	calculatePotentialSavings(PromotableCandidateItemOffer itemOffer, PromotableOrderItem item, int quantity, Map<String,Object> contextMap)	Modules may extend the calculatePotentialSavings method.
org.broadleafcommerce.common.extension.ExtensionResultStatusType	chooseSaleOrRetailAdjustments(PromotableOrder order)	Allows a module to finalize adjustments.
org.broadleafcommerce.common.extension.ExtensionResultStatusType	createOrderItemPriceDetailAdjustment(org.broadleafcommerce.common.extension.ExtensionResultHolder<?> resultHolder, OrderItemPriceDetail itemDetail)	Allows module extensions to add a create a new instance of OrderItemPriceDetailAdjustment.
boolean	isEnabled()
org.broadleafcommerce.common.extension.ExtensionResultStatusType	removeOfferCodeFromOrder(OfferCode offerCode, Order order)
org.broadleafcommerce.common.extension.ExtensionResultStatusType	resetPriceDetails(PromotableOrderItem item)	Modules may need to clear additional offer details when resetPriceDetails is called.
org.broadleafcommerce.common.extension.ExtensionResultStatusType	synchronizeAdjustmentsAndPrices(PromotableOrder order)	Allows a module to amend the data that synchronizes the PromotableOrder with the Order

Methods inherited from class org.broadleafcommerce.common.extension.ExtensionManager

continueOnHandled, execute, getHandlers, getPriority, getProxy, invoke, registerHandler, setHandlers, shouldContinue, sortHandlers

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.broadleafcommerce.common.extension.ExtensionHandler

getPriority

Field Details

STOP_PROCESSING

public static final String STOP_PROCESSING

See Also:

• Constant Field Values

applyAdditionalFilters

public static final org.broadleafcommerce.common.extension.ExtensionManagerOperation applyAdditionalFilters

buildOfferCodeListForCustomer

public static final org.broadleafcommerce.common.extension.ExtensionManagerOperation buildOfferCodeListForCustomer

calculatePotentialSavings

public static final org.broadleafcommerce.common.extension.ExtensionManagerOperation calculatePotentialSavings

resetPriceDetails

public static final org.broadleafcommerce.common.extension.ExtensionManagerOperation resetPriceDetails

applyItemOffer

public static final org.broadleafcommerce.common.extension.ExtensionManagerOperation applyItemOffer

synchronizeAdjustmentsAndPrices

public static final org.broadleafcommerce.common.extension.ExtensionManagerOperation synchronizeAdjustmentsAndPrices

chooseSaleOrRetailAdjustments

public static final org.broadleafcommerce.common.extension.ExtensionManagerOperation chooseSaleOrRetailAdjustments

createOrderItemPriceDetailAdjustment

public static final org.broadleafcommerce.common.extension.ExtensionManagerOperation createOrderItemPriceDetailAdjustment

applyAdditionalRuleVariablesForItemOfferEvaluation

public static final org.broadleafcommerce.common.extension.ExtensionManagerOperation applyAdditionalRuleVariablesForItemOfferEvaluation

addAdditionalOffersForCode

public static final org.broadleafcommerce.common.extension.ExtensionManagerOperation addAdditionalOffersForCode

removeOfferCodeFromOrder

public static final org.broadleafcommerce.common.extension.ExtensionManagerOperation removeOfferCodeFromOrder

Constructor Details

OfferServiceExtensionManager

public OfferServiceExtensionManager()

Method Details

applyAdditionalFilters

public org.broadleafcommerce.common.extension.ExtensionResultStatusType applyAdditionalFilters(List<Offer> offers,
 Order order)

Specified by:

applyAdditionalFilters in interface OfferServiceExtensionHandler

buildOfferCodeListForCustomer

public org.broadleafcommerce.common.extension.ExtensionResultStatusType buildOfferCodeListForCustomer(org.broadleafcommerce.profile.core.domain.Customer customer,
 List<OfferCode> offerCodes)

Description copied from interface: OfferServiceExtensionHandler

Allows module extension to add additional offer codes to the list, given the customer

Specified by:

buildOfferCodeListForCustomer in interface OfferServiceExtensionHandler

Returns:

calculatePotentialSavings

public org.broadleafcommerce.common.extension.ExtensionResultStatusType calculatePotentialSavings(PromotableCandidateItemOffer itemOffer,
 PromotableOrderItem item,
 int quantity,
 Map<String,Object> contextMap)

Description copied from interface: OfferServiceExtensionHandler

Modules may extend the calculatePotentialSavings method. Once the handlers run, the contextMap will be checked for an entry with a key of "savings". If that entry returns a non-null Money, that value will be returned from the calling method.

Otherwise, the map will be checked for an entry with a key of "quantity". If a non-null Integer is returned, that value will replace the quantity call in the normal call to calculatePotentialSavings.

This extension is utilized by one or more BLC enterprise modules including Subscription.

Specified by:

calculatePotentialSavings in interface OfferServiceExtensionHandler

Returns:

resetPriceDetails

public org.broadleafcommerce.common.extension.ExtensionResultStatusType resetPriceDetails(PromotableOrderItem item)

Description copied from interface: OfferServiceExtensionHandler

Modules may need to clear additional offer details when resetPriceDetails is called.

Specified by:

resetPriceDetails in interface OfferServiceExtensionHandler

Returns:

applyItemOffer

public org.broadleafcommerce.common.extension.ExtensionResultStatusType applyItemOffer(PromotableOrder order,
 PromotableCandidateItemOffer itemOffer,
 Map<String,Object> contextMap)

Description copied from interface: OfferServiceExtensionHandler

Modules may need to extend the applyItemOffer logic

For example, a subscription module might creates future payment adjustments.

The module add an attribute of type Boolean to the contextMap named "stopProcessing" indicating to the core offer engine that further adjustment processing is not needed.

Specified by:

applyItemOffer in interface OfferServiceExtensionHandler

Returns:

synchronizeAdjustmentsAndPrices

public org.broadleafcommerce.common.extension.ExtensionResultStatusType synchronizeAdjustmentsAndPrices(PromotableOrder order)

Description copied from interface: OfferServiceExtensionHandler

Allows a module to amend the data that synchronizes the PromotableOrder with the Order

Specified by:

synchronizeAdjustmentsAndPrices in interface OfferServiceExtensionHandler

Returns:

chooseSaleOrRetailAdjustments

public org.broadleafcommerce.common.extension.ExtensionResultStatusType chooseSaleOrRetailAdjustments(PromotableOrder order)

Description copied from interface: OfferServiceExtensionHandler

Allows a module to finalize adjustments.

Specified by:

chooseSaleOrRetailAdjustments in interface OfferServiceExtensionHandler

Returns:

createOrderItemPriceDetailAdjustment

public org.broadleafcommerce.common.extension.ExtensionResultStatusType createOrderItemPriceDetailAdjustment(org.broadleafcommerce.common.extension.ExtensionResultHolder<?> resultHolder,
 OrderItemPriceDetail itemDetail)

Description copied from interface: OfferServiceExtensionHandler

Allows module extensions to add a create a new instance of OrderItemPriceDetailAdjustment. The module should add the value to the resultHolder.getContextMap() with a key of "OrderItemPriceDetailAdjustment"

Specified by:

createOrderItemPriceDetailAdjustment in interface OfferServiceExtensionHandler

Returns:

applyAdditionalRuleVariablesForItemOfferEvaluation

public org.broadleafcommerce.common.extension.ExtensionResultStatusType applyAdditionalRuleVariablesForItemOfferEvaluation(PromotableOrderItem orderItem,
 HashMap<String,Object> vars)

Description copied from interface: OfferServiceExtensionHandler

Allows a module to append additional rule variables that may be needed for order item evaluation

Specified by:

applyAdditionalRuleVariablesForItemOfferEvaluation in interface OfferServiceExtensionHandler

Parameters:

orderItem - - the promotable order item in consideration

vars - - the rule map

Returns:

addAdditionalOffersForCode

public org.broadleafcommerce.common.extension.ExtensionResultStatusType addAdditionalOffersForCode(List<Offer> offers,
 OfferCode offerCode)

Description copied from interface: OfferServiceExtensionHandler

Allows module extensions to add additional offers for a given offer code.

Specified by:

addAdditionalOffersForCode in interface OfferServiceExtensionHandler

Returns:

removeOfferCodeFromOrder

public org.broadleafcommerce.common.extension.ExtensionResultStatusType removeOfferCodeFromOrder(OfferCode offerCode,
 Order order)

Specified by:

removeOfferCodeFromOrder in interface OfferServiceExtensionHandler

isEnabled

public boolean isEnabled()

Specified by:

isEnabled in interface org.broadleafcommerce.common.extension.ExtensionHandler