accounthome.java

weblogic应用全实例

//定义本接口在包examples.ejb.basic.beanManaged 中
package examples.ejb.basic.beanManaged;
//本类用到的其他类。javax.ejb.*是开发EJB应用需要的类库。javax.naming.*是实现JNDI服务需要的类库。
import javax.ejb.CreateException;
import javax.ejb.EJBHome;
import javax.ejb.FinderException;
import java.rmi.RemoteException;
import java.util.Enumeration;


/**
 * 这是AccontBean的主接口定义，这个接口是被EJB容器产生的类AccontBeanC实现的。
 * 在这里只需定义EJB创建的方法，这些方法要和EJBean中的"ejbCreate"方法对应。
 */
 //EJBean主接口必须继承javax.ejb.EJBHome接口
public interface AccountHome extends EJBHome {

    /**
   * 这个方法和"AccountBean.java"中定义的的Bean的"ejbCreate"方法相对应
   * 这两个方法的参数应该相同。当客户端调用"TraderHome.create()"方法时,EJB容器
   * 会找到EJBean的实例，并调用它的"ejbCreate()"方法。
   * @参数 accountID         String 账号ID
   * @参数 initialBalance    double 初始化结算值
   * @返回                  Account 远程对象
   * @异常               javax.ejb.CreateException
   *                          创建bean错误时抛出的异常
   * @异常		RemoteException 当系统通讯发生故障时抛出
   * @参看                     examples.ejb.basic.beanManaged.AccountBean
   */
  public Account create(String accountId, double initialBalance) 
    throws CreateException, RemoteException;

  /**
   * 根据主键对象，返回账号对象
   *
   * @参数 primaryKey        主键
   * @返回                  Account 账号
   * @异常                javax.ejb.FinderException
   *                           访问数据库错误抛出的异常
   * @异常		RemoteException 当系统通讯发生故障时抛出
   * @参看                     examples.ejb.basic.beanManaged.AccountBean
   */
  public Account findByPrimaryKey(String primaryKey) 
    throws FinderException, RemoteException;

  /**
   * 找到所有结算值大于balanceGreaterThan的账号
   *
   * @返回                   Enumeration 所有账号枚举
   * @参数                 double balanceGreaterThan,给定的结算值
   * @异常                javax.ejb.FinderException
   *                           访问数据库错误抛出的异常
   * @异常		RemoteException 当系统通讯发生故障时抛出
   * @参看                      examples.ejb.basic.beanManaged.AccountBean
   */
  public Enumeration findBigAccounts(double balanceGreaterThan)
    throws FinderException, RemoteException;
}