package examples.ejb.sequence.jdbc;
import javax.ejb.*;
import java.rmi.RemoteException;
import java.util.*;
/**
* This interface is the home interface for the EJBean AutoAccountBean,
* which in WebLogic is implemented by the code-generated container class
* AutoAccountBeanC. 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 AutoAccountHome extends EJBHome {
/**
* This method corresponds to the ejbCreate method in the bean
* "AutoAccountBean.java".
* The parameter sets of the two methods are identical. When the client calls
* AutoAccountHome.create()
, the container (which in WebLogic EJB is
* also the factory) allocates an instance of the bean and
* calls AutoAccountBean.ejbCreate()
*
* For container-managed persistence, ejbCreate()
* returns a void, unlike the case of bean-managed
* persistence, where it returns a primary key.
*
* @param initialBalance double Initial Balance
* @return AutoAccount
* @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.jdbc.AutoAccountBean
*/
public AutoAccount create(double initialBalance)
throws CreateException, RemoteException;
/**
* This method corresponds to the ejbCreate method in the bean
* "AutoAccountBean.java".
* The parameter sets of the two methods are identical. When the client calls
* AutoAccountHome.create()
, the container (which in WebLogic EJB is
* also the factory) allocates an instance of the bean and
* calls AutoAccountBean.ejbCreate()
*
* For container-managed persistence, ejbCreate()
* returns a void, unlike the case of bean-managed
* persistence, where it returns a primary key.
*
* @param accountID String Account ID
* @param initialBalance double Initial Balance
* @return AutoAccount
* @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.jdbc.AutoAccountBean
*/
public AutoAccount create(String accountID, double initialBalance)
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.jdbc.AutoAccountBean
*/
public AutoAccount findByPrimaryKey(AutoAccountPK primaryKey)
throws FinderException, RemoteException;
/**
* Finds an EJBean with a balance equal to a given amount.
* Returns a single EJBean Account.
*
* @param balanceEqual 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.jdbc.AutoAccountBean
*/
public AutoAccount findAccount(double balanceEqual)
throws FinderException, RemoteException;
}