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, ExtensionHandler, OfferServiceExtensionHandler

@Service("blOfferServiceExtensionManager")
public class OfferServiceExtensionManager
extends ExtensionManager<OfferServiceExtensionHandler>
implements OfferServiceExtensionHandler

Author:

Andre Azzolini (apazzolini), bpolster, Jeff Fischer

Field Summary

Fields

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

buildOfferCodeListForCustomer

public static final ExtensionManagerOperation buildOfferCodeListForCustomer

calculatePotentialSavings

public static final ExtensionManagerOperation calculatePotentialSavings

resetPriceDetails

public static final ExtensionManagerOperation resetPriceDetails

applyItemOffer

public static final ExtensionManagerOperation applyItemOffer

synchronizeAdjustmentsAndPrices

public static final ExtensionManagerOperation synchronizeAdjustmentsAndPrices

chooseSaleOrRetailAdjustments

public static final ExtensionManagerOperation chooseSaleOrRetailAdjustments

createOrderItemPriceDetailAdjustment

public static final ExtensionManagerOperation createOrderItemPriceDetailAdjustment

applyAdditionalRuleVariablesForItemOfferEvaluation

public static final ExtensionManagerOperation applyAdditionalRuleVariablesForItemOfferEvaluation

addAdditionalOffersForCode

public static final ExtensionManagerOperation addAdditionalOffersForCode

removeOfferCodeFromOrder

public static final ExtensionManagerOperation removeOfferCodeFromOrder

Constructor Details

OfferServiceExtensionManager

public OfferServiceExtensionManager()

Method Details

applyAdditionalFilters

public ExtensionResultStatusType applyAdditionalFilters(List<Offer> offers,
 Order order)

Specified by:

applyAdditionalFilters in interface OfferServiceExtensionHandler

buildOfferCodeListForCustomer

public ExtensionResultStatusType buildOfferCodeListForCustomer(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 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 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 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 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 ExtensionResultStatusType chooseSaleOrRetailAdjustments(PromotableOrder order)

Description copied from interface: OfferServiceExtensionHandler

Allows a module to finalize adjustments.

Specified by:

chooseSaleOrRetailAdjustments in interface OfferServiceExtensionHandler

Returns:

createOrderItemPriceDetailAdjustment

public ExtensionResultStatusType createOrderItemPriceDetailAdjustment(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 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 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 ExtensionResultStatusType removeOfferCodeFromOrder(OfferCode offerCode,
 Order order)

Specified by:

removeOfferCodeFromOrder in interface OfferServiceExtensionHandler

isEnabled

public boolean isEnabled()

Specified by:

isEnabled in interface ExtensionHandler