mallnavigation.java

噶额外噶外骨骼感广泛高热感 就 啊啊

/*
 * @author                        : Neelesh
 * @Version                       : 1.0
 *
 * Development Environment        : Oracle 9i JDeveloper
 * Name of the File               : MallNavigation.java
 * Creation/Modification History  :
 *
 * Neelesh    30-Dec-2002      Created
 *
 */
package oracle.otnsamples.vsm.services;

import java.rmi.RemoteException;

import javax.ejb.EJBObject;

import oracle.otnsamples.vsm.services.data.Category;
import oracle.otnsamples.vsm.services.data.Country;
import oracle.otnsamples.vsm.services.data.Guestbook;
import oracle.otnsamples.vsm.services.data.Item;
import oracle.otnsamples.vsm.services.data.Shop;
import oracle.otnsamples.vsm.services.data.SubCategory;


/**
 * The service bean interface provides remote methods related to mall
 * navigation functionality.There are methods to get shop details,  item
 * details ,subcategories and to search items
 */
public interface MallNavigation extends EJBObject {
  /**
   * The service method returns an array of shops in a given category, with the
   * details of the shops in the given language
   *
   * @param <b>catID</b> The category id
   * @param <b>langID</b> The language in which details should be retrieved
   *
   * @return <b>Shop[]</b> an array of Shop value objects
   *
   * @throws ShopException if there was a problem finding shops
   */
  Shop[] findShopsInCategory(String catID, String langID)
                      throws ShopException, 
                             RemoteException;
  /**
   * The service method returns an array of items in a given category, with the
   * details of the items in the given language
   *
   * @param <b>catID</b> The category id
   * @param <b>langID</b> The language in which details should be retrieved
   *
   * @return <b>Item[]</b> an array of Item value objects
   *
   * @throws ItemException if there was a problem finding items
   */
  Item[] findItemsInSubCategory(String subCatID, String langID)
                         throws ItemException, 
                                RemoteException;
  /**
   * The service method returns an array of subcategories in a given shop,
   * with the  details of the subcategories in the given language
   *
   * @param <b>catID</b> The category id
   * @param <b>langID</b> The language in which details should be retrieved
   *
   * @return <b>SubCategory[]</b> an array of SubCategory value objects
   *
   * @throws CategoryException if there was a problem finding sub categories
   */
  SubCategory[] findSubCategoriesInShop(String shopID, String langID)
                                 throws CategoryException, 
                                        RemoteException;
  /**
   * The service method returns an array of items matching the keyword with the
   * details of the items in the given language
   *
   * @param <b>keword</b> The keyword
   * @param <b>String</b> The language in which details should be retrieved
   *
   * @return <b>Item[]</b> an array of Item value objects
   *
   * @throws ItemException if there was a problem finding items
   */
  Item[] searchItem(String keyword, String langID)
             throws RemoteException, 
                    ItemException;
  /**
   * The service method returns an array of top items in a given shop, with the
   * details of the items in the given language
   *
   * @param <b>catID</b> The category id
   * @param <b>langID</b> The language in which details should be retrieved
   *
   * @return <b>Item[]</b> an array of Item value objects
   *
   * @throws ItemException if there was a problem finding items
   */
  Item[] getTopItemsInShop(String shopID, String langID)
                    throws ItemException, 
                           RemoteException;
  /**
   * The service method returns an array of all categories,in the given
   * language
   *
   * @param <b>langID</b> The language in which details should be retrieved
   *
   * @return <b>Category[]</b> an array of Category value objects
   *
   * @throws CategoryException if there was a problem finding categories
   */
  Category[] getAllCategories(String langID)
                       throws CategoryException, 
                              RemoteException;
  /**
   * The service method returns an array of shops in a given category, with the
   * details of the shops in the given language
   *
   * @param <b>shopID</b> The shop id
   * @param <b>langID</b> The language in which details should be retrieved
   *
   * @return <b>Shop[]</b> a Shop value object
   *
   * @throws ShopException if there was a problem finding shop
   */
  public Shop getShop(String shopID, String langID)
               throws ShopException, 
                      RemoteException;
  /**
   * The service method returns a category for a given id,in the given language
   *
   * @param <b>langID</b> The language in which details should be retrieved
   *
   * @return <b>Category</b> a Category value object
   *
   * @throws CategoryException if there was a problem finding category
   */
  Category getCategory(String catID, String langID)
                throws CategoryException, 
                       RemoteException;
  /**
   * The service method returns an array of Country objects
   *
   * @return <b>Country[]</b> An array of Country objects
   *
   * @throws ServiceException if there was a problem finding category
   */
  Country[] getCountries() throws RemoteException, 
                                  ServiceException;
  /**
   * The service method adds an entry in to the Guestbook entity
   *
   * @param <b>guestbook</b> A Guestbook value object
   *
   * @throws GuestbookException if there was a problem adding a guestbook entry
   */
  void addGuestbookEntry(Guestbook guestbook)
                  throws GuestbookException, 
                         RemoteException;
}