EJBHome

All Superinterfaces:

java.rmi.Remote
```
public interface EJBHome
extends java.rmi.Remote
```
The EJBHome interface must be extended by all enterprise beans' remote home interfaces. An enterprise bean's remote home interface defines the methods that allow a remote client to create, find, and remove enterprise bean objects.
The remote home interface is defined by the enterprise bean provider and implemented by the enterprise bean container.
Enterprise beans written to the EJB 3.0 and later APIs do not require a home interface.

Since:

EJB 1.0

Examples (en):

component-interfaces

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`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 enterprise bean object identified by its handle.
`void`	`remove(java.lang.Object primaryKey)` Remove an enterprise bean object identified by its primary key.

- Method Detail
  - remove
```
void remove(Handle handle)
     throws java.rmi.RemoteException,
            RemoveException
```
    Remove an enterprise bean object identified by its handle.
    
    Parameters:
    
    handle - the handle of the enterprise bean object to be removed
    
    Throws:
    
    RemoveException - Thrown if the enterprise bean or the container does not allow the client to remove the object.
    
    java.rmi.RemoteException - Thrown when the method failed due to a system-level failure.
  - remove
```
void remove(java.lang.Object primaryKey)
     throws java.rmi.RemoteException,
            RemoveException
```
    Remove an enterprise bean object identified by its primary key.
    This method can be used only for an entity bean. An attempt to call this method on a session bean will result in a RemoveException.
    Note: Support for entity beans is optional as of EJB 3.2.
    
    Parameters:
    
    primaryKey - the primary key of the enterprise bean object to be removed
    
    Throws:
    
    RemoveException - Thrown if the enterprise bean or the container does not allow the client to remove the object.
    
    java.rmi.RemoteException - Thrown when the method failed due to a system-level failure.
  - 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.
    
    Since:
    
    EJB 1.1

Interface EJBHome

Method Summary

Method Detail

remove

remove

getEJBMetaData

getHomeHandle