Package org.jppf.serialization

Interface ObjectSerializer

All Known Implementing Classes:
BootstrapObjectSerializer, 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 Details

    • 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.