de.hybris.platform.configurablebundleservices.bundle.impl

Class DefaultBundleCommerceCartService

java.lang.Object

de.hybris.platform.commerceservices.order.impl.DefaultCommerceCartService

de.hybris.platform.subscriptionservices.subscription.impl.DefaultSubscriptionCommerceCartService

de.hybris.platform.configurablebundleservices.bundle.impl.DefaultBundleCommerceCartService

All Implemented Interfaces:

CommerceCartService, BundleCommerceCartService, SubscriptionCommerceCartService

Deprecated.

since 6.4, see BundleCommerceCartService

@Deprecated
public class DefaultBundleCommerceCartService
extends DefaultSubscriptionCommerceCartService
implements BundleCommerceCartService

Default implementation of BundleCommerceCartService

Field Summary

Fields

Modifier and Type	Field and Description
static int	NEW_BUNDLE Deprecated.
static int	NO_BUNDLE Deprecated.

Fields inherited from class de.hybris.platform.commerceservices.order.impl.DefaultCommerceCartService

ESTIMATED_TAXES

Constructor Summary

Constructors

Constructor and Description
DefaultBundleCommerceCartService() Deprecated.

Method Summary

Modifier and Type	Method and Description
protected java.util.List<CommerceCartModification>	addAutoPickProductsToCart(CartModel masterCartModel, int bundleNo, BundleTemplateModel bundleTemplate, UnitModel unit) Deprecated. Add auto-pick products to the bundle in the cart.
protected CommerceCartModification	addProductToCart(CartModel masterCartModel, ProductModel productModel, long quantityToAdd, UnitModel unit, boolean forceNewEntry, int bundleNo, BundleTemplateModel bundleTemplateModel, java.lang.String xmlProduct, boolean ignoreEmptyBundle) Deprecated. Adds a product to the cart, either as standalone product or as part of a bundle.
CommerceCartModification	addToCart(CartModel masterCartModel, ProductModel productModel, long quantityToAdd, UnitModel unit, boolean forceNewEntry) Deprecated.
java.util.List<CommerceCartModification>	addToCart(CartModel masterCartModel, ProductModel productModel, long quantityToAdd, UnitModel unit, boolean forceNewEntry, int bundleNo, BundleTemplateModel bundleTemplateModel, boolean removeCurrentProducts) Deprecated. Since ages (at least from 5.1)
java.util.List<CommerceCartModification>	addToCart(CartModel masterCartModel, ProductModel productModel, long quantityToAdd, UnitModel unit, boolean forceNewEntry, int bundleNo, BundleTemplateModel bundleTemplateModel, boolean removeCurrentProducts, java.lang.String xmlProduct) Deprecated. Since 6.4 - Use the generic DefaultCommerceCartService.addToCart(CommerceCartParameter)
CommerceCartModification	addToCart(CartModel masterCartModel, ProductModel productModel, long quantityToAdd, UnitModel unit, boolean forceNewEntry, java.lang.String xmlProduct) Deprecated.
java.util.List<CommerceCartModification>	addToCart(CartModel masterCartModel, UnitModel unit, int bundleNo, ProductModel productModel1, BundleTemplateModel bundleTemplateModel1, ProductModel productModel2, BundleTemplateModel bundleTemplateModel2) Deprecated. Since ages (at least from 5.1)
java.util.List<CommerceCartModification>	addToCart(CartModel masterCartModel, UnitModel unit, int bundleNo, ProductModel productModel1, BundleTemplateModel bundleTemplateModel1, ProductModel productModel2, BundleTemplateModel bundleTemplateModel2, java.lang.String xmlProduct1, java.lang.String xmlProduct2) Deprecated. Adds the (existing) ProductModels productModel1 and productModel2 in the given UnitModel and with quantity=1 to the (existing) multi-cart CartModel as new cart entries.
protected CommerceCartModification	addToCartWithoutCalculation(CommerceCartParameter parameter) Deprecated. Run the addToCart in a local context where the session parameter CALCULATE_CART is set to false so that the cart is not yet calculated.
boolean	calculateCart(CartModel cartModel) Deprecated. Overrides the super class' method to make sure that in a multi-cart system the master cart and the child carts are calculated.
java.lang.String	checkAndGetReasonForDisabledProductInComponent(CartModel masterCart, ProductModel product, BundleTemplateModel bundleTemplate, int bundleNo, boolean ignoreCurrentProducts) Deprecated. Checks if the given product which is not yet added to the cart/bundle needs to be disabled within a component.
java.lang.String	checkAndGetReasonForNotRemovableEntry(CartEntryModel cartEntry) Deprecated. Checks whether the given CartEntryModel could be removed from the bundle/cart (only a check, the cart is not modified!) and returns the reason if the removal is not allowed.
protected void	checkAndRemoveDependentComponents(CartModel masterCartModel, int bundleNo, BundleTemplateModel bundleTemplate) Deprecated. If the last item of the given bundleTemplate is deleted all items that belong to components which are dependent on the given bundleTemplate are also removed from the cart.
protected void	checkAutoPickAddToCart(BundleTemplateModel bundleTemplate, ProductModel product) Deprecated. Checks whether the given cartEntry is an auto-pick item and throws an CommerceCartModificationException in that case
protected void	checkAutoPickRemoval(CartEntryModel cartEntry) Deprecated. Checks whether the given cartEntry is an auto-pick item and throws an CommerceCartModificationException in that case
protected void	checkIsComponentDependencyMetAfterRemoval(CartModel masterCart, BundleTemplateModel bundleTemplate, int bundleNo) Deprecated. Checks if an item can be removed from the given component (component).
boolean	checkIsComponentEditable(CartModel masterCart, BundleTemplateModel bundleTemplate, int bundleNo) Deprecated. Checks if the given component bundleTemplate in given bundle bundleNo and masterCart can be edited.
boolean	checkIsComponentSelectionCriteriaMet(CartModel masterCart, BundleTemplateModel bundleTemplate, int bundleNo) Deprecated. Checks if the selection criteria of the given component bundleTemplate in given bundle bundleNo and masterCart is met.
boolean	checkIsEntryRemovable(CartEntryModel cartEntry) Deprecated. Checks whether the given CartEntryModel could be removed from the bundle/cart (only a check, the cart is not modified!).
boolean	checkIsEntryUpdateable(CartEntryModel cartEntry) Deprecated. Checks whether the given cartEntry can be updated.
protected void	checkIsProductAlreadyInComponent(CartModel masterCart, int bundleNo, BundleTemplateModel bundleTemplate, ProductModel product) Deprecated. Checks whether the given product is already added to the given bundleNo and component.
protected void	checkIsSelectionCriteriaNotExceeded(CartModel masterCart, BundleTemplateModel bundleTemplate, int bundleNo) Deprecated. Checks that not too many products are added to the given bundleNo within the given component (component) in the given masterCart.
protected void	checkSelectionCriteriaNotUnderThreshold(CartEntryModel cartEntry) Deprecated.
protected BundleTemplateModel	findAnyRequiredTemplate(CartModel masterCart, BundleTemplateModel bundleTemplate, int bundleNo) Deprecated.
protected OrderEntryDao	getBundleCartEntryDao() Deprecated.
protected AbstractBundleComponentEditableChecker<CartModel>	getBundleComponentEditableChecker() Deprecated.
protected BundleRuleService	getBundleRuleService() Deprecated.
protected BundleTemplateService	getBundleTemplateService() Deprecated.
java.util.List<CartEntryModel>	getCartEntriesForBundle(CartModel masterCart, int bundleNo) Deprecated. Gets the list of for bundleNo.
java.util.List<CartEntryModel>	getCartEntriesForComponentInBundle(CartModel masterCart, BundleTemplateModel component, int bundleNo) Deprecated. Gets the list of CartEntryModel for component and bundleNo.
java.util.List<CartEntryModel>	getCartEntriesForProductInBundle(CartModel masterCart, ProductModel product, int bundleNo) Deprecated. Gets the list of CartEntryModel for Products and bundleNo.
protected java.lang.String	getDisablingReason(CartModel masterCart, ProductModel product, BundleTemplateModel bundleTemplate, int bundleNo, boolean ignoreCurrentProducts) Deprecated.
protected java.lang.Integer	getEntryGroupFor(AbstractOrderModel cartModel, int bundleNo, BundleTemplateModel component) Deprecated. Restores entry group number by given component and bundle number.
protected EntryGroupService	getEntryGroupService() Deprecated.
BundleTemplateModel	getFirstInvalidComponentInCart(CartModel masterCart) Deprecated. Checks the given masterCart if there are invalid components in it.
protected L10NService	getL10NService() Deprecated.
BillingTimeModel	getMasterBillingTime() Deprecated. Get the master BillingTimeModel
protected java.lang.Integer	getNextFreeBundleNo(AbstractOrderModel order) Deprecated.
protected ModifiableChecker<AbstractOrderEntryModel>	getOrderEntryModifiableChecker() Deprecated.
protected RemoveableChecker<CartEntryModel>	getRemovableChecker() Deprecated.
protected java.lang.String	getSelectionCriterionMessage(CartModel masterCart, BundleTemplateModel bundleTemplate, int bundleNo) Deprecated.
SessionService	getSessionService() Deprecated.
void	removeAllEntries(CartModel masterCartModel, int bundleNo) Deprecated. Removes a bundle from the given CartModel and its child carts.
protected void	removeCartEntry(CartModel masterCartModel, CartEntryModel cartEntry) Deprecated. Removes a cart entry without performing any validation checks.
protected void	removeEntriesWithChildren(java.util.List<CartEntryModel> cartEntries, CartModel masterCartModel) Deprecated.
void	setBundleCartEntryDao(OrderEntryDao cartEntryDao) Deprecated.
void	setBundleComponentEditableChecker(AbstractBundleComponentEditableChecker<CartModel> bundleComponentEditableChecker) Deprecated.
void	setBundleRuleService(BundleRuleService bundleRuleService) Deprecated.
void	setBundleTemplateService(BundleTemplateService bundleTemplateService) Deprecated.
protected void	setCartEntriesInSameBundleToNotCalculated(AbstractOrderEntryModel sourceEntry) Deprecated. Sets all other cart entries that belong to the same bundle to "not calculated".
void	setEntryGroupService(EntryGroupService entryGroupService) Deprecated.
void	setL10NService(L10NService l10NService) Deprecated.
void	setOrderEntryModifiableChecker(ModifiableChecker<AbstractOrderEntryModel> orderEntryModifiableChecker) Deprecated.
void	setRemovableChecker(RemoveableChecker<CartEntryModel> removableChecker) Deprecated.
protected void	updateLastModifiedEntriesList(CartModel masterCart, java.util.List<CommerceCartModification> modifications) Deprecated.
CommerceCartModification	updateQuantityForCartEntry(CommerceCartParameter parameter) Deprecated. Update quantity for the cart entry with given entryNumber with the given newQuantity.

