com.beasys.commerce.ebusiness.catalog.service.item
Interface ProductItemManagerBusiness

All Known Subinterfaces:

ProductItemManager

All Known Implementing Classes:

CMProductItemManagerBean, JdbcProductItemManagerImpl

public interface ProductItemManagerBusiness

Service interface for managing Product Items.

Method Summary

void	createItem(CatalogRequest request, ProductItem product) Creates a new product item.
ProductItem	getItem(CatalogRequest request, ProductItemKey productKey) Returns the product item with the specified key.
int	getItemCount(CatalogRequest request) Returns the number of product items in the product catalog.
ProductItemKey[]	getItemKeys(CatalogRequest request, int beginIndex, int endIndex) Returns an array over all existing product item keys within the specified ordered range.
ViewIterator	getItems(CatalogRequest request, int viewSize) Returns a ViewIterator over all existing product items.
ProductItem[]	getItems(CatalogRequest request, ProductItemKey[] productKeys) Returns the product items with the given product item keys.
String[]	getKeywords(CatalogRequest request, ProductItemKey productKey) Returns the keywords associated with a given product item.
void	removeItem(CatalogRequest request, ProductItemKey productKey) Removes a product item.
void	setKeywords(CatalogRequest request, ProductItemKey productKey, String[] keywords) Sets the keywords for a given product item.
void	updateItem(CatalogRequest request, ProductItem product) Updates a product item.

Method Detail

getItemCount

int getItemCount(CatalogRequest request)
                 throws RemoteException,
                        CatalogException

Returns the number of product items in the product catalog.

Parameters

request - The catalog request object

Returns

The number of product items in the product catalog.

Throws

CatalogException - on general error.

RemoteException

getItem

ProductItem getItem(CatalogRequest request,
                    ProductItemKey productKey)
                    throws RemoteException,
                           CatalogFinderException,
                           CatalogException

Returns the product item with the specified key.

Parameters

request - The catalog request object.

productKey - The key of the target product.

Throws

CatalogFinderException - if the product item could not be found.

CatalogException - on general error.

RemoteException

getItems

ProductItem[] getItems(CatalogRequest request,
                       ProductItemKey[] productKeys)
                       throws RemoteException,
                              CatalogFinderException,
                              CatalogException

Returns the product items with the given product item keys.

Parameters

request - The catalog request object.

productKeys - The keys of the target product items.

Returns

The product items with the given product item keys.

Throws

CatalogFinderException - if a product item with a given key does not exist.

CatalogException - on general error.

RemoteException

getItemKeys

ProductItemKey[] getItemKeys(CatalogRequest request,
                             int beginIndex,
                             int endIndex)
                             throws RemoteException,
                                    CatalogException

Returns an array over all existing product item keys within the specified ordered range.

Parameters

request - The catalog request object.

beginIndex - The lower bound index for returned product item keys.

endIndex - The upper bound index for returned product item keys.

Returns

An array of the product item keys.

Throws

CatalogException - on general error.

RemoteException

getItems

ViewIterator getItems(CatalogRequest request,
                      int viewSize)
                      throws RemoteException,
                             CatalogException

Returns a ViewIterator over all existing product items.

Parameters

request - The catalog request object.

viewSize - The view size of the returned ViewIterator.

Returns

A ViewIterator over all existing product items.

Throws

CatalogException - on general error.

RemoteException

getKeywords

String[] getKeywords(CatalogRequest request,
                     ProductItemKey productKey)
                     throws RemoteException,
                            CatalogFinderException,
                            CatalogException

Returns the keywords associated with a given product item.

Parameters

request - The catalog request object.

productKey - The key of the target product.

Returns

The keywords associated with the given product item. If there are no keywords associated with the item, a zero length <code>String</code> array is returned.

Throws

CatalogFinderException - if the product item could not be found.

CatalogException - on general error.

RemoteException

setKeywords

void setKeywords(CatalogRequest request,
                 ProductItemKey productKey,
                 String[] keywords)
                 throws RemoteException,
                        CatalogFinderException,
                        CatalogException

Sets the keywords for a given product item.

Parameters

request - The catalog request object.

productKey - The key of the target product.

keywords - The keywords to associate with the given product item.

Throws

CatalogFinderException - if the product item could not be found.

CatalogException - on general error.

RemoteException

createItem

void createItem(CatalogRequest request,
                ProductItem product)
                throws RemoteException,
                       CatalogCreateException,
                       CatalogException

Creates a new product item.

Parameters

request - The catalog request object.

product - The product item to persist.

Throws

CatalogCreateException - if the product item could not be created.

CatalogException - on general error.

RemoteException

updateItem

void updateItem(CatalogRequest request,
                ProductItem product)
                throws RemoteException,
                       CatalogFinderException,
                       CatalogException

Updates a product item.

Parameters

request - The catalog request object.

product - The product item to update.

Throws

CatalogFinderException - if the product item could not be found.

CatalogException - on general error.

RemoteException

removeItem

void removeItem(CatalogRequest request,
                ProductItemKey productKey)
                throws RemoteException,
                       CatalogRemoveException,
                       CatalogFinderException,
                       CatalogException

Removes a product item.

Parameters

request - The catalog request object.

productKey - key of the product item to remove.

Throws

CatalogRemoveException - if the product item could not be removed.

CatalogFinderException - if the product item could not be found.

CatalogException - on general error.

RemoteException