WebLogic Server 6.0 Code Examples, BEA Systems, Inc.

examples.ejb20.homeMethods
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 by WebLogic, Inc. All Rights Reserved., Copyright (c) 1998-2000 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.
 java.lang.String homyMethod()
           
 
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

homyMethod

public java.lang.String homyMethod()
                            throws java.rmi.RemoteException

Documentation is available at
http://e-docs.bea.com/wls/docs60

Copyright © 2000 BEA Systems, Inc. All Rights Reserved.