Methods inherited from class de.hybris.platform.subscriptionservices.subscription.impl.DefaultSubscriptionCommerceCartService

addOneRecurringFrequency, addToCart, checkMasterCart, checkQuantityToAdd, checkQuantityToAdd, createChildCartForBillingTime, getAvailableStockLevel, getBaseStoreService, getBillingFrequenciesForMasterEntry, getBillingTimeForCode, getBillingTimeService, getCartEntryToBeUpdated, getChildCartForBillingTime, getCommercePriceService, getCommerceStockService, getMasterCartBillingTimeCode, getMasterCartForCartEntry, getSubscriptionCommerceCartStrategy, getSubscriptionProductService, getSubscriptionProductStockQuantity, isMasterCart, recalculateCart, recalculateCart, removeAllEntries, setBaseStoreService, setBillingTimeService, setCommercePriceService, setCommerceStockService, setMasterCartBillingTimeCode, setSubscriptionCommerceCartStrategy, setSubscriptionProductService, setSubscriptionProductStockQuantity, useBillingFrequencyForProduct

Methods inherited from class de.hybris.platform.commerceservices.order.impl.DefaultCommerceCartService

addToCart, addToCart, afterCalculate, beforeCalculate, calculateCart, configureCartEntry, estimateTaxes, estimateTaxes, getBaseSiteService, getCartForCodeAndUser, getCartForGuidAndSite, getCartForGuidAndSiteAndUser, getCartsForSiteAndUser, getCartValidationStrategy, getCommerceAddToCartStrategy, getCommerceCartCalculationStrategy, getCommerceCartDao, getCommerceCartEstimateTaxesStrategy, getCommerceCartHashCalculationStrategy, getCommerceCartMergingStrategy, getCommerceCartMetadataUpdateStrategy, getCommerceCartRestorationStrategy, getCommerceCartSplitStrategy, getCommerceRemoveEntriesStrategy, getCommerceUpdateCartEntryStrategy, getModelService, getProductConfigurationStrategy, getRemoveEntryGroupStrategy, getStaleCartRemovalStrategy, mergeCarts, removeAllEntries, removeEntryGroup, removeStaleCarts, removeStaleCarts, restoreCart, restoreCart, setBaseSiteService, setCartValidationStrategy, setCommerceAddToCartStrategy, setCommerceCartCalculationStrategy, setCommerceCartDao, setCommerceCartEstimateTaxesStrategy, setCommerceCartHashCalculationStrategy, setCommerceCartMergingStrategy, setCommerceCartMetadataUpdateStrategy, setCommerceCartRestorationStrategy, setCommerceCartSplitStrategy, setCommerceRemoveEntriesStrategy, setCommerceUpdateCartEntryStrategy, setModelService, setProductConfigurationStrategy, setRemoveEntryGroupStrategy, setSessionService, setStaleCartRemovalStrategy, split, split, updateCartMetadata, updatePointOfServiceForCartEntry, updatePointOfServiceForCartEntry, updateQuantityForCartEntry, updateToShippingModeForCartEntry, updateToShippingModeForCartEntry, validateCart, validateCart

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.hybris.platform.subscriptionservices.subscription.SubscriptionCommerceCartService

