samples.j2ee.ejb.sequence.oracle
Interface OracleHome

public interface OracleHome

extends javax.ejb.EJBHome

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.

Method Summary

Oracle	create(double initialSalary) This method corresponds to the ejbCreate method in the bean "OracleBean.java".
Oracle	create(java.lang.Integer accountID, double initialSalary) This method corresponds to the ejbCreate method in the bean "OracleBean.java".
Oracle	findAccount(double salaryEqual) Finds an EJBean with a salary equal to a given amount.
Oracle	findByPrimaryKey(OraclePK primaryKey) Given a Primary Key, refreshes the EJBean from the persistent storage.

Methods inherited from interface javax.ejb.EJBHome

getEJBMetaData, getHomeHandle, remove, remove

Method Detail

create

public Oracle create(double initialSalary)
              throws javax.ejb.CreateException,
                     java.rmi.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 OracleHome.create(), the container (which in WebLogic EJB is also the factory) allocates an instance of the bean and calls OracleBean.ejbCreate() For container-managed persistence, ejbCreate() returns a void, unlike the case of bean-managed persistence, where it returns a primary key.

Parameters:

initialSalary - double Initial Salary

Returns:

Oracle

Throws:

javax.ejb.CreateException - if there is an error creating the bean

java.rmi.RemoteException - if there is a communications or systems failure

See Also:

OracleBean

create

public Oracle create(java.lang.Integer accountID,
                     double initialSalary)
              throws javax.ejb.CreateException,
                     java.rmi.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 OracleHome.create(), the container (which in WebLogic EJB is also the factory) allocates an instance of the bean and calls OracleBean.ejbCreate() For container-managed persistence, ejbCreate() returns a void, unlike the case of bean-managed persistence, where it returns a primary key.

Parameters:

accountID - Integer Account ID

initialSalary - double Initial Salary

Returns:

Oracle

Throws:

javax.ejb.CreateException - if there is an error creating the bean

java.rmi.RemoteException - if there is a communications or systems failure

See Also:

OracleBean

findByPrimaryKey

public Oracle findByPrimaryKey(OraclePK primaryKey)
                        throws javax.ejb.FinderException,
                               java.rmi.RemoteException

Given a Primary Key, refreshes the EJBean from the persistent storage.

Parameters:

primaryKey - AccountPK Primary Key

Returns:

Account

Throws:

javax.ejb.FinderException - if there is an error finding the bean

java.rmi.RemoteException - if there is a communications or systems failure

See Also:

OracleBean

findAccount

public Oracle findAccount(double salaryEqual)
                   throws javax.ejb.FinderException,
                          java.rmi.RemoteException

Finds an EJBean with a salary equal to a given amount. Returns a single EJBean Account.

Parameters:

salaryEqual - double Test amount

Returns:

Account

Throws:

javax.ejb.FinderException - if an error occurs while accessing the persistent storage

java.rmi.RemoteException - if there is a communications or systems failure

See Also:

OracleBean