com.ibm.commerce.price.commands
Class CalculateContractPricesCmdImpl

java.lang.Object
  |
  +--CacheableCommandImpl
        |
        +--com.ibm.commerce.command.AbstractECTargetableCommand
              |
              +--com.ibm.commerce.command.TaskCommandImpl
                    |
                    +--com.ibm.commerce.price.commands.CalculateContractPricesCmdImpl
All Implemented Interfaces:
CalculateContractPricesCmd, ECCommand, ECTargetableCommand, TaskCommand
Direct Known Subclasses:
MarketplaceCalculateContractPricesCmdImpl

public class CalculateContractPricesCmdImpl
extends TaskCommandImpl
implements CalculateContractPricesCmd

This CalculateContractPricesCmd Task Command Implementation retrieves all the qualified contract prices and calculates the price adjustment specified by the contract for one or more catalog entries.

If the command is successful in retreiving offers, it will return a list of qualified offers that provide the offer prices which have been adjusted according the corresponding Ts&Cs defined in the trading agreements.

If unsuccessful, it wil return an empty list.

Behaviour

Obtain all the qualified offers for each catalog entries, each offer to be retrieved to find the price of a catalog entry must satisfy certain criteria.

If no valid offer can be found, the parent product offers will be searched providing the catalog entry and the parent product is not excluded from the trading agreements.

Select the best adjustments for each of the offers. The price adjustments are retrieved from those Ts&Cs which references the price list containing the offer.

Calculate the price adjustments for each of the offers.

This command calls the following TaskCommands:

This command uses the following AccessBeans:
See Also:
Serialized Form

Field Summary
static java.lang.String COPYRIGHT
          IBM copyright notice field.
 
Fields inherited from class com.ibm.commerce.command. AbstractECTargetableCommand
commandContext
 
Fields inherited from interface com.ibm.commerce.price.commands. CalculateContractPricesCmd
defaultCommandClassName, NAME
 
Fields inherited from interface com.ibm.commerce.command. ECCommand
defaultCommandClassName
 
Constructor Summary
CalculateContractPricesCmdImpl()
          Constructor
 
Method Summary
protected   QualifyingOfferInfo calculatePriceAdjustment( QualifyingOfferInfo aOfferInfo, PriceTC aBestPriceTC)
          Calculates the result price by applying the best T&C price adjustment to the offer price.
protected  java.lang.String getCurrency()
          Returns the currency to be used for the price.
  ItemPriceInfo[] getItemPriceInfo()
          Returns the internal item info structure.
protected  java.util.Vector getOfferPrices(java.lang.Long anOfferId)
          Returns the OfferPrices of the specified Offer.
 void performExecute()
          Executes main business logic of the command.
protected  PriceTC selectPriceAdjustment(java.lang.Long aItem, java.util.Vector aTcInfoVec)
          Selects the best adjustments for a catalog entry.
 void setCurrency(java.lang.String astrCurrency)
          Sets the currency to be used for finding the price (Optional).
 void setErrorMode(boolean aErrorMode)
          Sets the flag to indicate if exception will be thrown when the price cannot be found for the input catentry (Optional).
 void setItemPriceInfo( ItemPriceInfo[] aItemPriceInfo)
          Sets the item info structure for internal use on calculating the prices.
 void setMasterCatalogPriceListIds(java.lang.Long[] aMasterpriceListIds)
          Sets the ids the price list associated with the Master Catalog (Optional).
 void setPriceListIds(java.lang.Long[] aPriceListIds)
          Sets the ids of the input price lists to be used for retrieving the offers.
 void setStoreId(java.lang.Integer aStoreId)
          Sets the id of the input store to be used for calculating the price (Optional).
 void setTradingABs( TradingAgreementAccessBean[] aTradingABs)
          Sets the input trading agreement access beans for determining the contract prices.
 void setUseGlobalPriceList(boolean aUseGlobalPriceList)
          Sets the flag to indicate if the list of input price lists can be used globally for retrieving the offers for all of the input catentries (Optional).
 void validateParameters()
          Checks mandatory parameters.
 
Methods inherited from class com.ibm.commerce.command. AbstractECTargetableCommand
accessControlCheck, checkIsAllowed, checkParameters, checkResourcePermission, createCommandExecutionEvent, execute, finalize, getAccCheck, getCommandContext, getCommandIfName, getCommandName, getCommandStoreId, getDefaultProperties, getResources, getStoreId, getUser, getUserId, isReadyToCallExecute, reset, setAccCheck, setCommandContext, setCommandIfName, setCommandStoreId, setDefaultProperties
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail
public static final java.lang.String COPYRIGHT
IBM copyright notice field.
See Also:
Constant Field Values
Constructor Detail

CalculateContractPricesCmdImpl

public CalculateContractPricesCmdImpl()
Constructor
Method Detail

