com.beasys.commerce.ebusiness.shoppingcart
Interface ShoppingCart

All Superinterfaces

Belonging, BusinessSmartComponent, Cloneable, Comparable, Serializable

All Known Implementing Classes:

ShoppingCartImpl

public interface ShoppingCart
extends Belonging

The ShoppingCart is used to contain a list of ShoppingCartLines. Each ShoppingCartLine contains a unique item. If the customer adds a ProductItem that is already in the shopping cart, the quantity of the existing ShoppingCartLine is increased.

See Also

ShoppingCartHome, ShoppingCartLine

Method Summary

void	addItemsFromShoppingCart(ShoppingCart items) Add the ShoppingCartLines from the specified ShoppingCart to this ShoppingCart.
ShoppingCartLine	addProductItem(ProductItem item, double quantity) Add an Item to the ShoppingCart.
ShoppingCartLine	addProductItem(ProductItem item, double quantity, Money unitMoney) Add an Item to the ShoppingCart.
boolean	addShoppingCartLine(ShoppingCartLine element) Ensures that this collection contains the specified element (optional operation).
boolean	addShoppingCartLineCollection(Collection collection) Adds all of the elements in the specified collection to this collection (optional operation).
void	clearShoppingCartLineCollection() Removes all of the elements from this collection (optional operation).
boolean	containsShoppingCartLine(ShoppingCartLine element) Returns true if this collection contains the specified element.
boolean	containsShoppingCartLineCollection(Collection c) Returns true if this collection contains all of the elements in the specified collection.
ShoppingCartLine	createShoppingCartLine() Used internally by the ShoppingCart to create ShoppingCartLines.
boolean	equalsShoppingCartLineCollection(Object object) Compares the specified object with this collection for equality.
ShoppingCartLine	findShoppingCartLine(String productIdentifier) Find the ShoppingCartLine associated with the specified Item.
double	getCategoryQuantity(String categoryId) Count the number of products that belong to a category.
double	getNumberOfUnits() Count the total quantity of items by summing the quantity on each line.
ArrayList	getOrderDiscountPresentations() Gets the order level discount list
Money	getShipping() Get the value of shipping
ArrayList	getShippingDiscountPresentations() Accessor method for the presentation of the discounts applied to the shipping, used by JSP pages for instance
Collection	getShoppingCartLineCollection() Returns the entire collection
Money	getSubtotal() Get the value of Subtotal
Money	getTotal() Get the value of total
Money	getTotal(int totalType) Gets the shopping cart total for the given total type.
Money	getTotalPrice() Gets the overal shopping cart total
boolean	isEmpty() Returns true if the shopping cart has no items
boolean	isShoppingCartLineCollectionEmpty() Returns true if this collection contains no elements.
void	removeAllProductItems() Removes all ShoppingCartLines.
ProductItem	removeProductItem(String productIdentifier) Remove the ShoppingCartLine associated with the Item specified.
boolean	removeShoppingCartLine(ShoppingCartLine element) Removes a single instance of the specified element from this collection, if it is present (optional operation).
boolean	removeShoppingCartLineCollection(Collection collection) Removes all this collection's elements that are also contained in the specified collection (optional operation).
boolean	retainShoppingCartLineCollection(Collection collection) Retains only the elements in this collection that are contained in the specified collection (optional operation).
void	setOrderDiscountPresentations(ArrayList discountPresentations) sets the order level discount list
void	setProductItemQuantity(ProductItem item, double quantity) Sets the Quantity of the ShoppingCartLine associated with this Item.
void	setShipping(Money shipping) Set the value of shipping
void	setShippingDiscountPresentations(ArrayList discountPresentations) sets Order Discount Description
void	setShoppingCartLineCollection(Collection collection) Sets the entire collection
void	setSubtotal(Money subtotal) Set the value of subtotal
void	setTotal(Money total) Set the value of total
int	shoppingCartLineCollectionHashCode() Returns the hash code value for this collection.
Iterator	shoppingCartLineCollectionIterator() Returns an iterator over the elements in this collection.
int	shoppingCartLineCollectionSize() Returns the number of elements in this collection.

Methods inherited from interface com.beasys.commerce.foundation.Belonging

clone, equals, interfaceName, setByValue, value

Methods inherited from interface java.lang.Comparable

compareTo

Method Detail

getTotal

Money getTotal()

Get the value of total

Returns

total.

setTotal

void setTotal(Money total)

Set the value of total

Parameters

subtotal - total to be set

getSubtotal

Money getSubtotal()

Get the value of Subtotal

Returns

Subtotal.

setSubtotal

void setSubtotal(Money subtotal)

Set the value of subtotal

Parameters

subtotal - subtotal to be set

getShipping

Money getShipping()

Get the value of shipping

Returns

shipping.

setShipping

void setShipping(Money shipping)

Set the value of shipping

Parameters

shipping - shipping to be set

getShoppingCartLineCollection

Collection getShoppingCartLineCollection()

Returns the entire collection

setShoppingCartLineCollection

void setShoppingCartLineCollection(Collection collection)

Sets the entire collection

addShoppingCartLine

boolean addShoppingCartLine(ShoppingCartLine element)

Ensures that this collection contains the specified element (optional operation).

addShoppingCartLineCollection

boolean addShoppingCartLineCollection(Collection collection)

