com.opmath.test.j2ee.uid
Interface UniqueIdGeneratorHome

All Superinterfaces:

EJBHome, Remote

public interface UniqueIdGeneratorHome

extends EJBHome

The (remote) Home interface of the UniqueIdGenerator EJB. Specifies the functionality as avaliable to remote clients (and provided by the EJB container) with respect to creating and finding UniqueIdGenerator EJBs.

Copyright: (c) 2002 The Open Math Company Limited

The Terms of Distribution of this software are stipulated in the javadoc Overview for this project.

Since:

J2SDK 1.3.1, J2SDKEE 1.3.1, EJB 2.0

Version:

OpMath J2EE Example v1.0

Author:

Bruno Beloff bruno.beloff@opmath.com

See Also:

UniqueIdGeneratorBean

Method Summary

UniqueIdGenerator	create(UniqueIdGeneratorPK key) Requests that a new UniqueIdGenerator EJB is created with the given unqiue key.
Collection	findAll() Finds all the UniqueIdGenerator EJBs known to the container.
UniqueIdGenerator	findByPrimaryKey(UniqueIdGeneratorPK key) Finds the UniqueIdGenerator EJB with the given unqiue key.

Methods inherited from interface javax.ejb.EJBHome

getEJBMetaData, getHomeHandle, remove, remove

Method Detail

create

public UniqueIdGenerator create(UniqueIdGeneratorPK key)
                         throws RemoteException,
                                CreateException

Requests that a new UniqueIdGenerator EJB is created with the given unqiue key. The method returns (the remote interface of) the new EJB.

Parameters:

key - a UniqueIdGeneratorPK specifying the key.

Returns:

a UniqueIdGenerator remote interface to the new EJB.

Throws:

RemoteException - if problems were encountered in communicating with the application server.

CreateException - if the request not be completed, for whatever reason (for example, because a UniqueIdGenerator with the same key already exists).

See Also:

UniqueIdGeneratorBean.ejbCreate(UniqueIdGeneratorPK)

findByPrimaryKey

public UniqueIdGenerator findByPrimaryKey(UniqueIdGeneratorPK key)
                                   throws RemoteException,
                                          FinderException

Finds the UniqueIdGenerator EJB with the given unqiue key.

Parameters:

key - a UniqueIdGeneratorPK specifying the key.

Returns:

a UniqueIdGenerator remote interface to the found EJB.

Throws:

RemoteException - if problems were encountered in communicating with the application server.

FinderException - if the request not be completed, for whatever reason (for example, because no UniqueIdGenerator EJB exists for that key).

findAll

public Collection findAll()
                   throws RemoteException,
                          FinderException

Finds all the UniqueIdGenerator EJBs known to the container.

Returns:

a Collection carrying all the found EJBs.

Throws:

RemoteException - if problems were encountered in communicating with the application server.

FinderException - if the request not be completed, for whatever reason (for example, because no UniqueIdGenerator EJB exists).