examples.ejb11.basic.beanManaged
Interface AccountHome

All Superinterfaces:

javax.ejb.EJBHome, java.rmi.Remote

public interface AccountHome

extends javax.ejb.EJBHome

This interface is the home interface for the EJBean AccountBean. A home interface may support one or more create methods, which must correspond to methods named "ejbCreate" in the EJBean.

Author:

Copyright (c) 1998-2002 by BEA Systems, Inc. All Rights Reserved.

Method Summary

Account	create(java.lang.String accountId, double initialBalance) This method corresponds to the ejbCreate method in the bean "AccountBean.java".
java.util.Enumeration	findBigAccounts(double balanceGreaterThan) Finds all EJBeans with a balance greater than a given amount.
Account	findByPrimaryKey(java.lang.String primaryKey) Attempts to find the EJBean with a given Primary Key from the persistent storage.

Methods inherited from interface javax.ejb.EJBHome

getEJBMetaData, getHomeHandle, remove, remove

Method Detail

create

public Account create(java.lang.String accountId,
                      double initialBalance)
               throws javax.ejb.CreateException,
                      java.rmi.RemoteException

This method corresponds to the ejbCreate method in the bean "AccountBean.java". The parameter sets of the two methods are identical. When the client calls AccountHome.create(), the container (which in WebLogic EJB is also the factory) allocates an instance of the bean and calls AccountBean.ejbCreate() For bean-managed persistence, create() returns a primary key, unlike the case of container-managed persistence, where it returns a void.

Parameters:

accountID - String Account ID

initialBalance - double Initial Balance

Returns:

Account

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:

AccountBean

findBigAccounts

public java.util.Enumeration findBigAccounts(double balanceGreaterThan)
                                      throws javax.ejb.FinderException,
                                             java.rmi.RemoteException

Finds all EJBeans with a balance greater than a given amount. Returns an Enumeration of found EJBean primary keys.

Parameters:

balanceGreaterThan - double Test Amount

Returns:

Enumeration of Account

Throws:

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

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

See Also:

AccountBean

findByPrimaryKey

public Account findByPrimaryKey(java.lang.String primaryKey)
                         throws javax.ejb.FinderException,
                                java.rmi.RemoteException

Attempts to find the EJBean with a given Primary Key from the persistent storage.

Parameters:

primaryKey - String 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:

AccountBean