Overview | Package | Class | Tree | Deprecated | Index | Help
| © 2004 BEA Systems, Inc.
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## 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

### addItemsFromShoppingCart

    public void addItemsFromShoppingCart(ShoppingCart items)
                                  throws InvalidArgumentException

  Add the ShoppingCartLines from the specified ShoppingCart to this ShoppingCart.

  Throws:
    `InvalidArgumentException`

### addProductItem

    public 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`

### addProductItem

    public 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`

### addShoppingCartLine

    public boolean addShoppingCartLine(ShoppingCartLine element)

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

### addShoppingCartLineCollection

    public boolean addShoppingCartLineCollection(Collection collection)

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

### clearShoppingCartLineCollection

    public void clearShoppingCartLineCollection()

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

### containsShoppingCartLine

    public boolean containsShoppingCartLine(ShoppingCartLine element)

  Returns true if this collection contains the specified element.

### containsShoppingCartLineCollection

    public boolean containsShoppingCartLineCollection(Collection c)

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

### createShoppingCartLine

    public 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.

### equalsShoppingCartLineCollection

    public boolean equalsShoppingCartLineCollection(Object object)

  Compares the specified object with this collection for equality.

### findShoppingCartLine

    public ShoppingCartLine findShoppingCartLine(String productIdentifier)
                                          throws ItemNotInShoppingCartException,
                                                 InvalidArgumentException

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

  Throws:
    `ItemNotInShoppingCartException`
    `InvalidArgumentException`

### getCategoryQuantity

    public double getCategoryQuantity(String categoryId)
                               throws RemoteException

  Count the number of products that belong to a category.

  Throws:
    `RemoteException`

### getNumberOfUnits

    public double getNumberOfUnits()

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

### getOrderDiscountPresentations

    public ArrayList getOrderDiscountPresentations()

  Gets the order level discount list

### getShipping

    public Money getShipping()

  Get the value of shipping

  Returns:
    shipping.

### getShippingDiscountPresentations

    public ArrayList getShippingDiscountPresentations()

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

### getShoppingCartLineCollection

    public Collection getShoppingCartLineCollection()

  Returns the entire collection

### getSubtotal

    public Money getSubtotal()

  Get the value of Subtotal

  Returns:
    Subtotal.

### getTotal

    public Money getTotal()

  Get the value of total

  Returns:
    total.

### getTotal

    public 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

  Throws:
    `InvalidArgumentException`

### getTotalPrice

    public Money getTotalPrice()

  Gets the overal shopping cart total

### isEmpty

    public boolean isEmpty()

  Returns true if the shopping cart has no items

### isShoppingCartLineCollectionEmpty

    public boolean isShoppingCartLineCollectionEmpty()

  Returns true if this collection contains no elements.

### removeAllProductItems

    public void removeAllProductItems()

  Removes all ShoppingCartLines. This resets the entire ShoppingCart.

### removeProductItem

    public ProductItem removeProductItem(String productIdentifier)
                                  throws InvalidArgumentException

  Remove the ShoppingCartLine associated with the Item specified.

  Throws:
    `InvalidArgumentException`

### removeShoppingCartLine

    public boolean removeShoppingCartLine(ShoppingCartLine element)

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

### removeShoppingCartLineCollection

    public boolean removeShoppingCartLineCollection(Collection collection)

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

### retainShoppingCartLineCollection

    public boolean retainShoppingCartLineCollection(Collection collection)

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

### setOrderDiscountPresentations

    public void setOrderDiscountPresentations(ArrayList discountPresentations)

  sets the order level discount list

### setProductItemQuantity

    public 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`

### setShipping

    public void setShipping(Money shipping)

  Set the value of shipping

  Parameters:
    `shipping` - shipping to be set

### setShippingDiscountPresentations

    public void setShippingDiscountPresentations(ArrayList discountPresentations)

  sets Order Discount Description

### setShoppingCartLineCollection

    public void setShoppingCartLineCollection(Collection collection)

  Sets the entire collection

### setSubtotal

    public void setSubtotal(Money subtotal)

  Set the value of subtotal

  Parameters:
    `subtotal` - subtotal to be set

### setTotal

    public void setTotal(Money total)

  Set the value of total

### shoppingCartLineCollectionHashCode

    public int shoppingCartLineCollectionHashCode()

  Returns the hash code value for this collection.

### shoppingCartLineCollectionIterator

    public Iterator shoppingCartLineCollectionIterator()

  Returns an iterator over the elements in this collection.

### shoppingCartLineCollectionSize

    public int shoppingCartLineCollectionSize()

  Returns the number of elements in this collection.

Overview | Package | Class | Tree | Deprecated | Index | Help
| © 2004 BEA Systems, Inc.
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2004 BEA Systems, Inc. All Rights Reserved