net.nicholaswilliams.java.licensing

Class ObjectSerializer

java.lang.Object

net.nicholaswilliams.java.licensing.ObjectSerializer

public final class ObjectSerializer
extends Object

This is a helper class for writing any object and reading simple objects (no arrays, collections, or generic top-level objects) to and from byte arrays.

Since:

1.0.0

Version:

1.0.0

Author:

Nick Williams

Constructor Summary

Constructors

Constructor and Description
ObjectSerializer()

Method Summary

Methods

Modifier and Type	Method and Description
<T extends Serializable> T	readObject(Class<T> expectedType, byte[] byteStream) Deserializes an object of the specified type from the provided byte stream.
byte[]	writeObject(Serializable object) Serializes the Serializable object passed and returns it as a byte array.

Methods inherited from class java.lang.Object

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

Constructor Detail

ObjectSerializer

public ObjectSerializer()

Method Detail

readObject

public final <T extends Serializable> T readObject(Class<T> expectedType,
                                    byte[] byteStream)
                                        throws ObjectDeserializationException

Deserializes an object of the specified type from the provided byte stream.

Parameters:

expectedType - The type that is expected to be retrieved from byteStream (must implement Serializable)

byteStream - The byte stream to retrieve the object from (it must contain exactly one object, of the exact type passed to expectedType)

Returns:

the requested unserialized object, presumably in the stream.

Throws:

ObjectTypeNotExpectedException - If the object found in the stream does not match the type expectedType or if a ClassNotFoundException or NoClassDefFoundError occurs

ObjectDeserializationException - If an I/O exception occurs while deserializing the object from the stream

writeObject

public final byte[] writeObject(Serializable object)
                         throws ObjectSerializationException

Serializes the Serializable object passed and returns it as a byte array.

Parameters:

object - The object to serialize

Returns:

the byte stream with the object serialized in it.

Throws:

ObjectSerializationException - if an I/O exception occurs while serializing the object.