package examples.ejb.sequence.oracle;

import javax.ejb.*;
import java.rmi.RemoteException;
import java.util.*;

/**
 * This interface is the home interface for the EJBean OracleBean,
 * which in WebLogic is implemented by the code-generated container class 
 * OracleBeanC. A home interface may support one or more create methods,
 * which must correspond to methods named "ejbCreate" in the EJBean.
 *
 * @author Copyright (c) 1998 by WebLogic, Inc. All Rights Reserved.
 * @author Copyright (c) 1998-1999 by BEA WebXpress. All Rights Reserved.
 */
public interface OracleHome extends EJBHome {

  /**
   * This method corresponds to the ejbCreate method in the bean
   * "OracleBean.java".
   * The parameter sets of the two methods are identical.  When the client calls
   * <code>OracleHome.create()</code>, the container (which in WebLogic EJB is
   * also the factory) allocates an instance of the bean and
   * calls <code>OracleBean.ejbCreate()</code>
   *
   * For container-managed persistence, <code>ejbCreate()</code>  
   * returns a void, unlike the case of bean-managed 
   * persistence, where it returns a primary key.
   *
   * @param initialSalary     double Initial Salary
   * @return                  Oracle
   * @exception               javax.ejb.CreateException
   *                          if there is an error creating the bean
   * @exception               java.rmi.RemoteException if there is
   *                          a communications or systems failure
   * @see                     examples.ejb.sequence.oracle.OracleBean
   */
  public Oracle create(double initialSalary) 
    throws CreateException, RemoteException;

  /**
   * This method corresponds to the ejbCreate method in the bean
   * "OracleBean.java".
   * The parameter sets of the two methods are identical.  When the client calls
   * <code>OracleHome.create()</code>, the container (which in WebLogic EJB is
   * also the factory) allocates an instance of the bean and
   * calls <code>OracleBean.ejbCreate()</code>
   *
   * For container-managed persistence, <code>ejbCreate()</code>  
   * returns a void, unlike the case of bean-managed 
   * persistence, where it returns a primary key.
   *
   * @param accountID         Integer Account ID
   * @param initialSalary     double Initial Salary
   * @return                  Oracle
   * @exception               javax.ejb.CreateException
   *                          if there is an error creating the bean
   * @exception               java.rmi.RemoteException if there is
   *                          a communications or systems failure
   * @see                     examples.ejb.sequence.oracle.OracleBean
   */
  public Oracle create(Integer accountID, double initialSalary) 
    throws CreateException, RemoteException;

  /**
   * Given a Primary Key, refreshes the EJBean from
   * the persistent storage.
   *
   * @param primaryKey        AccountPK Primary Key
   * @return                  Account
   * @exception               javax.ejb.FinderException
   *                          if there is an error finding the bean
   * @exception               java.rmi.RemoteException if there is
   *                          a communications or systems failure
   * @see                     examples.ejb.sequence.oracle.OracleBean
   */
  public Oracle findByPrimaryKey(OraclePK primaryKey) 
    throws FinderException, RemoteException;
       
  /**
   * Finds an EJBean with a salary equal to a given amount.
   * Returns a single EJBean Account.
   *
   * @param salaryEqual        double Test amount
   * @return                   Account
   * @exception                javax.ejb.FinderException
   *                           if an error occurs while accessing
   *                           the persistent storage
   * @exception                java.rmi.RemoteException if there is
   *                           a communications or systems failure
   * @see                      examples.ejb.sequence.oracle.OracleBean
   */
  public Oracle findAccount(double salaryEqual)
    throws FinderException, RemoteException;

}