Package com.broadleafcommerce.promotion.offer.service.dto

Class OfferProcessingContext

java.lang.Object

com.broadleafcommerce.promotion.offer.service.dto.OfferProcessingContext

All Implemented Interfaces:

Serializable

public class OfferProcessingContext
extends Object
implements Serializable

This object manages the full list of permutations for a given execution of the offer engine and provides methods to determine the correct mix of offers for the final result.

Author:

Brian Polster (bpolster)

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor	Description
OfferProcessingContext(EnhancedOrder order, CandidateOffers offers)

Method Summary

Modifier and Type	Method	Description
protected void	addToListIfPresent(List<Set<OfferCombinabilityCriteria>> criteriaByTypeList, Map<OfferCombinabilityCriteriaKey,OfferCombinabilityCriteria> permutationMap)	Each element in the list represents a single offer type and the unique set of OfferCombinabilityCriteria objects.
protected void	buildOfferPermutationsForCriteria(OfferCombinabilityCriteria criteria)	This method builds all compatible permutations of offers in a tree structure.
protected boolean	checkCompatability(BaseCandidateOffer candidateOffer, BaseCandidateOffer otherCandidateOffer)
protected boolean	checkForCombinable(BaseCandidateOffer candidateOffer, BaseCandidateOffer otherOffer)
protected boolean	checkForExplicitExclusions(BaseCandidateOffer candidateOffer, BaseCandidateOffer otherCandidateOffer)
protected boolean	checkForStackable(BaseCandidateOffer candidateOffer, BaseCandidateOffer otherOffer)
void	createPathsForNode(CompatibleOfferNode currentNode, Set<BaseCandidateOffer> otherOffers, Set<CompatibleOfferNode> allNodes)
BaseCandidateOffer	findFirstCompatibleOffer(BaseCandidateOffer offer, Set<BaseCandidateOffer> otherOffers)
BaseCandidateOffer	findFirstIncompatibleOffer(BaseCandidateOffer offer, Set<BaseCandidateOffer> otherOffers)	Based on the compatible flag, return the first compatible or incompatible item from the passed in list
Optional<CombinedTypesOfferPermutation>	getBestOfferPermutation()
List<OrderOfferAdjustment>	getBestOrderAdjustmentsForTesting()	Method facilitates unit testing.
List<CandidateItemOffer>	getCandidateFulfillmentItemOffers()
List<CandidateItemOffer>	getCandidateOrderItemOffers()
List<CombinedTypesOfferPermutation>	getCombinedTypesOfferPermutations()
List<Set<OfferCombinabilityCriteria>>	getCriteriaSetsByType()	Builds a list consisting of the sets of OfferCombinabilityCriteria for each offer type.
Map<OfferCombinabilityCriteriaKey,OfferCombinabilityCriteria>	getFulfillmentGroupCriteriaMap()
Map<OfferCombinabilityCriteriaKey,OfferCombinabilityCriteria>	getFulfillmentItemCriteriaMap()
Map<OfferCombinabilityCriteriaKey,OfferCombinabilityCriteria>	getItemOfferCriteriaMap()
EnhancedOrder	getOrder()
Map<OfferCombinabilityCriteriaKey,OfferCombinabilityCriteria>	getOrderOfferCriteriaMap()
Map<OfferCombinabilityCriteriaKey,OfferCombinabilityCriteria>	getVoucherCriteriaMap()
boolean	hasOffers()
void	initializePermutations()	Build unique permutations by offer type where a permutation is grouped by how the permutation can combine with other offer types
protected void	initializePermutations(List<? extends BaseCandidateOffer> offers, Map<OfferCombinabilityCriteriaKey,OfferCombinabilityCriteria> permutationMap)
boolean	isHasOffers()
void	setBestOfferPermutation(CombinedTypesOfferPermutation bestOfferPermutation)
void	updateBestCombinedTypesPermutation()

Methods inherited from class java.lang.Object

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

Constructor Detail

OfferProcessingContext

public OfferProcessingContext(EnhancedOrder order,
                              CandidateOffers offers)

Method Detail

hasOffers

public boolean hasOffers()

getCandidateOrderItemOffers

public List<CandidateItemOffer> getCandidateOrderItemOffers()

getCandidateFulfillmentItemOffers

public List<CandidateItemOffer> getCandidateFulfillmentItemOffers()

initializePermutations

public void initializePermutations()

Build unique permutations by offer type where a permutation is grouped by how the permutation can combine with other offer types

See Also:

