public interface HandleDelegate
HandleDelegate interface is implemented by the enterprise bean container. It is used by portable
implementations of jakarta.ejb.Handle and jakarta.ejb.HomeHandle. It is not used by
enterprise bean 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.