org.jppf.utils
Interface ObjectSerializer

All Known Implementing Classes:

BootstrapObjectSerializer, GSObjectSerializer, ObjectSerializerImpl

public interface ObjectSerializer

Instances of this class are used to serialize or deserialize objects to or from an array of bytes.
A specific use of this class is that it can be loaded by a new classloader, making the execution transparent to any change in the client code.

Author:

Laurent Cohen

Method Summary

Object	deserialize(byte[] bytes) Read an object from an array of bytes.
Object	deserialize(byte[] bytes, int offset, int length) Read an object from an array of bytes.
Object	deserialize(InputStream is) Read an object from an input stream.
Object	deserialize(JPPFBuffer buf) Read an object from an array of bytes.
JPPFBuffer	serialize(Object o) Serialize an object into an array of bytes.
JPPFBuffer	serialize(Object o, boolean noCopy) Serialize an object into an array of bytes.
void	serialize(Object o, OutputStream os) Serialize an object into an output stream.

Method Detail

serialize

JPPFBuffer serialize(Object o)
                     throws Exception

Serialize an object into an array of bytes.

Parameters:

o - the object to Serialize.

Returns:

a JPPFBuffer instance holding the serialized object.

Throws:

Exception - if the object can't be serialized.

serialize

JPPFBuffer serialize(Object o,
                     boolean noCopy)
                     throws Exception

Serialize an object into an array of bytes.

Parameters:

o - the object to Serialize.

noCopy - avoid copying intermediate buffers.

Returns:

a JPPFBuffer instance holding the serialized object.

Throws:

Exception - if the object can't be serialized.

serialize

void serialize(Object o,
               OutputStream os)
               throws Exception

Serialize an object into an output stream.

Parameters:

o - the object to Serialize.

os - the output stream to serialize to.

Throws:

Exception - if the object can't be serialized.

deserialize

Object deserialize(JPPFBuffer buf)
                   throws Exception

Read an object from an array of bytes.

Parameters:

buf - buffer holding the array of bytes to deserialize from.

Returns:

the object that was deserialized from the array of bytes.

Throws:

Exception - the class of the deserialized object could not be found.

deserialize

Object deserialize(byte[] bytes)
                   throws Exception

Read an object from an array of bytes.

Parameters:

bytes - buffer holding the array of bytes to deserialize from.

Returns:

the object that was deserialized from the array of bytes.

Throws:

Exception - if the ObjectInputStream used for deserialization raises an error.

deserialize

Object deserialize(byte[] bytes,
                   int offset,
                   int length)
                   throws Exception

Read an object from an array of bytes.

Parameters:

bytes - buffer holding the array of bytes to deserialize from.

offset - position at which to start reading the bytes from.

length - the number of bytes to read.

Returns:

the object that was deserialized from the array of bytes.

Throws:

Exception - if the ObjectInputStream used for deserialization raises an error.

deserialize

Object deserialize(InputStream is)
                   throws Exception

Read an object from an input stream.

Parameters:

is - - the input stream to deserialize from.

Returns:

the object that was deserialized from the array of bytes.

Throws:

Exception - if the ObjectInputStream used for deserialization raises an error.