Java Enterprise in a Nutshell, Second Edition

Name

Handle

Synopsis

A Handle represents a portable reference to a remote EJB object, in that it can be serialized, passed across Java VM boundaries, and then used to reconstitute a remote reference to the same EJB object from which it was acquired. You acquire a handle for an EJB object using the getHandle() method on its remote EJBObject.

The Handle interface acts as a base interface for EJB type-specific handle classes, which are typically generated for you by the container deployment tools. Its only method is getEJBObject(), which returns a remote reference to the EJB object that it represents.

                  
public interface Handle extends Serializable {
// Public Instance Methods
   public abstract EJBObject getEJBObject(
        ) throws java.rmi.RemoteException;  
}

Passed To

EJBHome.remove()

Returned By

EJBObject.getHandle()