org.infinispan.stream

Class StreamMarshalling.StreamMarshallingExternalizer

java.lang.Object

org.infinispan.stream.StreamMarshalling.StreamMarshallingExternalizer

All Implemented Interfaces:

Serializable, AdvancedExternalizer<Object>, Externalizer<Object>

Enclosing class:

StreamMarshalling

public static final class StreamMarshalling.StreamMarshallingExternalizer
extends Object
implements AdvancedExternalizer<Object>

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
StreamMarshallingExternalizer()

Method Summary

Modifier and Type	Method and Description
Integer	getId() Returns an integer that identifies the externalizer type.
Set<Class<?>>	getTypeClasses() Returns a collection of Class instances representing the types that this AdvancedExternalizer can marshall.
Object	readObject(ObjectInput input) Read an instance from the stream.
void	writeObject(ObjectOutput output, Object object) Write the object reference to the stream.

Methods inherited from class java.lang.Object

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

Constructor Detail

StreamMarshallingExternalizer

public StreamMarshallingExternalizer()

Method Detail

getTypeClasses

public Set<Class<?>> getTypeClasses()

Description copied from interface: AdvancedExternalizer

Returns a collection of Class instances representing the types that this AdvancedExternalizer can marshall. Clearly, empty sets are not allowed. The externalizer framework currently requires all individual types to be listed since it does not make assumptions based on super classes or interfaces.

Specified by:

getTypeClasses in interface AdvancedExternalizer<Object>

Returns:

A set containing the Class instances that can be marshalled.

getId

public Integer getId()

Description copied from interface: AdvancedExternalizer

Returns an integer that identifies the externalizer type. This is used at read time to figure out which AdvancedExternalizer should read the contents of the incoming buffer. Using a positive integer allows for very efficient variable length encoding of numbers, and it's much more efficient than shipping AdvancedExternalizer implementation class information around. Negative values are not allowed. Implementers of this interface can use any positive integer as long as it does not clash with any other identifier in the system. You can find information on the pre-assigned identifier ranges in here. It's highly recommended that maintaining of these identifiers is done in a centralized way and you can do so by making annotations reference a set of statically defined identifiers in a separate class or interface. Such class/interface gives a global view of the identifiers in use and so can make it easier to assign new ids. Implementors can optionally avoid giving a meaningful implementation to this method (i.e. return null) and instead rely on XML or programmatic configuration to provide the AdvancedExternalizer id. If no id can be determined via the implementation or XML/programmatic configuration, an error will be reported. If an id has been defined both via the implementation and XML/programmatic configuration, the value defined via XML/programmatic configuration will be used ignoring the other.

Specified by:

getId in interface AdvancedExternalizer<Object>

Returns:

A positive identifier for the AdvancedExternalizer.

writeObject

public void writeObject(ObjectOutput output,
                        Object object)
                 throws IOException

Description copied from interface: Externalizer

Write the object reference to the stream.

Specified by:

writeObject in interface Externalizer<Object>

Parameters:

output - the object output to write to

object - the object reference to write

Throws:

IOException - if an I/O error occurs

readObject

public Object readObject(ObjectInput input)
                  throws IOException,
                         ClassNotFoundException

Description copied from interface: Externalizer

Read an instance from the stream. The instance will have been written by the Externalizer.writeObject(ObjectOutput, Object) method. Implementations are free to create instances of the object read from the stream in any way that they feel like. This could be via constructor, factory or reflection.

Specified by:

readObject in interface Externalizer<Object>

Parameters:

input - the object input to read from

Returns:

the object instance

Throws:

IOException - if an I/O error occurs

ClassNotFoundException - if a class could not be found