addToCart, checkMasterCart, checkQuantityToAdd, createChildCartForBillingTime, getBillingFrequenciesForMasterEntry, getChildCartForBillingTime, getMasterCartBillingTimeCode, getMasterCartForCartEntry

Methods inherited from interface de.hybris.platform.commerceservices.order.CommerceCartService

addToCart, addToCart, calculateCart, configureCartEntry, estimateTaxes, estimateTaxes, getCartForCodeAndUser, getCartForGuidAndSite, getCartForGuidAndSiteAndUser, getCartsForSiteAndUser, mergeCarts, recalculateCart, recalculateCart, removeAllEntries, removeAllEntries, removeEntryGroup, removeStaleCarts, removeStaleCarts, restoreCart, restoreCart, split, split, updateCartMetadata, updatePointOfServiceForCartEntry, updatePointOfServiceForCartEntry, updateQuantityForCartEntry, updateToShippingModeForCartEntry, updateToShippingModeForCartEntry, validateCart, validateCart

Field Detail

NO_BUNDLE

public static final int NO_BUNDLE

Deprecated.

See Also:

Constant Field Values

NEW_BUNDLE

public static final int NEW_BUNDLE

Deprecated.

See Also:

Constant Field Values

Constructor Detail

DefaultBundleCommerceCartService

public DefaultBundleCommerceCartService()

Deprecated.

Method Detail

addToCart

