profilemanagement.java

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

/*
 * @author                        : Sujatha
 * @Version                       : 1.0
 *
 * Development Environment        : Oracle9i JDeveloper
 * Name of the File               : ProfileManagement.java
 * Creation/Modification History  :
 *
 * Sujatha    10-Dec-2002      Created
 *
 */
package oracle.otnsamples.vsm.services;

import java.rmi.RemoteException;

import javax.ejb.EJBObject;

import oracle.otnsamples.vsm.services.data.Profile;
import oracle.otnsamples.vsm.services.data.Shop;


/**
 * This is the interface for User Profile management Service. The interface
 * provides method signatures for Profile management Services like user
 * registration, updation of profile information, request for a new shop in
 * the mall etc.
 */
public interface ProfileManagement extends EJBObject {
  /**
   * This business method registers a new mall user
   *
   * @param <b>profile</b>  Information about the user to be registered
   *
   * @throws <b>ProfileException</b> if the user cannot be registered
   * @throws <b>RemoteException</b> container error
   */
  void register(Profile profile) throws ProfileException, 
                                        RemoteException;
  /**
   * This business method retrieves the profile information of a given user
   *
   * @param <b>userName</b>  Username for which the profile information needs
   *        to  be retrieved
   *
   * @return <b>Profile</b>  the profile information of the user
   *
   * @throws <b>ProfileException</b> if the profile cannot be retrieved
   * @throws <b>RemoteException</b> container error
   */
  Profile getProfile(String userName) throws ProfileException, 
                                             RemoteException;
  /**
   * This business method updates the profile information of a user
   *
   * @param <b>profile</b> - New information about the user whose profile has
   *        to to updated
   *
   * @throws <b>ProfileException</b> if the profile information cannot be
   *         updated
   * @throws <b>RemoteException</b> container error
   */
  void updateProfile(Profile profile) throws ProfileException, 
                                             RemoteException;
  /**
   * This business method emails the password for a specified user.  This
   * method  is invoked when the user clicks on "Forgot Password" link.
   *
   * @param <b>userName</b> - userName of the user whose password has to be
   *        notified
   * @param <b>langID</b> - Languague used by the user
   *
   * @throws <b>ProfileException</b> if the user cannot be notified
   * @throws <b>RemoteException</b> container error
   */
  void notifyPassword(String userName, String langID)
               throws ProfileException, 
                      RemoteException;
  /**
   * This business method processes user requests for a shop in the Mall
   *
   * @param <b>shop</b> - Information about the shop that the user wishes to
   *        set up in the mall
   *
   * @throws <b>ShopException</b> if the shop cannot be created
   * @throws <b>RemoteException</b> container error
   */
  void requestShop(Shop shop) throws ShopException, 
                                     RemoteException;
  /**
   * This business method processes the information given by user during login
   *
   * @param <b>userName</b> - login id specified by the user
   * @param <b>password</b> - password specified by the user
   *
   * @return <b>Profile</b> - the profile information of the user
   *
   * @throws <b>ProfileException</b> if the shop cannot be created
   * @throws <b>RemoteException</b> container error
   */
  Profile validateUser(String userName, String password)
                throws ProfileException, 
                       RemoteException;
  /**
   * This business method changes the password for the user
   *
   * @param <b>userName</b> - username specified by the user during login
   * @param <b>password</b> - Old password value
   * @param <b>newPassword</b> - New password value
   * @param <b>newPasswordConfirm</b> - Confirmation of the new password
   *
   * @throws <b>ProfileException</b> if the password cannot be updated
   * @throws <b>RemoteException</b> container error
   */
  void changePassword(
                      String userName, String password, String newPassword,
                      String newPasswordConfirm)
               throws ProfileException, 
                      RemoteException;
  /**
   * This business method retrieves country information
   *
   * @return <b>TreeMap</b> - Ordered list of countries information
   *
   * @throws <b>ProfileException</b> if the countries could not be retrieved
   * @throws <b>RemoteException</b> container error
   */
  java.util.TreeMap getCountriesList() throws ProfileException, 
                                              RemoteException;
}