com.ibm.commerce.marketing.promotion.reward

Class PercentOffVolumeDiscountAdjustment

java.lang.Object

com.ibm.commerce.marketing.promotion.reward.PercentOffVolumeDiscountAdjustment

All Implemented Interfaces:

Adjustment, MonetaryAdjustment, XMLizable, java.io.Serializable, java.lang.Cloneable

public class PercentOffVolumeDiscountAdjustment
extends java.lang.Object
implements MonetaryAdjustment

PercentOffVolumeDiscountAdjustment offers different percent discounts based on the total purchase amount. This adjustment deals with the PercentOffPriceAdjustment or the PercentOffAdjustment type of discounts based on the adjustment type.

XML Snippet for PercentOffVolumeDiscountAdjustment:

  <Adjustment impl="com.ibm.commerce.marketing.promotion.reward.PercentOffVolumeDiscountAdjustment">
        <!-- wholeOrder or IndividualAffectedItems or AllAffectedItems -->
        <AdjustmentType>wholeOrder</AdjustmentType>
        <!-- Possible values are:
                -1: Standard offer price
                -2: Contract price 
                -3: Discounted price
        -->
        <PriceAdjustmentBase>-3</PriceAdjustmentBase>
        <Range>
                <AmountOff>10</AmountOff>
                <Currency>CAD</Currency>
                <LowerBound>1</LowerBound>
                <UpperBound>5</UpperBound>
                <LowerBoundIncluded>true</LowerBoundIncluded>
                <UpperBoundIncluded>true</UpperBoundIncluded>
        </Range>
        <Range>
                <AmountOff>25</AmountOff>
                <Currency>CAD</Currency>
                <LowerBound>6</LowerBound>
                <!-- -1 indicates unlimited -->
                <UpperBound>-1</UpperBound>
                <LowerBoundIncluded>true</LowerBoundIncluded>
                <UpperBoundIncluded>false</UpperBoundIncluded>
        </Range>
   </Adjustment>
 
 
 

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	COPYRIGHT IBM copyright notice field.

Fields inherited from interface com.ibm.commerce.marketing.promotion.reward.MonetaryAdjustment

MAX_SCALE_FOR_DIVIDE, PRICE, SHIPPING, SHIPPING_TAX, TAX, ZERO

Fields inherited from interface com.ibm.commerce.marketing.promotion.reward.Adjustment

ALL_AFFECTED_ITEMS, INDIVIDUAL_AFFECTED_ITEMS, WHOLE_ORDER

Constructor Summary

Constructors

Constructor and Description
PercentOffVolumeDiscountAdjustment() Constructor.

Method Summary

Modifier and Type	Method and Description
boolean	apply(LineItemSet targeted, java.math.BigDecimal targetedAmount, int targetedAmountTypes, LineItemSet affected, java.util.Vector affectedVector, java.util.Vector adjustmentVector, PromotionContext context) This method evaluates the targeted order items to see if they fulfill the conditions of this adjustment ( for example, if the quantity of the order items falls into one of the ranges of the adjustment).
java.lang.Object	clone() Returns null if the CloneNotSupportedException is thrown.
void	fromXML(org.w3c.dom.Node anXMLNode) Transforms the XML node into its corresponding real Object.
java.lang.Integer	getAdjustmentType() This method gets the type of Adjustment.
java.math.BigDecimal	getPerUnitAdjustment(AssociatedOrderItem one, AssociatedOrderItem[] all, PromotionContext context) Returns 0.
int	getPriceAdjustmentBasis() Returns the basis for price adjustment.
Range[]	getRanges() Gets the ranges
int	getTheTypeOfMonetaryValueToBeAdjusted() Returns the target as PRICE=1.
void	setAdjustmentType(java.lang.Integer _adjustmentType) This method sets the type of Adjustment.
void	setPriceAdjustmentBasis(int i) Sets the basis for price adjustment.
void	setRanges(Range[] ranges) Sets ranges
java.lang.String	toXML() Converts the object into its corresponding XML format representation.

Methods inherited from class java.lang.Object

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

Field Detail

COPYRIGHT

public static final java.lang.String COPYRIGHT

IBM copyright notice field.

See Also:

Constant Field Values

Constructor Detail

PercentOffVolumeDiscountAdjustment

public PercentOffVolumeDiscountAdjustment()

Constructor.

Method Detail

getTheTypeOfMonetaryValueToBeAdjusted

public int getTheTypeOfMonetaryValueToBeAdjusted()

Returns the target as PRICE=1.

Specified by:

getTheTypeOfMonetaryValueToBeAdjusted in interface MonetaryAdjustment

Returns:

target of a monetary adjustment

See Also:

MonetaryAdjustment.getTheTypeOfMonetaryValueToBeAdjusted()

getPerUnitAdjustment

public java.math.BigDecimal getPerUnitAdjustment(AssociatedOrderItem one,
                                                 AssociatedOrderItem[] all,
                                                 PromotionContext context)

Returns 0.

Specified by:

getPerUnitAdjustment in interface MonetaryAdjustment

Parameters:

one - the order item or portion of an order item for which a per unit adjustment amount needs to be calculated.

all - all of the AssociatedOrderItems to which this adjustment applies.

context - PromotionContext

Returns:

a perUnit value, value could be positive which means a discount, negative which means a markup or zero which means no change is needed.

See Also:

MonetaryAdjustment.getPerUnitAdjustment(com.ibm.commerce.marketing.promotion.runtime.AssociatedOrderItem, com.ibm.commerce.marketing.promotion.runtime.AssociatedOrderItem[], com.ibm.commerce.marketing.promotion.runtime.PromotionContext)

getAdjustmentType

public java.lang.Integer getAdjustmentType()

Description copied from interface: Adjustment

This method gets the type of Adjustment. An adjustment can be of the following types: for the whole Order, for All the Affected Items, or for Individual Affected Items.

Specified by:

getAdjustmentType in interface Adjustment

Returns:

one of the defined constants of WHOLE_ORDER, ALL_AFFECTED_ITEMS or INDIVIDUAL_AFFECTED_ITEMS.

See Also:

Adjustment.getAdjustmentType()

setAdjustmentType

public void setAdjustmentType(java.lang.Integer _adjustmentType)

Description copied from interface: Adjustment

This method sets the type of Adjustment. An adjustment can be of the following types for whole Order, for All Affected Items, and for Individual Affected Items. Set adjustmentType to one of the defined constants of WHOLE_ORDER, ALL_AFFECTED_ITEMS or INDIVIDUAL_AFFECTED_ITEMS.

Specified by:

setAdjustmentType in interface Adjustment

See Also:

Adjustment.setAdjustmentType(java.lang.Integer)

apply

public boolean apply(LineItemSet targeted,
                     java.math.BigDecimal targetedAmount,
                     int targetedAmountTypes,
                     LineItemSet affected,
                     java.util.Vector affectedVector,
                     java.util.Vector adjustmentVector,
                     PromotionContext context)
              throws PromotionRuntimeException

Description copied from interface: Adjustment

This method evaluates the targeted order items to see if they fulfill the conditions of this adjustment ( for example, if the quantity of the order items falls into one of the ranges of the adjustment). Depending upon if and what conditions are fulfilled, an Adjustment object is added to the adjustmentVector Vector object passed as a parameter. The affectedVector Vector object passed as a parameter is updated by adding the affected order items. This method is called in the invoke(LineItemSet, BigDecimal, int, Vector, Vector, PromotionContext) method of AdjustmentFunction.

Specified by:

apply in interface Adjustment

Parameters:

targeted - The targeted order items. This is a set of order items (or portions of order items) that are used to qualify for the promotion of which this adjustment is a part.

affected - The affected order items. This is a set of order items, identified by the promotion, to which this adjustment will be attached.

affectedVector - A Vector which contains the affected LineItemSets.

adjustmentVector - A Vector which contains the Adjustment objects.

context - The PromotionContext object which may be used to build the Adjustment to add to the adjustmentVector parameter.

Returns:

A boolean value indicating whether the conditions of the adjustment were fulfilled successfully or not. A true value indicates that the conditions of the adjustment were fulfilled successully, otherwise a false value is returned.

Throws:

PromotionRuntimeException - when the computation encounters a problem.

See Also:

com.ibm.commerce.marketing.promotion.reward.Adjustment#apply(com.ibm.commerce.marketing.promotion.runtime.LineItemSet, com.ibm.commerce.marketing.promotion.runtime.LineItemSet, java.util.Vector, java.util.Vector, com.ibm.commerce.marketing.promotion.runtime.PromotionContext)

toXML

public java.lang.String toXML()
                       throws XMLizationException

Description copied from interface: XMLizable

Converts the object into its corresponding XML format representation.

Specified by:

toXML in interface XMLizable

Returns:

The string format of the XML that represents this XMLizable object

Throws:

XMLizationException - when this process fails

See Also:

XMLizable.toXML()

clone

public java.lang.Object clone()

Returns null if the CloneNotSupportedException is thrown.

Specified by:

clone in interface Adjustment

Overrides:

clone in class java.lang.Object

See Also:

Object.clone()

fromXML

public void fromXML(org.w3c.dom.Node anXMLNode)
             throws DeXMLizationException

Description copied from interface: XMLizable

Transforms the XML node into its corresponding real Object.

Specified by:

fromXML in interface XMLizable

Parameters:

anXMLNode - The node that represents an XMLizable object

Throws:

DeXMLizationException - when this process fails

See Also:

XMLizable.fromXML(org.w3c.dom.Node)

getRanges

public Range[] getRanges()

Gets the ranges

Returns:

ranges

setRanges

public void setRanges(Range[] ranges)

Sets ranges

Parameters:

ranges - Ranges to set.

getPriceAdjustmentBasis

public int getPriceAdjustmentBasis()

Returns the basis for price adjustment.

Returns:

the basis for price adjustment.

setPriceAdjustmentBasis

public void setPriceAdjustmentBasis(int i)

Sets the basis for price adjustment.

Parameters:

i - new basis for price adjustment.