@Deprecated
public java.util.List<CommerceCartModification> addToCart(CartModel masterCartModel,
                                                                      ProductModel productModel,
                                                                      long quantityToAdd,
                                                                      UnitModel unit,
                                                                      boolean forceNewEntry,
                                                                      int bundleNo,
                                                                      BundleTemplateModel bundleTemplateModel,
                                                                      boolean removeCurrentProducts)
                                                               throws CommerceCartModificationException

Deprecated. Since ages (at least from 5.1)

Description copied from interface: BundleCommerceCartService

Adds the (existing) ProductModel in the given UnitModel and with the given quantity to the (existing) CartModel. If an entry with the given product and given unit exists in the cart already, then the given quantity is added to the quantity of this cart entry unless forceNewEntry is set to true or a subscription product or a product, that is part of a bundle, is added. Dependent on the parameter bundleNo the product is added to an existing or new bundle or treated as a standalone product. In case a new bundle is created the method also adds auto-pick products to the cart if there are any setup for the bundle template. After this the multi-cart is calculated.

Specified by:

addToCart in interface BundleCommerceCartService

Parameters:

masterCartModel - the cart model. It must exist and it must be a master cart.

productModel - the product model that will be added to the cart

quantityToAdd - the quantity of the product

unit - if null ProductService.getOrderableUnit(ProductModel) is used to determine the unit

forceNewEntry - the force new entry if set to true, new cart entry will be created in any case. In case of subscription products and products that are part of a bundle there will be always a new cart entry

bundleNo - indicates to which bundle the product model shall be added (-1=create new bundle; 0=standalone product/no bundle; >0=number of existing bundle)

bundleTemplateModel - current version of the bundleTemplate model based on which the product is added to the cart. It will be stored on the cart entry. If null the product will be treated as a standalone product and the bundleNo must be 0 accordingly.

removeCurrentProducts - whether to remove current products

Returns:

the list of cart modification data CommerceCartModification that includes a statusCode and the actual quantity of the products added to the cart

Throws:

CommerceCartModificationException - if the product is a base product OR the quantity is less than 1 or no usable unit was found (only when given unit is also null) or any other reason the cart could not be modified.

addToCart

@Deprecated
public java.util.List<CommerceCartModification> addToCart(CartModel masterCartModel,
                                                                      ProductModel productModel,
                                                                      long quantityToAdd,
                                                                      UnitModel unit,
                                                                      boolean forceNewEntry,
                                                                      int bundleNo,
                                                                      BundleTemplateModel bundleTemplateModel,
                                                                      boolean removeCurrentProducts,
                                                                      java.lang.String xmlProduct)
                                                               throws CommerceCartModificationException

Deprecated. Since 6.4 - Use the generic DefaultCommerceCartService.addToCart(CommerceCartParameter)

Specified by:

addToCart in interface BundleCommerceCartService

Returns:

the list of cart modification data CommerceCartModification that includes a statusCode and the actual quantity of the products added to the cart

Throws:

CommerceCartModificationException

See Also:

BundleCommerceCartService.addToCart(CartModel, ProductModel, long, UnitModel, boolean, int, BundleTemplateModel, boolean)

addProductToCart

protected CommerceCartModification addProductToCart(CartModel masterCartModel,
                                                    ProductModel productModel,
                                                    long quantityToAdd,
                                                    UnitModel unit,
                                                    boolean forceNewEntry,
                                                    int bundleNo,
                                                    BundleTemplateModel bundleTemplateModel,
                                                    java.lang.String xmlProduct,
                                                    boolean ignoreEmptyBundle)
                                             throws CommerceCartModificationException

Deprecated.

Adds a product to the cart, either as standalone product or as part of a bundle. All relevant bundle validations are checked here. The cart is not calculated in this method, only the new entry + its cart are marked as not calculated (standalone products). In case of bundles all entries of this bundle + all affected carts are marked as not calculated. The calculation itself must be triggered by the calling method.

Throws:

CommerceCartModificationException

getNextFreeBundleNo

protected java.lang.Integer getNextFreeBundleNo(AbstractOrderModel order)

Deprecated.

addToCartWithoutCalculation

protected CommerceCartModification addToCartWithoutCalculation(CommerceCartParameter parameter)
                                                        throws CommerceCartModificationException

Deprecated.

Run the addToCart in a local context where the session parameter CALCULATE_CART is set to false so that the cart is not yet calculated.

Parameters:

parameter - product parameters

Returns:

modification info

Throws:

CommerceCartModificationException - if the addition failed

getEntryGroupFor

protected java.lang.Integer getEntryGroupFor(AbstractOrderModel cartModel,
                                             int bundleNo,
                                             BundleTemplateModel component)

Deprecated.

Restores entry group number by given component and bundle number.

For compatibility to the old version.

Parameters:

cartModel - cart to search in

bundleNo - bundle id

component - bundle component (should be a leaf)

Returns:

entry group number (can be null, e.g. for new bundles)

addToCart

@Deprecated
public java.util.List<CommerceCartModification> addToCart(CartModel masterCartModel,
                                                                      UnitModel unit,
                                                                      int bundleNo,
                                                                      ProductModel productModel1,
                                                                      BundleTemplateModel bundleTemplateModel1,
                                                                      ProductModel productModel2,
                                                                      BundleTemplateModel bundleTemplateModel2)
                                                               throws CommerceCartModificationException

