Package com.broadleafcommerce.promotion.offer.service.engine.proration

Class DefaultProrationService

java.lang.Object

com.broadleafcommerce.promotion.offer.service.engine.proration.DefaultProrationService

All Implemented Interfaces:

ProrationService

public class DefaultProrationService
extends Object
implements ProrationService

Author:

Nathan Moore (nathanmoore).

Field Summary

Fields

Modifier and Type	Field	Description
protected com.broadleafcommerce.common.extension.TypeFactory	offerFactory

Constructor Summary

Constructors

Constructor	Description
DefaultProrationService(com.broadleafcommerce.common.extension.TypeFactory offerFactory)

Method Summary

Modifier and Type	Method	Description
void	addProratedItemOfferAdjustmentsToParentOfferDetails(Collection<? extends EnhancedProratedItemOfferAdjustment> proratedAdjustments)	Adds the ProratedItemOfferAdjustments to their parent LineItemOfferDetails
protected javax.money.MonetaryAmount	calculateProratedAmount(ItemOfferAdjustment adjustment, int itemQty)
Set<EnhancedProratedItemOfferAdjustment>	calculateProratedItemAdjustments(EnhancedOrder order)	For any Offer that has a Discount.prorationType of ProrationType.TARGET_AND_QUALIFIER, this will populate all of the ProratedItemOfferAdjustments on the LineItemOfferDetails mostly for the sake of reporting instruments.
protected EnhancedProratedItemOfferAdjustment	calculateProrationItemAdjustment(ItemOfferAdjustment adjustment)
protected com.broadleafcommerce.promotion.offer.client.web.context.info.LineItemRef	createLineItemRef(EnhancedLineItem lineItem)
protected com.broadleafcommerce.promotion.offer.client.web.context.info.OfferRef	createOfferRef(Offer offer)
protected EnhancedProratedItemOfferAdjustment	createProratedAdjustment(Offer offer, EnhancedLineItem lineItem, LineItemOfferDetail parentDetail, javax.money.MonetaryAmount proratedAmt, int quantity)
protected Set<ItemOfferAdjustment>	getAllAdjustments(EnhancedOrder order)
protected String	getCustomLineItemType(EnhancedLineItem lineItem)
protected javax.money.MonetaryAmount	getDiscountableItemsTotal(javax.money.MonetaryAmount startingAmount, List<? extends EnhancedLineItem> lineItems)	Gets the discountable total for the given EnhancedLineItems.
protected String	getLineItemType(EnhancedLineItem lineItem)
protected MoneyRoundingHelper	getMoneyRoundingHelper()
protected boolean	isMatchingQualifier(Offer offer, OfferQualifier qualifier)
protected boolean	isProrationRequiredForAdjustment(ItemOfferAdjustment adjustment)
protected void	populateProratedFulfillmentGroupAdjustments(EnhancedFulfillmentGroup group)	Populates the prorated fulfillment group adjustments for the given EnhancedFulfillmentGroup.
void	populateProratedFulfillmentGroupAdjustments(EnhancedOrder order)	Populates all of the EnhancedProratedOfferAdjustments for any Offer that has a Discount.getTargetType() of DiscountTargetType.FULFILLMENT_GROUP and add them onto the individual discountable fulfillment items, as well as populating EnhancedFulfillmentGroup.getProratedFulfillmentAdjustments().
protected void	populateProratedFulfillmentGroupAdjustments(FulfillmentGroupAdjustment fgAdjustment, EnhancedFulfillmentGroup group)	Populates the prorated fulfillment group adjustments from the given FulfillmentGroupAdjustment across the given fulfillment items and the given EnhancedFulfillmentGroup.
void	populateProratedOrderAdjustments(EnhancedOrder order)	Populates all of the EnhancedProratedOfferAdjustments for any Offer that has a Discount.getTargetType() of DiscountTargetType.ORDER and add them onto the individual discountable order line items.
protected void	populateProratedOrderAdjustments(OrderOfferAdjustment orderAdjustment, List<? extends EnhancedLineItem> lineItems)	Populates the prorated order adjustments from the given OrderOfferAdjustment across the given line items.
protected Set<EnhancedProratedOfferAdjustment>	prorateAdjustmentAmongItems(Offer offer, javax.money.MonetaryAmount adjustmentAmount, javax.money.MonetaryAmount totalOfAllDiscountableItems, List<? extends EnhancedLineItem> lineItems)	Prorates the given adjustment across the given EnhancedLineItems.
void	setMoneyRoundingHelper(MoneyRoundingHelper moneyRoundingHelper)
protected boolean	shouldProrateAdjustment(FulfillmentGroupAdjustment adjustment)	Determines whether the given FulfillmentGroupAdjustment should be prorated across the fulfillment items.
protected boolean	shouldProrateAdjustment(OrderOfferAdjustment adjustment)	Determines whether the given OrderOfferAdjustment should be prorated across the order line items.
protected javax.money.MonetaryAmount	zeroIfNull(javax.money.MonetaryAmount amount, javax.money.CurrencyUnit currency)	Defaults the amount to zero if null.

