javax.ejb
Interface EJBHome

All Superinterfaces:

java.rmi.Remote

public interface EJBHome
extends java.rmi.Remote

Used by EJB 2.1 for their business remote home interface.

Author:

Florent Benoit

See Also:

EJB 3.0 specification

Method Summary

EJBMetaData	getEJBMetaData() Obtain the EJBMetaData interface for the enterprise Bean.
HomeHandle	getHomeHandle() Obtain a handle for the remote home object.
void	remove(Handle handle) Remove an EJB object identified by its handle.
void	remove(java.lang.Object primaryKey) Remove an EJB object identified by its primary key.

Method Detail

remove

void remove(Handle handle)
            throws java.rmi.RemoteException,
                   RemoveException

Remove an EJB object identified by its handle.

Parameters:

handle - the given handle

Throws:

java.rmi.RemoteException - Thrown when the method failed due to a system-level failure.

RemoveException - Thrown if the enterprise Bean or the container does not allow the client to remove the object.

remove

void remove(java.lang.Object primaryKey)
            throws java.rmi.RemoteException,
                   RemoveException

Remove an EJB object identified by its primary key.

Parameters:

primaryKey - the given primary key;

Throws:

java.rmi.RemoteException - Thrown when the method failed due to a system-level failure.

RemoveException - Thrown if the enterprise Bean or the container does not allow the client to remove the object.

getEJBMetaData

EJBMetaData getEJBMetaData()
                           throws java.rmi.RemoteException

Obtain the EJBMetaData interface for the enterprise Bean. The EJBMetaData interface allows the client to obtain information about the enterprise Bean.
The information obtainable via the EJBMetaData interface is intended to be used by tools.

Returns:

The enterprise Bean's EJBMetaData interface.

Throws:

java.rmi.RemoteException - Thrown when the method failed due to a system-level failure.

getHomeHandle

HomeHandle getHomeHandle()
                         throws java.rmi.RemoteException

Obtain a handle for the remote home object. The handle can be used at later time to re-obtain a reference to the remote home object, possibly in a different Java Virtual Machine.

Returns:

A handle for the remote home object.

Throws:

java.rmi.RemoteException - Thrown when the method failed due to a system-level failure.