administration.java

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

/*
 * @author                        : Neelesh
 * @Version                       : 1.0
 *
 * Development Environment        : Oracle9i JDeveloper
 * Name of the File               : Administration.java
 * Creation/Modification History  :
 *
 * Neelesh    26-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.Guestbook;
import oracle.otnsamples.vsm.services.data.Shop;


/**
 * The remote interface exposes methods that represent the functionality of
 * VSM administrator
 */
public interface Administration extends EJBObject {
  /**
   * This is a business method, to find a category by its id
   *
   * @param <b>catID</b> category id
   * @param <b>langID</b> language id
   *
   * @return <b>Category</b> - Category object
   *
   * @throws <b>CategoryException</b> If the category with the id is not valid
   */
  Category findCategory(String catID, String langID)
                 throws CategoryException, 
                        RemoteException;
  /**
   * This is a business method, to modify a category in VSM.
   *
   * @param <b>cat</b> - Category object which contains updated details.
   *
   * @throws <b>CategoryException</b> If the new category could not be updated
   */
  void updateCategory(Category cat) throws CategoryException, 
                                           RemoteException;
  /**
   * This is a business method, to add a new category to the VSM.
   *
   * @param <b>cat</b> - Category object which contains details of the new
   *        category
   *
   * @return <b>String</b> - Id for the category added
   *
   * @throws <b>CategoryException</b> If the new category could not be added
   */
  String addCategory(Category cat) throws RemoteException, 
                                          CategoryException;
  /**
   * This is a business method, to update status of pending shop requests,
   * categorised by language.
   *
   * @param <b>shopIDs</b> - A long array of shop ids whose status has changed
   * @param <b>status</b> - A string array of new shop status, corresponds to
   *        shopIDs
   * @param <b>langID</b> - Indicates the preferred language of the shop owner.
   *        status array should be a series of Ps,Rs or As, indicating  a
   *        Pending request, a Rejected request and an Approved request
   *
   * @throws <b>ShopException</b> If shop status could not be modified
   */
  void manageShopRequests(String[] shopIDs, String[] status, String langID)
                   throws ShopException, 
                          RemoteException;
  /**
   * This is a business method, to modify a category in VSM.
   *
   * @param <b>cat</b> - Category object which contains updated details.
   *
   * @return <b>Guestbook[]</b> guestbook entries
   *
   * @throws <b>CategoryException</b> If the new category could not be updated
   */
  Guestbook[] viewGuestbookEntries(String langID)
                            throws GuestbookException, 
                                   RemoteException;
  /**
   * This is a business method, to remove an entry from the guestbook
   *
   * @param <b>guestbookID</b> - Id of the guestbook entry
   *
   * @throws <b>GuestbookException</b> If entries cannot be removed
   */
  void deleteGuestbookEntries(String guestbookID)
                       throws GuestbookException, 
                              RemoteException;
  /**
   * This is a business method, to retrieve all pending shop requests
   *
   * @return <b>Shop[]</b> - An array of Shop objects which are yet to be
   *         approved. returns null if there are no such shops
   *
   * @throws <b>ShopException</b> If shops cannot be retrieved
   */
  Shop[] getPendingRequests(String langID)
                     throws ShopException, 
                            RemoteException;
  /**
   * This is a business method, to get all categories in VSM
   *
   * @return <b>Category[]</b> - An array of Category objects.
   *
   * @throws <b>CategoryException</b> If the categories could not be retrieved
   */
  Category[] getAllCategories(String langID)
                       throws CategoryException, 
                              RemoteException;
}