Deprecated. Since ages (at least from 5.1)

Specified by:

addToCart in interface BundleCommerceCartService

Returns:

List of CommerceCartModifications

Throws:

CommerceCartModificationException

See Also:

BundleCommerceCartService.addToCart(CartModel, UnitModel, int, ProductModel, BundleTemplateModel, ProductModel, BundleTemplateModel, String, String)

addToCart

public java.util.List<CommerceCartModification> addToCart(CartModel masterCartModel,
                                                          UnitModel unit,
                                                          int bundleNo,
                                                          ProductModel productModel1,
                                                          BundleTemplateModel bundleTemplateModel1,
                                                          ProductModel productModel2,
                                                          BundleTemplateModel bundleTemplateModel2,
                                                          java.lang.String xmlProduct1,
                                                          java.lang.String xmlProduct2)
                                                   throws CommerceCartModificationException

Deprecated.

Description copied from interface: BundleCommerceCartService

Adds the (existing) ProductModels productModel1 and productModel2 in the given UnitModel and with quantity=1 to the (existing) multi-cart CartModel as new cart entries. As this method works for bundles only, both products must have a bundle template and must be part of an existing bundle or a new bundle that is created during the addToCart. In case a new bundle is created the method also adds auto-pick products to the cart if there are any setup for the bundle template. After this the multi-cart is calculated.

Specified by:

addToCart in interface BundleCommerceCartService

Parameters:

masterCartModel - the cart model. It must exist and it must be a master cart.

unit - if null ProductService.getOrderableUnit(ProductModel) is used to determine the unit

bundleNo - indicates to which bundle the product model shall be added (-1=create new bundle; >0=number of existing bundle; 0=standalone product/no bundle is not allowed here)

productModel1 - the first product model that will be added to the cart

bundleTemplateModel1 - current version of the bundleTemplate model based on which the first product is added to the cart. It will be stored on the cart entry. The parameter cannot be null.

productModel2 - the second product model that will be added to the cart

bundleTemplateModel2 - current version of the bundleTemplate model based on which the second product is added to the cart. It will be stored on the cart entry. The parameter cannot be null.

xmlProduct1 - first product in xml format

xmlProduct2 - second product in xml format

Returns:

the list of cart modification data CommerceCartModification that includes a statusCode and the actual quantity of the products added to the cart

Throws:

CommerceCartModificationException - if the product is a base product OR the quantity is less than 1 or no usable unit was found (only when given unit is also null) or the bundle parameters were empty/wrong or any other reason the cart could not be modified.

addToCart

public CommerceCartModification addToCart(CartModel masterCartModel,
                                          ProductModel productModel,
                                          long quantityToAdd,
                                          UnitModel unit,
                                          boolean forceNewEntry)
                                   throws CommerceCartModificationException

Deprecated.

Specified by:

addToCart in interface CommerceCartService

Overrides:

addToCart in class DefaultSubscriptionCommerceCartService

Parameters:

masterCartModel - the user's cart in session

productModel - the ProductModel to add

quantityToAdd - the quantity to add

unit - the UnitModel of the product @see ProductModel.getUnit()

forceNewEntry - the flag for creating a new CartEntryModel

Returns:

the cart modification

Throws:

CommerceCartModificationException

addToCart

public CommerceCartModification addToCart(CartModel masterCartModel,
                                          ProductModel productModel,
                                          long quantityToAdd,
                                          UnitModel unit,
                                          boolean forceNewEntry,
                                          java.lang.String xmlProduct)
                                   throws CommerceCartModificationException

Deprecated.

Specified by:

addToCart in interface SubscriptionCommerceCartService

Overrides:

addToCart in class DefaultSubscriptionCommerceCartService

Parameters:

masterCartModel - master cart

productModel - the ProductModel to add

quantityToAdd - the quantity to add

unit - the UnitModel of the product

forceNewEntry - the flag for creating a new

Returns:

the cart modification

Throws:

CommerceCartModificationException

updateQuantityForCartEntry

public CommerceCartModification updateQuantityForCartEntry(CommerceCartParameter parameter)
                                                    throws CommerceCartModificationException

Deprecated.

Description copied from interface: CommerceCartService

Update quantity for the cart entry with given entryNumber with the given newQuantity. Then cart is calculated.

Specified by:

updateQuantityForCartEntry in interface CommerceCartService

Overrides:

updateQuantityForCartEntry in class DefaultCommerceCartService

Parameters:

parameter - - A parameter object containing all attributes needed for add to cart

CommerceCartParameter.cart - The user's cart in session CommerceCartParameter.pointOfService - The store object for pick up in store items (only needs to be passed in if you are adding an item to pick up CommerceCartParameter.product - The ProductModel to add CommerceCartParameter.quantity - The quantity to add CommerceCartParameter.unit - The UnitModel of the product @see ProductModel.getUnit() CommerceCartParameter.createNewEntry - The flag for creating a new CartEntryModel

Returns:

the cart modification data that includes a statusCode and the actual quantity that the entry was updated to

Throws:

CommerceCartModificationException - if the product is a base product OR the quantity is less than 1 or no usable unit was found (only when given unit is also null) or any other reason the cart could not be modified.

