com.tangosol.io.pof

Class ThrowablePofSerializer

java.lang.Object

com.tangosol.io.pof.ThrowablePofSerializer

All Implemented Interfaces:

PofSerializer

public class ThrowablePofSerializer
extends Object
implements PofSerializer

PofSerializer implementation that can serialize and deserialize a Throwable to/from a POF stream.

This serializer is provides a catch-all mechanism for serializing exceptions. Any deserialized exception will loose type information, and simply be represented as a PortableException. The basic detail information of the exception is retained.

PortableException and this class work asymmetrically to provide the serialization routines for exceptions.

Author:

mf 2008.08.25

Constructor Summary

Constructors

Constructor and Description
ThrowablePofSerializer() Default constructor.

Method Summary

Modifier and Type	Method and Description
Object	deserialize(PofReader in) Deserialize a user type instance from a POF stream by reading its state using the specified PofReader object.
void	serialize(PofWriter out, Object o) Serialize a user type instance to a POF stream by writing its state using the specified PofWriter object.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ThrowablePofSerializer

public ThrowablePofSerializer()

Default constructor.

Method Detail

serialize

public void serialize(PofWriter out,
                      Object o)
               throws IOException

Serialize a user type instance to a POF stream by writing its state using the specified PofWriter object.

An implementation of PofSerializer is required to follow the following steps in sequence for writing out an object of a user type:

1. If the object is evolvable, the implementation must set the version by calling PofWriter.setVersionId(int).
2. The implementation may write any combination of the properties of the user type by using the "write" methods of the PofWriter, but it must do so in the order of the property indexes.
3. After all desired properties of the user type have been written, the implementation must terminate the writing of the user type by calling PofWriter.writeRemainder(com.tangosol.util.Binary).

Specified by:

serialize in interface PofSerializer

Parameters:

out - the PofWriter with which to write the object's state

o - the object to serialize

Throws:

IOException - if an I/O error occurs

deserialize

public Object deserialize(PofReader in)
                   throws IOException

Deserialize a user type instance from a POF stream by reading its state using the specified PofReader object.

An implementation of PofSerializer is required to follow the following steps in sequence for reading in an object of a user type:

1. If the object is evolvable, the implementation must get the version by calling PofReader.getVersionId().
2. The implementation may read any combination of the properties of the user type by using "read" methods of the PofReader, but it must do so in the order of the property indexes. Additionally, the implementation must call PofReader.registerIdentity(java.lang.Object) with the new instance prior to reading any properties which are user type instances themselves.
3. After all desired properties of the user type have been read, the implementation must terminate the reading of the user type by calling PofReader.readRemainder().

Specified by:

deserialize in interface PofSerializer

Parameters:

in - the PofReader with which to read the object's state

Returns:

the deserialized user type instance

Throws:

IOException - if an I/O error occurs