public interface HandleDelegate
HandleDelegate
interface is implemented by the EJB container.
It is used by portable implementations of javax.ejb.Handle
and
javax.ejb.HomeHandle
.
It is not used by EJB components or by client components.
It provides methods to serialize and deserialize EJBObject and
EJBHome references to streams.
The HandleDelegate
object is obtained by JNDI lookup at the
reserved name "java:comp/HandleDelegate"
.
Modifier and Type | Method and Description |
---|---|
EJBHome |
readEJBHome(java.io.ObjectInputStream istream)
Deserialize the EJBHome reference corresponding to a HomeHandle.
|
EJBObject |
readEJBObject(java.io.ObjectInputStream istream)
Deserialize the EJBObject reference corresponding to a Handle.
|
void |
writeEJBHome(EJBHome ejbHome,
java.io.ObjectOutputStream ostream)
Serialize the EJBHome reference corresponding to a HomeHandle.
|
void |
writeEJBObject(EJBObject ejbObject,
java.io.ObjectOutputStream ostream)
Serialize the EJBObject reference corresponding to a Handle.
|
void writeEJBObject(EJBObject ejbObject, java.io.ObjectOutputStream ostream) throws java.io.IOException
This method is called from the writeObject
method of
portable Handle implementation classes. The ostream
object is the
same object that was passed in to the Handle class's writeObject
method.
ejbObject
- The EJBObject reference to be serialized.ostream
- The output stream.java.io.IOException
- The EJBObject could not be serialized
because of a system-level failure.EJBObject readEJBObject(java.io.ObjectInputStream istream) throws java.io.IOException, java.lang.ClassNotFoundException
The readEJBObject
method is called from the
readObject
method of portable Handle
implementation classes. The istream
object is the
same object that was passed in to the Handle class's
readObject
method. WhenreadEJBObject
is called,
istream
must point to the location in the stream at which the
EJBObject reference can be read. The container must ensure
that the EJBObject reference is capable of performing
invocations immediately after deserialization.
istream
- The input stream.java.io.IOException
- The EJBObject could not be deserialized
because of a system-level failure.java.lang.ClassNotFoundException
- The EJBObject could not be deserialized
because some class could not be found.void writeEJBHome(EJBHome ejbHome, java.io.ObjectOutputStream ostream) throws java.io.IOException
This method is called from the writeObject
method of
portable HomeHandle
implementation classes. The ostream
object is the same object that was passed in to the Handle
class's writeObject
method.
ejbHome
- The EJBHome reference to be serialized.ostream
- The output stream.java.io.IOException
- The EJBObject could not be serialized
because of a system-level failure.EJBHome readEJBHome(java.io.ObjectInputStream istream) throws java.io.IOException, java.lang.ClassNotFoundException
The readEJBHome
method is called from the
readObject
method of portable HomeHandle
implementation classes. The istream
object is the
same object that was passed in to the HomeHandle
class's
readObject
method. When readEJBHome
is called,
istream
must point to the location
in the stream at which the EJBHome reference can be read.
The container must ensure that the EJBHome reference is
capable of performing invocations immediately after deserialization.
istream
- The input stream.java.io.IOException
- The EJBHome could not be deserialized
because of a system-level failure.java.lang.ClassNotFoundException
- The EJBHome could not be deserialized
because some class could not be found.