com.devexperts.io

Class Marshaller.Typed<T>

java.lang.Object

com.devexperts.io.Marshaller<T>

com.devexperts.io.Marshaller.Typed<T>

Type Parameters:

T - the marshalled object's type.

Enclosing class:

Marshaller<T>

public abstract static class Marshaller.Typed<T>
extends Marshaller<T>

Typed marshaller that marshals instances of a single type or an array of types. Instances of this abstract class are obtained using Marshaller.forTypes and Marshaller.forClasses methods for multiple types, or using Marshaller.forType and Marshaller.forClass for a single type.

The serial form of typed marshaller uses efficient serialization of primitive data (individual and arrays) and single ObjectOutputStream for remaining non-primitive data. Unlike Marshaller.serialization(Class) serialization} marshallers, typed marshallers for different types are not the same and are not compatible on a byte-array level even if the actual serialized objects are the same. The same exact marshaller shall be used for writing and for reading.

Nested Class Summary

Nested classes/interfaces inherited from class com.devexperts.io.Marshaller

Marshaller.Typed<T>

Field Summary

Fields inherited from class com.devexperts.io.Marshaller

SERIALIZATION

Method Summary

Modifier and Type	Method and Description
abstract boolean	equals(Object obj) Indicates whether some other object is "equal to" this one.
abstract Class<?>[]	getClasses(ClassLoader cl) Returns an array of classes of this typed marshaller.
abstract String	getTypes() Returns a comma-separated list of type names of this typed marshaller.
abstract int	hashCode() Returns a hash code value for the object that is consistent with equals.

Methods inherited from class com.devexperts.io.Marshaller

forClass, forClasses, forType, forTypes, readMarshalledLength, readObjectFrom, representsNullObjectAsNullBytes, serialization, serialization, supportsNullObject, writeMarshalledLength, writeObjectTo

Methods inherited from class java.lang.Object

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

Method Detail

getTypes

public abstract String getTypes()

Returns a comma-separated list of type names of this typed marshaller. Type names are the same as returned by Class.getName() method.

Returns:

a comma-separated list of type names.

getClasses

public abstract Class<?>[] getClasses(ClassLoader cl)
                               throws InvalidClassException

Returns an array of classes of this typed marshaller. ClassLoader argument is used only by the first successful invocation of this method. The resolved classes are stored in the instance of this class afterwards.

Parameters:

cl - Classloader to resolve classes that were specified by their types names.

Returns:

an array of classes of this typed marshaller.

Throws:

InvalidClassException - if classes cannot be found/loaded.

equals

public abstract boolean equals(Object obj)

Indicates whether some other object is "equal to" this one. Typed marshallers are equal when their types are the same and they were both produced by Marshaller.forTypes and Marshaller.forClasses or by Marshaller.forType and Marshaller.forClass methods.

Note, that comparison for equality does not check the equality of actual classes, so typed marshallers for different classes with the same name (from different class loaders) are considered to be equal, even though they are not necessary interchangeable between each other.

Overrides:

equals in class Marshaller<T>

Returns:

true if this object is the same as the obj argument; false otherwise.

hashCode

public abstract int hashCode()

Returns a hash code value for the object that is consistent with equals.

Overrides:

hashCode in class Marshaller<T>

Returns:

a hash code value for this object.