examples.cluster.ejb.account
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) 1999-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(AccountPK 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 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 container-managed persistence, ejbCreate() returns a void, unlike the case of bean-managed persistence, where it returns a primary key.

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

findByPrimaryKey

public Account findByPrimaryKey(AccountPK 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:

AccountBean