cardholderaccesslocal.java

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

package com.ebusiness.ebank.ejb.sessionbean;

/**
 * <p>Title: </p>
 * <p>Description: Local interface for accessing personal information data. All of the web
 *                 components within eBank application can call this local interface.
 *                 It has better performance than remote interface does</p>
 * <p>Copyright: Copyright (c) 2005</p>
 * <p>Company: eBusiness Inc., All right reserved</p>
 * @author unascribed
 * @version 1.0
 */

import java.util.List;
import javax.ejb.EJBLocalObject;
import javax.ejb.EJBException;

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

public interface CardholderAccessLocal
    extends EJBLocalObject {
  /**
 * @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 EJBException,
    SystemException, BusinessException;

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

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

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

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

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

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

/**
 * @Description:    View cardholder data
 * @return:         CardholderValue
 */
public CardholderValue viewCardholder(ClientCardValue value) throws
    EJBException, 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
    EJBException, SystemException, BusinessException;

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

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

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

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

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

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

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

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

//public ValueList search(Criteria criteria) throws EJBException,
    //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
 //   EJBException, 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 EJBException,
   // SystemException, BusinessException;

}