cardholderaccess.java

我在加拿大学习的一个比较复杂的在线银行程序.

package com.ebusiness.ebank.ejb.sessionbean;

/**
 * <p>Title: </p>
 * <p>Description: Remote interface for accessing cardholder personal information data. This interface
 *                  is for the call from outside the eBank application </p>
 * <p>Copyright: Copyright (c) 2005</p>
 * <p>Company: </p>
 * @author not attributable
 * @version 1.0
 */

import java.util.List;
import java.rmi.RemoteException;
import javax.ejb.EJBObject;

import com.ebusiness.ebank.bean.*;
import com.ebusiness.ebank.exception.BusinessException;
import com.ebusiness.ebank.exception.SystemException;

public interface CardholderAccess
    extends EJBObject {
  /**
   * @Description:    Insert a new cardhoder record and its associated addresses records
   *                  to ebank database. This method allows anyone ba able to register online
   * @param:          CardholderValue
   * @return:
   */
  public void register(CardholderValue value) throws RemoteException,
      SystemException, BusinessException;

  /**
   * @Description:    Change password for the cardholder's debit card
   * @return:
   */
  public ClientCardValue changePW(ClientCardValue value) throws RemoteException,
      SystemException, BusinessException;

  /**
   * @Description:    Reset password for the cardholder's web login
   * @return:
   */
  public ClientCardValue resetWebPW(ClientCardValue value) throws RemoteException,
      SystemException, BusinessException;

  public ClientCardValue viewClientCardByCardholderOID(long oid) throws
      RemoteException, SystemException, BusinessException;

    public ClientCardValue updateClientCard(ClientCardValue value) throws
      RemoteException, SystemException, BusinessException;

  /**
   * @Description:    Insert a new record for cardholder table
   * @param:          CardholderValue
   * @return:         CardholderValue
   */
   public ClientCardValue createClientCard(ClientCardValue value) throws
      RemoteException, SystemException, BusinessException;


  //This method if for bank stuff only
  public CardholderValue viewCardholderByOID(long oid) throws
      RemoteException, SystemException, BusinessException;

  /**
   * @Description:    View cardholder data
   * @return:         CardholderValue
   */
  public CardholderValue viewCardholder(ClientCardValue value) throws
      RemoteException, SystemException, BusinessException;

  /**
   * @Description:    Search a list of cardholders that satisfied with
   *                  the passed value in the specified cardholder value.
   *                  If there is a value in SIN, it will use it for the
   *                  search. Otherwise it will use the cardholder's names
   *                  and DOB etc. for the search
   * @return:         CardholderValue
   */
  public ValueList searchCardholder(CardholderValue value) throws
      RemoteException, SystemException, BusinessException;

  /**
   * @Description:    Update cardholder data
   * @param:          CardholderValue
   * @return:         CardholderValue
   */
  public CardholderValue updateCardholder(CardholderValue value) throws
      RemoteException, SystemException, BusinessException;

  /**
   * @Description:    Insert a new record for cardholder table
   * @param:          CardholderValue
   * @return:         CardholderValue
   */
  public CardholderValue createCardholder(CardholderValue value) throws
      RemoteException, SystemException, BusinessException;

  /**
   * @Description:    Approve the cardholder registered online. Used by Bank Clerk only
   * @param:          CardholderValue
   * @return:         CardholderValue
   */
  public CardholderValue approveCardholder(CardholderValue value) throws
      RemoteException, SystemException, BusinessException;

  /**
   * @Description:    Delete cardholder data. Used by Admin User only
   * @param:          CardholderValue
   * @return:
   */
  public void deleteCardholder(CardholderValue value) throws
      RemoteException, SystemException, BusinessException;

  /**
   * @Description:    View address data for the specified Object ID
   * @return:         AddressValue
   */
  public AddressValue viewAddressByOID(long oid) throws
      RemoteException, SystemException, BusinessException;

  /**
   * @Description:    Update Address data
   * @param:          AddressValue
   * @return:         AddressValue
   */
  public AddressValue updateAddress(AddressValue value) throws
      RemoteException, SystemException, BusinessException;

  /**
   * @Description:    Insert a new record for Address table
   * @param:          AddressValue
   * @return:         AddressValue
   */
  public AddressValue createAddress(AddressValue value) throws
      RemoteException, SystemException, BusinessException;

  /**
   * @Description:    Delete Address data. Used by Bank Clerk only
   * @param:          AddressValue
   * @return:
   */
  public void deleteAddress(AddressValue value) throws
      RemoteException, SystemException, BusinessException;

  //public ValueList search(Criteria criteria) throws RemoteException,
      //SystemException, BusinessException;

  /**
   * @Description:    Search record from eBank database based on the objectID and value type
   * @param:          long - objectID, String - value type
   * @return:         Value
   */
 // public Value getValueByOID(long objectID, String valueType) throws
      //RemoteException, SystemException, BusinessException;

  /**
   * @Description:    Search record from eBank database based on the specified value.
   *                  This method is used when the caller doesn't know the objectID yet
   * @param:          Value - this value contains at least values for the primary key fields
   *
   * @return:         Value if successful or null if unsuccessful
   */
 // public Value getValueByPrimaryKey(Value value) throws RemoteException,
      //SystemException, BusinessException;

}