accounthome.java

weblogic应用全实例

//定义本接口在包examples.ejb.basic.containerManaged中
package examples.ejb.basic.containerManaged;
//本接口用到的其他类
//javax.ejb.*中定义了实现EJBean的接口。
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()"方法。
   * 对容器管理的ejb,ejbCreate方法返回为null，而bean管理的ejb，返回的是主键类。
   * @参数 accountID         String 账号ID
   * @参数 initialBalance    double 初始化结算值
   * @参数 type              String 账号类型
   * @返回                  Account 远程对象
   * @异常               javax.ejb.CreateException
   *                          创建bean错误时抛出的异常
   * @异常		RemoteException 当系统通讯发生故障时抛出
   * @参看                     examples.ejb.basic.containerManaged.AccountBean
   */
  public Account create(String accountId, double initialBalance, String type) 
    throws CreateException, RemoteException;

  /**
   * 根据主键对象，返回账号对象
   *
   * @参数 primaryKey        主键
   * @返回                  Account 账号
   * @异常                javax.ejb.FinderException
   *                           访问数据库错误抛出的异常
   * @异常		RemoteException 当系统通讯发生故障时抛出
   * @参看                     examples.ejb.basic.containerManaged.AccountBean
   */
  public Account findByPrimaryKey(String primaryKey) 
    throws FinderException, RemoteException;
       
  /**
   * 找到所有结算值等于balanceEqual的账号
   *
   * @返回                   Account 账号
   * @参数                 double balanceEqual,给定的结算值
   * @异常                javax.ejb.FinderException
   *                           访问数据库错误抛出的异常
   * @异常		RemoteException 当系统通讯发生故障时抛出
   * @参看                      examples.ejb.basic.containerManaged.AccountBean
   */
  public Account findAccount(double balanceEqual)
    throws FinderException, RemoteException;

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

  /**
   * 找到所有类型为'null'的EJBeans。
   *
   * @返回                   Enumeration 所有账号枚举
   * @异常                javax.ejb.FinderException
   *                           访问数据库错误抛出的异常
   * @异常		RemoteException 当系统通讯发生故障时抛出
   * @参看                      examples.ejb.basic.containerManaged.AccountBean
   */
  public Enumeration findNullAccounts()
    throws FinderException, RemoteException;

}