trader.java

来自「weblogic应用全实例」· Java 代码 · 共 52 行

//定义本接口在包examples.ejb20.basic.statefulSession中
package examples.ejb20.basic.statefulSession;
//本类用到的其他类
import javax.ejb.*;
import java.rmi.RemoteException;

/**
 * 这是TradeBean的远程接口定义。远程接口中定义了客户端能远程调用EJBean的方法。这些方法除了
 * 要抛出异常java.rmi.RemoteException之外，和EJBean中的定义是一致的。但并不是EJBean来实
 * 现这个接口，而是由容器自动产生的类TraderBeanE实现的。
 */
//这个接口必须继承javax.ejb.EJBObject接口
public interface Trader extends EJBObject {

  /**
   * 远程方法：购买指定用户和股票类别、数量的股票。
   *
   * @参数 customerName  顾客名
   * @参数 stockSymbol   股票代码
   * @参数 shares        购买股票的数量
   * @返回               TradeResult 交易结果对象
   * @异常               ProcessingErrorException
   *                          购买操作出错时抛出的异常
   * @异常		RemoteException 当系统通讯发生故障时抛出
   */
  public  TradeResult buy(String customerName, String stockSymbol, int shares)
    throws ProcessingErrorException, RemoteException;

  /**
   * 远程方法：出售指定用户和股票类别、数量的股票。
   *
   * @参数 customerName  顾客名
   * @参数 stockSymbol   股票代码
   * @参数 shares        出售股票的数量
   * @返回               TradeResult Trade Result
   * @异常               ProcessingErrorException
   *                          购买操作出错时抛出的异常
   * @异常		RemoteException 当系统通讯发生故障时抛出
   */
  public TradeResult sell(String customerName, String stockSymbol, int shares)
    throws ProcessingErrorException, RemoteException;

  /**
   * 远程方法：返回本次交易的结算
   *
   * @返回                  double 结算值
   * @异常		RemoteException 当系统通讯发生故障时抛出   */
  public double getBalance() 
    throws RemoteException;

}