Java Enterprise in a Nutshell, Second Edition

Name

EJBHome

Synopsis

The EJBHome interface is the base interface for all home interfaces for enterprise JavaBeans. If you develop an enterprise JavaBean, you have to provide a home interface for it that extends this interface. The home interface allows clients to create beans of the corresponding type, and to find them, if it is an entity bean. When you extend the EJBHome interface to create a home interface for your EJB object type, you must specify any create or finder methods for the bean that you intend to provide for the client. The EJBHome interface provides two remove() methods that let a client remove its reference to a bean from the container, and a getEJBMetaData() method, which returns an EJBMetaData instance for the EJB object’s type.

                  
public interface EJBHome extends java.rmi.Remote {
// Public Instance Methods
   public abstract EJBMetaData getEJBMetaData(
        ) throws java.rmi.RemoteException;  
   public abstract HomeHandle getHomeHandle(                     // 1.1
        ) throws java.rmi.RemoteException;  
   public abstract void remove(
        Handle handle) throws java.rmi.RemoteExceptionRemoveException;  
   public abstract void remove(
        Object primaryKey) throws java.rmi.RemoteExceptionRemoveException;  
}

Passed To

javax.ejb.spi.HandleDelegate.writeEJBHome()

Returned By

EJBContext.getEJBHome(), EJBMetaData.getEJBHome(), EJBObject.getEJBHome(), HomeHandle.getEJBHome(), javax.ejb.spi.HandleDelegate.readEJBHome()