WebLogic Server 6.1 Code Examples, BEA Systems, Inc.

examples.iiop.ejb.entity.server.wls
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-2001 by BEA Systems, Inc. All Rights Reserved.

Method Summary
 Account create(java.lang.String accountId, double initialBalance, java.lang.String type)
          This method corresponds to the ejbCreate method in the bean "AccountBean.java".
 Account findAccount(double balanceEqual)
          Finds an EJBean with a balance equal to a given amount.
 java.util.Collection findAllAccounts()
          Finds all EJBeans.
 java.util.Enumeration findBigAccounts(double balanceGreaterThan)
          Finds all EJBeans with a balance greater than a given amount.
 Account findByPrimaryKey(java.lang.String primaryKey)
          Given a Primary Key, refreshes the EJBean from the persistent storage.
 java.util.Enumeration findNullAccounts()
          Finds all EJBeans with a type of 'null'.
 
Methods inherited from interface javax.ejb.EJBHome
getEJBMetaData, getHomeHandle, remove, remove
 

Method Detail

create

public Account create(java.lang.String accountId,
                      double initialBalance,
                      java.lang.String type)
               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 null, unlike the case of bean-managed persistence, where it returns a primary key. See section 9.4.2
Parameters:
accountID - String Account ID
initialBalance - double Initial balance
type - String Account type
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

findAccount

public Account findAccount(double balanceEqual)
                    throws javax.ejb.FinderException,
                           java.rmi.RemoteException
Finds an EJBean with a balance equal to a given amount. Returns a single EJBean Account.
Parameters:
balanceEqual - 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:
AccountBean

findAllAccounts

public java.util.Collection findAllAccounts()
                                     throws javax.ejb.FinderException,
                                            java.rmi.RemoteException
Finds all EJBeans. Returns a Collection of found EJBean Accounts.
Returns:
Collection of 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:
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 Accounts.
Parameters:
balanceGreaterThan - double Test Amount
Returns:
Enumeration of 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:
AccountBean

findByPrimaryKey

public Account findByPrimaryKey(java.lang.String primaryKey)
                         throws javax.ejb.FinderException,
                                javax.ejb.ObjectNotFoundException,
                                java.rmi.RemoteException
Given a Primary Key, refreshes the EJBean from the persistent storage.
Parameters:
primaryKey - 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

findNullAccounts

public java.util.Enumeration findNullAccounts()
                                       throws javax.ejb.FinderException,
                                              java.rmi.RemoteException
Finds all EJBeans with a type of 'null'.
Returns:
Enumeration of 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:
AccountBean

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

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