Methods inherited from class java.lang.Object

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

Field Detail

offerFactory

protected final com.broadleafcommerce.common.extension.TypeFactory offerFactory

Constructor Detail

DefaultProrationService

public DefaultProrationService(com.broadleafcommerce.common.extension.TypeFactory offerFactory)

Method Detail

addProratedItemOfferAdjustmentsToParentOfferDetails

public void addProratedItemOfferAdjustmentsToParentOfferDetails(@NonNull
                                                                Collection<? extends EnhancedProratedItemOfferAdjustment> proratedAdjustments)

Description copied from interface: ProrationService

Adds the ProratedItemOfferAdjustments to their parent LineItemOfferDetails

Specified by:

addProratedItemOfferAdjustmentsToParentOfferDetails in interface ProrationService

Parameters:

proratedAdjustments - ProratedItemOfferAdjustments to be added

calculateProratedItemAdjustments

@NonNull
public Set<EnhancedProratedItemOfferAdjustment> calculateProratedItemAdjustments(@NonNull
                                                                                 EnhancedOrder order)

Description copied from interface: ProrationService

For any Offer that has a Discount.prorationType of ProrationType.TARGET_AND_QUALIFIER, this will populate all of the ProratedItemOfferAdjustments on the LineItemOfferDetails mostly for the sake of reporting instruments.

Specified by:

calculateProratedItemAdjustments in interface ProrationService

Parameters:

order - the EnhancedOrder whose items may need ProratedItemOfferAdjustments

Returns:

all of the ProratedItemOfferAdjustments for this Order's order and fulfillment LineItems.

populateProratedOrderAdjustments

@NonNull
public void populateProratedOrderAdjustments(@NonNull
                                             EnhancedOrder order)

Description copied from interface: ProrationService

Populates all of the EnhancedProratedOfferAdjustments for any Offer that has a Discount.getTargetType() of DiscountTargetType.ORDER and add them onto the individual discountable order line items.

Specified by:

populateProratedOrderAdjustments in interface ProrationService

Parameters:

order - the EnhancedOrder to populate the order offer adjustment prorations

populateProratedFulfillmentGroupAdjustments

@NonNull
public void populateProratedFulfillmentGroupAdjustments(@NonNull
                                                        EnhancedOrder order)

Description copied from interface: ProrationService

Populates all of the EnhancedProratedOfferAdjustments for any Offer that has a Discount.getTargetType() of DiscountTargetType.FULFILLMENT_GROUP and add them onto the individual discountable fulfillment items, as well as populating EnhancedFulfillmentGroup.getProratedFulfillmentAdjustments().

Specified by:

populateProratedFulfillmentGroupAdjustments in interface ProrationService

Parameters:

order - the EnhancedOrder to populate the fulfillment group offer adjustment prorations

getAllAdjustments

protected Set<ItemOfferAdjustment> getAllAdjustments(EnhancedOrder order)

isProrationRequiredForAdjustment

protected boolean isProrationRequiredForAdjustment(ItemOfferAdjustment adjustment)

shouldProrateAdjustment

protected boolean shouldProrateAdjustment(OrderOfferAdjustment adjustment)

Determines whether the given OrderOfferAdjustment should be prorated across the order line items.

Returns true by default, any custom logic should be added here.

Parameters:

adjustment - the OrderOfferAdjustment to check against

Returns:

true if the given OrderOfferAdjustment should be prorated across the order line items

shouldProrateAdjustment

protected boolean shouldProrateAdjustment(FulfillmentGroupAdjustment adjustment)

Determines whether the given FulfillmentGroupAdjustment should be prorated across the fulfillment items.

Returns true by default, any custom logic should be added here.

Parameters:

adjustment - the FulfillmentGroupAdjustment to check against

Returns:

