|CONTENTS | PREV | NEXT||Java Object Serialization Specification|
For Serializable and Externalizable classes, the
readResolvemethod allows a class to replace/resolve the object read from the stream before it is returned to the caller. By implementing the
readResolvemethod, a class can directly control the types and instances of its own instances being deserialized. The method is defined as follows:
ANY-ACCESS-MODIFIER Object readResolve() throws ObjectStreamException;The
readResolvemethod is called when
ObjectInputStreamhas read an object from the stream and is preparing to return it to the caller.
ObjectInputStreamchecks whether the class of the object defines the
readResolvemethod. If the method is defined, the
readResolvemethod is called to allow the object in the stream to designate the object to be returned. The object returned should be of a type that is compatible with all uses. If it is not compatible, a
ClassCastExceptionwill be thrown when the type mismatch is discovered.
For example, a
Symbolclass could be created for which only a single instance of each symbol binding existed within a virtual machine. The
method would be implemented to determine if that symbol was already defined and substitute the preexisting equivalent
Symbolobject to maintain the identity constraint. In this way the uniqueness of
Symbolobjects can be maintained across serialization.