setCartEntriesInSameBundleToNotCalculated

protected void setCartEntriesInSameBundleToNotCalculated(AbstractOrderEntryModel sourceEntry)

Deprecated.

Sets all other cart entries that belong to the same bundle to "not calculated". As the prices within a bundle may vary dependent on the bundle entries a re-calculation of the whole bundle (and all the carts that contain entries of the affected bundle) is necessary.

checkIsProductAlreadyInComponent

protected void checkIsProductAlreadyInComponent(CartModel masterCart,
                                                int bundleNo,
                                                BundleTemplateModel bundleTemplate,
                                                ProductModel product)
                                         throws CommerceCartModificationException

Deprecated.

Checks whether the given product is already added to the given bundleNo and component. As it is not allowed to add the same product more than once to the same component an CommerceCartModificationException is thrown in case the product is already in the component.

Throws:

CommerceCartModificationException

checkIsSelectionCriteriaNotExceeded

protected void checkIsSelectionCriteriaNotExceeded(CartModel masterCart,
                                                   BundleTemplateModel bundleTemplate,
                                                   int bundleNo)
                                            throws CommerceCartModificationException

Deprecated.

Checks that not too many products are added to the given bundleNo within the given component (component) in the given masterCart. The check is based on the selectionCriteria of the given component which limit the max. possible product selections.

Throws:

CommerceCartModificationException

checkIsEntryRemovable

public boolean checkIsEntryRemovable(CartEntryModel cartEntry)

Deprecated.

Description copied from interface: BundleCommerceCartService

Checks whether the given CartEntryModel could be removed from the bundle/cart (only a check, the cart is not modified!). The check is based on the selectionCritera of the given cartEntry's component (bundle template). If with the removal of the given cartEntry the lower limit of required product selections would not be met any more, the check returns false, otherwise true.

Specified by:

checkIsEntryRemovable in interface BundleCommerceCartService

Parameters:

cartEntry - cart entry that is checked whether it can be removed from the cart/bundle

Returns:

true if the given cartEntry can be removed from the cart, otherwise false

checkAndGetReasonForNotRemovableEntry

public java.lang.String checkAndGetReasonForNotRemovableEntry(CartEntryModel cartEntry)

Deprecated.

Description copied from interface: BundleCommerceCartService

Checks whether the given CartEntryModel could be removed from the bundle/cart (only a check, the cart is not modified!) and returns the reason if the removal is not allowed. The check is based on the selectionCritera of the given cartEntry's component (bundle template). If with the removal of the given cartEntry the lower limit of required product selections would not be met any more, the check returns the reason as String, otherwise null.

Specified by:

checkAndGetReasonForNotRemovableEntry in interface BundleCommerceCartService

Parameters:

cartEntry - cart entry that is checked whether it can be removed from the cart/bundle

Returns:

the reason as String why the given cartEntry cannot be removed, otherwise null

checkSelectionCriteriaNotUnderThreshold

protected void checkSelectionCriteriaNotUnderThreshold(CartEntryModel cartEntry)
                                                throws CommerceCartModificationException

Deprecated.

Throws:

CommerceCartModificationException

checkAutoPickRemoval

protected void checkAutoPickRemoval(CartEntryModel cartEntry)
                             throws CommerceCartModificationException

Deprecated.

Checks whether the given cartEntry is an auto-pick item and throws an CommerceCartModificationException in that case

Throws:

CommerceCartModificationException

checkAutoPickAddToCart

protected void checkAutoPickAddToCart(BundleTemplateModel bundleTemplate,
                                      ProductModel product)
                               throws CommerceCartModificationException

Deprecated.

Checks whether the given cartEntry is an auto-pick item and throws an CommerceCartModificationException in that case

Throws:

CommerceCartModificationException

addAutoPickProductsToCart

protected java.util.List<CommerceCartModification> addAutoPickProductsToCart(CartModel masterCartModel,
                                                                             int bundleNo,
                                                                             BundleTemplateModel bundleTemplate,
                                                                             UnitModel unit)
                                                                      throws CommerceCartModificationException

Deprecated.

Add auto-pick products to the bundle in the cart. The root bundle template's components (= child templates) are investigated if their selection criteria type is auto-pick. If so, the component's products are automatically added to the bundle. The cart is not calculated here. Assumption is that there are no dependencies of the auto-pick components to each other or to other components in the bundle.

Throws:

CommerceCartModificationException

removeAllEntries

public void removeAllEntries(CartModel masterCartModel,
                             int bundleNo)
                      throws CommerceCartModificationException

Deprecated.

Description copied from interface: BundleCommerceCartService

Removes a bundle from the given CartModel and its child carts. The given CartModel must be a master cart. All entries within the multi-cart (master + child carts) that belong to the same bundle identified by the given bundleNo are removed from the multi cart.

Specified by:

removeAllEntries in interface BundleCommerceCartService

Parameters:

masterCartModel - the CartModel. It must exist and it must be a master cart.

bundleNo - the number of the bundle

Throws:

CommerceCartModificationException - if the given CartModel is not a master cart

checkAndRemoveDependentComponents