calculatePriceAdjustment

protected QualifyingOfferInfo calculatePriceAdjustment(QualifyingOfferInfo aOfferInfo,
PriceTC aBestPriceTC)
                                                throws ECException
Calculates the result price by applying the best T&C price adjustment to the offer price. If a single price cannot be retrieved for the requested currency, all prices associated with the offer will be converted to the target currency and the lowest will be chosen to apply the adjustment.
Parameters:
aOfferInfo - the offer info structure providing the offer id and saving the result price.
aBestPriceTC - the T&C providing the best price adjustment.
Returns:
QualifyingOfferInfo return the prices after the adjustment is done
Throws:
ECException

getCurrency

protected java.lang.String getCurrency()
Returns the currency to be used for the price.
Returns:
String a currency

getItemPriceInfo

public ItemPriceInfo[] getItemPriceInfo()
Returns the internal item info structure.
Specified by:
getItemPriceInfo in interface CalculateContractPricesCmd
Returns:
ItemPriceInfo[] a array of internal item information structure

performExecute

public void performExecute()
                    throws ECException
Executes main business logic of the command.
Specified by:
performExecute in interface ECCommand
Overrides:
performExecute in class AbstractECTargetableCommand
Throws:
ECException

selectPriceAdjustment

protected PriceTC selectPriceAdjustment(java.lang.Long aItem,
                                        java.util.Vector aTcInfoVec)
                                 throws ECException
Selects the best adjustments for a catalog entry. If the adjustment product set is specified, the adjustment will be selected only if the product set includes the catalog entry.
Parameters:
aItem - the catalog entry for searching the adjustment product set.
aTcInfoVec - Ts&Cs containing the adjustment and adjustment product set.
Returns:
The T&C providing the best adjustment.
Throws:
ECException

setCurrency

public void setCurrency(java.lang.String astrCurrency)
Sets the currency to be used for finding the price (Optional).
Specified by:
setCurrency in interface CalculateContractPricesCmd
Parameters:
astrCurrency - a currency

setErrorMode

public void setErrorMode(boolean aErrorMode)
Sets the flag to indicate if exception will be thrown when the price cannot be found for the input catentry (Optional).
Specified by:
setErrorMode in interface CalculateContractPricesCmd
Parameters:
aErrorMode - the exception will be thrown if set true.

setItemPriceInfo

public void setItemPriceInfo(ItemPriceInfo[] aItemPriceInfo)
Sets the item info structure for internal use on calculating the prices.
Specified by:
setItemPriceInfo in interface CalculateContractPricesCmd
Parameters:
aItemPriceInfo - a ItemPriceInfo structure for internal use

setMasterCatalogPriceListIds

public void setMasterCatalogPriceListIds(java.lang.Long[] aMasterpriceListIds)
Sets the ids the price list associated with the Master Catalog (Optional).
Specified by:
setMasterCatalogPriceListIds in interface CalculateContractPricesCmd
Parameters:
aMasterpriceListIds - an array of master pricelists

setPriceListIds

public void setPriceListIds(java.lang.Long[] aPriceListIds)
Sets the ids of the input price lists to be used for retrieving the offers.
Specified by:
setPriceListIds in interface CalculateContractPricesCmd
Parameters:
aPriceListIds - an array of pricelist Ids

setStoreId

public void setStoreId(java.lang.Integer aStoreId)
Sets the id of the input store to be used for calculating the price (Optional).
Specified by:
setStoreId in interface CalculateContractPricesCmd
Parameters:
aStoreId - the ID of the input store

setTradingABs

public void setTradingABs(TradingAgreementAccessBean[] aTradingABs)
Sets the input trading agreement access beans for determining the contract prices.
Specified by:
setTradingABs in interface CalculateContractPricesCmd
Parameters:
aTradingABs - a set of Trading agreement access beans

setUseGlobalPriceList

public void setUseGlobalPriceList(boolean aUseGlobalPriceList)
Sets the flag to indicate if the list of input price lists can be used globally for retrieving the offers for all of the input catentries (Optional).
Specified by:
setUseGlobalPriceList in interface CalculateContractPricesCmd
Parameters:
aUseGlobalPriceList - The indicator to decide if the price lists can be used globally. A true value (default) means apply the price lists globally. A false value means individual set of price lists should be obtained for each catentry (Future Support).

validateParameters

public void validateParameters()
                        throws ECException
Checks mandatory parameters.
Specified by:
validateParameters in interface ECCommand
Overrides:
validateParameters in class AbstractECTargetableCommand
Throws:
ECException

getOfferPrices

protected java.util.Vector getOfferPrices(java.lang.Long anOfferId)
                                   throws ECException
Returns the OfferPrices of the specified Offer.
Parameters:
anOfferId - the Offer ID.
Returns:
the OfferPrices.
Throws:
ECException