Adds all of the elements in the specified collection to this collection (optional operation).

clearShoppingCartLineCollection

void clearShoppingCartLineCollection()

Removes all of the elements from this collection (optional operation).

containsShoppingCartLine

boolean containsShoppingCartLine(ShoppingCartLine element)

Returns true if this collection contains the specified element.

containsShoppingCartLineCollection

boolean containsShoppingCartLineCollection(Collection c)

Returns true if this collection contains all of the elements in the specified collection.

equalsShoppingCartLineCollection

boolean equalsShoppingCartLineCollection(Object object)

Compares the specified object with this collection for equality.

shoppingCartLineCollectionHashCode

int shoppingCartLineCollectionHashCode()

Returns the hash code value for this collection.

isShoppingCartLineCollectionEmpty

boolean isShoppingCartLineCollectionEmpty()

Returns true if this collection contains no elements.

shoppingCartLineCollectionIterator

Iterator shoppingCartLineCollectionIterator()

Returns an iterator over the elements in this collection.

removeShoppingCartLine

boolean removeShoppingCartLine(ShoppingCartLine element)

Removes a single instance of the specified element from this collection, if it is present (optional operation).

removeShoppingCartLineCollection

boolean removeShoppingCartLineCollection(Collection collection)

Removes all this collection's elements that are also contained in the specified collection (optional operation).

retainShoppingCartLineCollection

boolean retainShoppingCartLineCollection(Collection collection)

Retains only the elements in this collection that are contained in the specified collection (optional operation).

shoppingCartLineCollectionSize

int shoppingCartLineCollectionSize()

Returns the number of elements in this collection.

addItemsFromShoppingCart

void addItemsFromShoppingCart(ShoppingCart items)
                              throws InvalidArgumentException

Add the ShoppingCartLines from the specified ShoppingCart to this ShoppingCart.

Throws

InvalidArgumentException

addProductItem

ShoppingCartLine addProductItem(ProductItem item,
                                double quantity)
                                throws InvalidArgumentException

Add an Item to the ShoppingCart. If the Item is already in the ShoppingCart, increase its quantity.

Throws

InvalidArgumentException

setProductItemQuantity

void setProductItemQuantity(ProductItem item,
                            double quantity)
                            throws InvalidArgumentException

Sets the Quantity of the ShoppingCartLine associated with this Item. A new ShoppingCartLine is created if the Item is not present. This differs from addItem in that this method explicitly sets the absolute Quantity of a ShoppingCartLine rather than incrementing the existing value .

Throws

InvalidArgumentException

removeProductItem

ProductItem removeProductItem(String productIdentifier)
                              throws InvalidArgumentException

Remove the ShoppingCartLine associated with the Item specified.

Parameters

productIdentifier, - (See productItem.getKey( ).getIdentifier( ) )

Throws

InvalidArgumentException

removeAllProductItems

void removeAllProductItems()

Removes all ShoppingCartLines. This resets the entire ShoppingCart.

findShoppingCartLine

ShoppingCartLine findShoppingCartLine(String productIdentifier)
                                      throws ItemNotInShoppingCartException,
                                             InvalidArgumentException

Find the ShoppingCartLine associated with the specified Item. Throws an ItemNotInShoppingCartException if the Item cannot be found.

Parameters

productIdentifier, - (See productItem.getKey( ).getIdentifier( ) )

Throws

ItemNotInShoppingCartException

InvalidArgumentException

getNumberOfUnits

double getNumberOfUnits()

Count the total quantity of items by summing the quantity on each line.

getCategoryQuantity

double getCategoryQuantity(String categoryId)
                           throws RemoteException

Count the number of products that belong to a category.

Throws

RemoteException

createShoppingCartLine

ShoppingCartLine createShoppingCartLine()

Used internally by the ShoppingCart to create ShoppingCartLines. If ShoppingCart is used to manage a list of lines that extend ShoppingCartLine, this method should be overridden to return an instance of the appropiate sub class.

addProductItem

ShoppingCartLine addProductItem(ProductItem item,
                                double quantity,
                                Money unitMoney)
                                throws InvalidArgumentException

Add an Item to the ShoppingCart. If the Item is already in the ShoppingCart, increase its quantity.

Throws

InvalidArgumentException

isEmpty

boolean isEmpty()

Returns true if the shopping cart has no items

getTotal

Money getTotal(int totalType)
               throws InvalidArgumentException

Gets the shopping cart total for the given total type. Valid values are one or more of :

• LINE_UNIT_PRICE_TIMES_QUANTITY
• LINE_SHIPPING
• LINE_TAX
• SHOPPING_CART_SHIPPING

Parameters

total - type

Throws

InvalidArgumentException

getTotalPrice

Money getTotalPrice()

Gets the overal shopping cart total

getOrderDiscountPresentations

ArrayList getOrderDiscountPresentations()

Gets the order level discount list

setOrderDiscountPresentations

void setOrderDiscountPresentations(ArrayList discountPresentations)

sets the order level discount list

getShippingDiscountPresentations

ArrayList getShippingDiscountPresentations()

Accessor method for the presentation of the discounts applied to the shipping, used by JSP pages for instance

setShippingDiscountPresentations

void setShippingDiscountPresentations(ArrayList discountPresentations)

sets Order Discount Description