protected void checkAndRemoveDependentComponents(CartModel masterCartModel,
                                                 int bundleNo,
                                                 BundleTemplateModel bundleTemplate)

Deprecated.

If the last item of the given bundleTemplate is deleted all items that belong to components which are dependent on the given bundleTemplate are also removed from the cart. Only components that have a direct dependency on the given bundleTemplate are deleted. Components that have an indirect dependency (via a 3rd component) are not removed (this method has to be overridden to implement this feature).

removeEntriesWithChildren

protected void removeEntriesWithChildren(java.util.List<CartEntryModel> cartEntries,
                                         CartModel masterCartModel)

Deprecated.

removeCartEntry

protected void removeCartEntry(CartModel masterCartModel,
                               CartEntryModel cartEntry)

Deprecated.

Removes a cart entry without performing any validation checks. The cart from which the entry is removed is not recalculated but flagged as not-calculated. In case the last entry of a child cart is removed the empty child cart is also deleted.

calculateCart

public boolean calculateCart(CartModel cartModel)

Deprecated.

Overrides the super class' method to make sure that in a multi-cart system the master cart and the child carts are calculated. The calculation is not triggered if the session attribute CALCULATE_CART exists and is set to Boolean.False

Specified by:

calculateCart in interface CommerceCartService

Overrides:

calculateCart in class DefaultCommerceCartService

Parameters:

cartModel - the user's cart in session

Returns:

false if the cartModel was already calculated

checkIsEntryUpdateable

public boolean checkIsEntryUpdateable(CartEntryModel cartEntry)

Deprecated.

Description copied from interface: BundleCommerceCartService

Checks whether the given cartEntry can be updated. Any cart entry CartEntryModel belonging to a bundle BundleTemplateModel cannot be updated.

Specified by:

checkIsEntryUpdateable in interface BundleCommerceCartService

Parameters:

cartEntry - cart Entry that is checked

Returns:

true if given cartEntry can be update, otherwise false

checkIsComponentEditable

public boolean checkIsComponentEditable(CartModel masterCart,
                                        BundleTemplateModel bundleTemplate,
                                        int bundleNo)

Deprecated.

Description copied from interface: BundleCommerceCartService

Checks if the given component bundleTemplate in given bundle bundleNo and masterCart can be edited. The check is based on the selection dependencies of the given bundleTemplate. In case the given bundleTemplate's selection criteria is of type AutoPickBundleSelectionCriteriaModel, it is never editable.

Specified by:

checkIsComponentEditable in interface BundleCommerceCartService

Parameters:

masterCart - the master cart the bundle is in

bundleTemplate - the component that is checked whether it can be edited

bundleNo - the number of the bundle the given bundleTemplate belongs to

Returns:

true if the selection dependencies are fulfilled and the component can be edited, otherwise false

checkIsComponentSelectionCriteriaMet

public boolean checkIsComponentSelectionCriteriaMet(CartModel masterCart,
                                                    BundleTemplateModel bundleTemplate,
                                                    int bundleNo)

Deprecated.

Description copied from interface: BundleCommerceCartService

Checks if the selection criteria of the given component bundleTemplate in given bundle bundleNo and masterCart is met.

Specified by:

checkIsComponentSelectionCriteriaMet in interface BundleCommerceCartService

Parameters:

masterCart - the master cart the bundle is in

bundleTemplate - the component that is checked whether its selection criteria is met

bundleNo - the number of the bundle the given bundleTemplate belongs to

Returns:

true if given bundleTemplate's's selection criteria is met, otherwise false

checkIsComponentDependencyMetAfterRemoval

protected void checkIsComponentDependencyMetAfterRemoval(CartModel masterCart,
                                                         BundleTemplateModel bundleTemplate,
                                                         int bundleNo)
                                                  throws CommerceCartModificationException

Deprecated.

Checks if an item can be removed from the given component (component). If the given component becomes invalid or would be removed completely (if last item is deleted), other components in the same bundle would also become invalid if they have a dependency on the given component. In that case an exception is thrown

Throws:

CommerceCartModificationException

findAnyRequiredTemplate

protected BundleTemplateModel findAnyRequiredTemplate(CartModel masterCart,
                                                      BundleTemplateModel bundleTemplate,
                                                      int bundleNo)

Deprecated.

checkAndGetReasonForDisabledProductInComponent

public java.lang.String checkAndGetReasonForDisabledProductInComponent(CartModel masterCart,
                                                                       ProductModel product,
                                                                       BundleTemplateModel bundleTemplate,
                                                                       int bundleNo,
                                                                       boolean ignoreCurrentProducts)

Deprecated.

Description copied from interface: BundleCommerceCartService

Checks if the given product which is not yet added to the cart/bundle needs to be disabled within a component. A product needs to be disabled if a disable rule is applicable (see description of method isProductDisabledInBundle() above) and/or the selection criteria of the component is exceeded. If the given product needs to be disabled the reason is returned as String. If ignoreCurrentProducts is enabled, then all product of the current component will be ignored when finding disable rules.

Specified by:

checkAndGetReasonForDisabledProductInComponent in interface BundleCommerceCartService

Parameters:

masterCart - the master cart the bundle is in

product - the product which is to be added to the given bundleNo

bundleTemplate - the component to which the given product is linked

