org.jboss.marshalling

Interface Externalizer

All Superinterfaces:

Serializable

All Known Implementing Classes:

Pair.Externalizer

public interface Externalizer
extends Serializable

A replacement serializer for an object class.

Method Summary

Modifier and Type	Method and Description
Object	createExternal(Class<?> subjectType, ObjectInput input) Create an instance of a type.
void	writeExternal(Object subject, ObjectOutput output) Write the external representation of an object.

Method Detail

writeExternal

void writeExternal(Object subject,
                   ObjectOutput output)
            throws IOException

Write the external representation of an object. The object's class and the externalizer's class will already have been written.

Parameters:

subject - the object to externalize

output - the output

Throws:

IOException - if an error occurs

createExternal

Object createExternal(Class<?> subjectType,
                      ObjectInput input)
               throws IOException,
                      ClassNotFoundException

Create an instance of a type. The object may then be initialized from input, or that may be deferred to the readExternal() method. Instances may simply delegate the task to the given Creator. Note that this method is called only on the leaf class, so externalizers for non-final classes that initialize the instance from the stream need to be aware of this.

Parameters:

subjectType - the type of object to create

input - the input

Returns:

the new instance

Throws:

IOException - if an error occurs

ClassNotFoundException - if a class could not be found during read