true if the given FulfillmentGroupAdjustment should be prorated across the fulfillment items

calculateProrationItemAdjustment

protected EnhancedProratedItemOfferAdjustment calculateProrationItemAdjustment(ItemOfferAdjustment adjustment)

populateProratedOrderAdjustments

protected void populateProratedOrderAdjustments(OrderOfferAdjustment orderAdjustment,
                                                List<? extends EnhancedLineItem> lineItems)

Populates the prorated order adjustments from the given OrderOfferAdjustment across the given line items.

Parameters:

orderAdjustment - the OrderOfferAdjustment to prorate

lineItems - the line items to prorate the order-level adjustment across

populateProratedFulfillmentGroupAdjustments

protected void populateProratedFulfillmentGroupAdjustments(EnhancedFulfillmentGroup group)

Populates the prorated fulfillment group adjustments for the given EnhancedFulfillmentGroup.

Parameters:

group - the EnhancedFulfillmentGroup to populate the prorations for

populateProratedFulfillmentGroupAdjustments

protected void populateProratedFulfillmentGroupAdjustments(FulfillmentGroupAdjustment fgAdjustment,
                                                           EnhancedFulfillmentGroup group)

Populates the prorated fulfillment group adjustments from the given FulfillmentGroupAdjustment across the given fulfillment items and the given EnhancedFulfillmentGroup.

Parameters:

fgAdjustment - the FulfillmentGroupAdjustment to prorate across the EnhancedFulfillmentGroup and fulfillment items

group - the EnhancedFulfillmentGroup to populate the prorations for

getDiscountableItemsTotal

protected javax.money.MonetaryAmount getDiscountableItemsTotal(javax.money.MonetaryAmount startingAmount,
                                                               List<? extends EnhancedLineItem> lineItems)

Gets the discountable total for the given EnhancedLineItems.

Parameters:

startingAmount - the amount to start with

lineItems - the EnhancedLineItems to calculate the discountable total for

Returns:

the discountable total for the given EnhancedLineItems

prorateAdjustmentAmongItems

protected Set<EnhancedProratedOfferAdjustment> prorateAdjustmentAmongItems(Offer offer,
                                                                           javax.money.MonetaryAmount adjustmentAmount,
                                                                           javax.money.MonetaryAmount totalOfAllDiscountableItems,
                                                                           List<? extends EnhancedLineItem> lineItems)

Prorates the given adjustment across the given EnhancedLineItems.

Parameters:

offer - the Offer where the adjustment came from

adjustmentAmount - the adjustment amount to prorate

totalOfAllDiscountableItems - the total of the discountable items

lineItems - the EnhancedLineItems to prorate across

Returns:

the populated adjustment prorations added to the given EnhancedLineItems. The list can be used later on for rounding

isMatchingQualifier

protected boolean isMatchingQualifier(Offer offer,
                                      OfferQualifier qualifier)

calculateProratedAmount

protected javax.money.MonetaryAmount calculateProratedAmount(ItemOfferAdjustment adjustment,
                                                             int itemQty)

createProratedAdjustment

protected EnhancedProratedItemOfferAdjustment createProratedAdjustment(Offer offer,
                                                                       EnhancedLineItem lineItem,
                                                                       LineItemOfferDetail parentDetail,
                                                                       javax.money.MonetaryAmount proratedAmt,
                                                                       int quantity)

createLineItemRef

protected com.broadleafcommerce.promotion.offer.client.web.context.info.LineItemRef createLineItemRef(EnhancedLineItem lineItem)

getLineItemType

protected String getLineItemType(EnhancedLineItem lineItem)

getCustomLineItemType

protected String getCustomLineItemType(EnhancedLineItem lineItem)

createOfferRef

protected com.broadleafcommerce.promotion.offer.client.web.context.info.OfferRef createOfferRef(Offer offer)

zeroIfNull

protected final javax.money.MonetaryAmount zeroIfNull(@Nullable
                                                      javax.money.MonetaryAmount amount,
                                                      @Nullable
                                                      javax.money.CurrencyUnit currency)

Defaults the amount to zero if null.

Parameters:

amount - The MonetaryAmount to default to zero

currency - The amount's CurrencyUnit

Returns:

The amount or zero if null.

getMoneyRoundingHelper

protected MoneyRoundingHelper getMoneyRoundingHelper()

setMoneyRoundingHelper

@Autowired
public void setMoneyRoundingHelper(MoneyRoundingHelper moneyRoundingHelper)