bundleNo - the number of the bundle the given bundleTemplate and product belong to or will be added

ignoreCurrentProducts - if current products should be ignored

Returns:

the reason as String why the given product needs to be disabled, otherwise null

getSelectionCriterionMessage

protected java.lang.String getSelectionCriterionMessage(CartModel masterCart,
                                                        BundleTemplateModel bundleTemplate,
                                                        int bundleNo)

Deprecated.

getDisablingReason

protected java.lang.String getDisablingReason(CartModel masterCart,
                                              ProductModel product,
                                              BundleTemplateModel bundleTemplate,
                                              int bundleNo,
                                              boolean ignoreCurrentProducts)

Deprecated.

getCartEntriesForProductInBundle

public java.util.List<CartEntryModel> getCartEntriesForProductInBundle(CartModel masterCart,
                                                                       ProductModel product,
                                                                       int bundleNo)

Deprecated.

Description copied from interface: BundleCommerceCartService

Gets the list of CartEntryModel for Products and bundleNo.

Specified by:

getCartEntriesForProductInBundle in interface BundleCommerceCartService

Parameters:

masterCart - the master cart the bundle is in

product - the product for which the cartentries should be found

bundleNo - the bundleNo for which the cartentries should be found

Returns:

List

getCartEntriesForComponentInBundle

public java.util.List<CartEntryModel> getCartEntriesForComponentInBundle(CartModel masterCart,
                                                                         BundleTemplateModel component,
                                                                         int bundleNo)

Deprecated.

Description copied from interface: BundleCommerceCartService

Gets the list of CartEntryModel for component and bundleNo.

Specified by:

getCartEntriesForComponentInBundle in interface BundleCommerceCartService

Parameters:

masterCart - the master cart the bundle is in

component - the component for which the cartentries should be found

bundleNo - the bundleNo for which the cartentries should be found

Returns:

List

getCartEntriesForBundle

public java.util.List<CartEntryModel> getCartEntriesForBundle(CartModel masterCart,
                                                              int bundleNo)

Deprecated.

Description copied from interface: BundleCommerceCartService

Gets the list of for bundleNo.

Specified by:

getCartEntriesForBundle in interface BundleCommerceCartService

Parameters:

masterCart - the master cart the bundle is in

bundleNo - the bundleNo for which the cartEntries should be found

Returns:

list of CartEntryModel with specific bundle number

getFirstInvalidComponentInCart

public BundleTemplateModel getFirstInvalidComponentInCart(CartModel masterCart)

Deprecated.

Description copied from interface: BundleCommerceCartService

Checks the given masterCart if there are invalid components in it.

Specified by:

getFirstInvalidComponentInCart in interface BundleCommerceCartService

Returns:

the first invalid component BundleTemplateModel if there is one, otherwise null

updateLastModifiedEntriesList

protected void updateLastModifiedEntriesList(CartModel masterCart,
                                             java.util.List<CommerceCartModification> modifications)

Deprecated.

setBundleTemplateService

public void setBundleTemplateService(BundleTemplateService bundleTemplateService)

Deprecated.

getBundleTemplateService

protected BundleTemplateService getBundleTemplateService()

Deprecated.

setBundleCartEntryDao

public void setBundleCartEntryDao(OrderEntryDao cartEntryDao)

Deprecated.

getBundleCartEntryDao

protected OrderEntryDao getBundleCartEntryDao()

Deprecated.

getRemovableChecker

protected RemoveableChecker<CartEntryModel> getRemovableChecker()

Deprecated.

setRemovableChecker

public void setRemovableChecker(RemoveableChecker<CartEntryModel> removableChecker)

Deprecated.

setOrderEntryModifiableChecker

public void setOrderEntryModifiableChecker(ModifiableChecker<AbstractOrderEntryModel> orderEntryModifiableChecker)

Deprecated.

getOrderEntryModifiableChecker

protected ModifiableChecker<AbstractOrderEntryModel> getOrderEntryModifiableChecker()

Deprecated.

setBundleComponentEditableChecker

public void setBundleComponentEditableChecker(AbstractBundleComponentEditableChecker<CartModel> bundleComponentEditableChecker)

Deprecated.

getBundleComponentEditableChecker

protected AbstractBundleComponentEditableChecker<CartModel> getBundleComponentEditableChecker()

Deprecated.

setBundleRuleService

public void setBundleRuleService(BundleRuleService bundleRuleService)

Deprecated.

getBundleRuleService

protected BundleRuleService getBundleRuleService()

Deprecated.

getMasterBillingTime

public BillingTimeModel getMasterBillingTime()

Deprecated.

Description copied from interface: BundleCommerceCartService

Get the master BillingTimeModel

Specified by:

getMasterBillingTime in interface BundleCommerceCartService

Returns:

BillingTimeModel

setL10NService

public void setL10NService(L10NService l10NService)

Deprecated.

getL10NService

protected L10NService getL10NService()

Deprecated.

getSessionService

public SessionService getSessionService()

Deprecated.

Overrides:

getSessionService in class DefaultCommerceCartService

getEntryGroupService

protected EntryGroupService getEntryGroupService()

Deprecated.

setEntryGroupService

public void setEntryGroupService(EntryGroupService entryGroupService)

Deprecated.