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

public interface JdbcProductItemManager

extends JdbcCatalogService

JDBC-specific ProductItemManager service implementation.

See Also:

JdbcProductItemManagerHome, JdbcProductItemManagerImpl

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.
java.lang.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, java.lang.String[] keywords) Sets the keywords for a given product item.
void	updateItem(CatalogRequest request, ProductItem product) Updates a product item.

Methods inherited from interface com.beasys.commerce.ebusiness.catalog.service.CatalogService

getCatalogManager

Methods inherited from interface javax.ejb.EJBObject

getEJBHome, getHandle, getPrimaryKey, isIdentical, remove

Method Detail

getItemCount

public int getItemCount(CatalogRequest request)
                 throws java.rmi.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.

getItem

public ProductItem getItem(CatalogRequest request,
                           ProductItemKey productKey)
                    throws java.rmi.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.

getItems

public ProductItem[] getItems(CatalogRequest request,
                              ProductItemKey[] productKeys)
                       throws java.rmi.RemoteException,
                              CatalogFinderException,
                              CatalogException

Returns the product items with the given product item keys.

Parameters:

request - The catalog request object.

keys - The keys of the target product items.

Throws:

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

CatalogException - on general error.

getItemKeys

public ProductItemKey[] getItemKeys(CatalogRequest request,
                                    int beginIndex,
                                    int endIndex)
                             throws java.rmi.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.

getItems

public ViewIterator getItems(CatalogRequest request,
                             int viewSize)
                      throws java.rmi.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.

getKeywords

public java.lang.String[] getKeywords(CatalogRequest request,
                                      ProductItemKey productKey)
                               throws java.rmi.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.

setKeywords

public void setKeywords(CatalogRequest request,
                        ProductItemKey productKey,
                        java.lang.String[] keywords)
                 throws java.rmi.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.

createItem

public void createItem(CatalogRequest request,
                       ProductItem product)
                throws java.rmi.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.

updateItem

public void updateItem(CatalogRequest request,
                       ProductItem product)
                throws java.rmi.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.

removeItem

public void removeItem(CatalogRequest request,
                       ProductItemKey productKey)
                throws java.rmi.RemoteException,
                       CatalogRemoveException,
                       CatalogFinderException,
                       CatalogException

Removes a product item.

Parameters:

request - The catalog request object.

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