OfferCombinabilityCriteriaKey

initializePermutations

protected void initializePermutations(List<? extends BaseCandidateOffer> offers,
                                      Map<OfferCombinabilityCriteriaKey,OfferCombinabilityCriteria> permutationMap)

buildOfferPermutationsForCriteria

protected void buildOfferPermutationsForCriteria(OfferCombinabilityCriteria criteria)

This method builds all compatible permutations of offers in a tree structure. Each path of this tree represents a unique offer permutation.

Parameters:

criteria - OfferCombinabilityCriteria to group offers by

createPathsForNode

public void createPathsForNode(CompatibleOfferNode currentNode,
                               Set<BaseCandidateOffer> otherOffers,
                               Set<CompatibleOfferNode> allNodes)

findFirstIncompatibleOffer

public BaseCandidateOffer findFirstIncompatibleOffer(BaseCandidateOffer offer,
                                                     Set<BaseCandidateOffer> otherOffers)

Based on the compatible flag, return the first compatible or incompatible item from the passed in list

Parameters:

offer -

otherOffers -

Returns:

findFirstCompatibleOffer

public BaseCandidateOffer findFirstCompatibleOffer(BaseCandidateOffer offer,
                                                   Set<BaseCandidateOffer> otherOffers)

checkCompatability

protected boolean checkCompatability(BaseCandidateOffer candidateOffer,
                                     BaseCandidateOffer otherCandidateOffer)

checkForExplicitExclusions

protected boolean checkForExplicitExclusions(BaseCandidateOffer candidateOffer,
                                             BaseCandidateOffer otherCandidateOffer)

checkForStackable

protected boolean checkForStackable(BaseCandidateOffer candidateOffer,
                                    BaseCandidateOffer otherOffer)

checkForCombinable

protected boolean checkForCombinable(BaseCandidateOffer candidateOffer,
                                     BaseCandidateOffer otherOffer)

getCriteriaSetsByType

public List<Set<OfferCombinabilityCriteria>> getCriteriaSetsByType()

Builds a list consisting of the sets of OfferCombinabilityCriteria for each offer type. Each index in the list represents a level in the tree of possible offer combinations. The order is important as the permutations will first compute item offers which can impact the overall order subtotal and other offer eligibility. The list will only contain offer types that have relevant offers and they will be in the following order: Item, Order, Voucher, Fulfillment Item, Fulfillment Order

Returns:

addToListIfPresent

protected void addToListIfPresent(List<Set<OfferCombinabilityCriteria>> criteriaByTypeList,
                                  Map<OfferCombinabilityCriteriaKey,OfferCombinabilityCriteria> permutationMap)

Each element in the list represents a single offer type and the unique set of OfferCombinabilityCriteria objects. This structure supports the ability to find the best cross-type combination of offers.

Parameters:

criteriaByTypeList - The list to populate

permutationMap -

getBestOfferPermutation

public Optional<CombinedTypesOfferPermutation> getBestOfferPermutation()

updateBestCombinedTypesPermutation

public void updateBestCombinedTypesPermutation()

getBestOrderAdjustmentsForTesting

public List<OrderOfferAdjustment> getBestOrderAdjustmentsForTesting()

Method facilitates unit testing. This method would not be reliable outside of tests as it does not properly null check the bestOfferPermutation

getOrderOfferCriteriaMap

public Map<OfferCombinabilityCriteriaKey,OfferCombinabilityCriteria> getOrderOfferCriteriaMap()

getItemOfferCriteriaMap

public Map<OfferCombinabilityCriteriaKey,OfferCombinabilityCriteria> getItemOfferCriteriaMap()

getFulfillmentGroupCriteriaMap

public Map<OfferCombinabilityCriteriaKey,OfferCombinabilityCriteria> getFulfillmentGroupCriteriaMap()

getFulfillmentItemCriteriaMap

public Map<OfferCombinabilityCriteriaKey,OfferCombinabilityCriteria> getFulfillmentItemCriteriaMap()

getVoucherCriteriaMap

public Map<OfferCombinabilityCriteriaKey,OfferCombinabilityCriteria> getVoucherCriteriaMap()

getCombinedTypesOfferPermutations

public List<CombinedTypesOfferPermutation> getCombinedTypesOfferPermutations()

setBestOfferPermutation

public void setBestOfferPermutation(CombinedTypesOfferPermutation bestOfferPermutation)

isHasOffers

public boolean isHasOffers()

getOrder

public EnhancedOrder getOrder()