examples.jta.oracle
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, which in WebLogic is implemented by the code-generated container class AccountBeanC. 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".
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:

CheckingAccountBean, SavingAccountBean

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:

CheckingAccountBean, SavingAccountBean