com.thoughtworks.xstream.converters.reflection

Class ExternalizableConverter

java.lang.Object

com.thoughtworks.xstream.converters.reflection.ExternalizableConverter

All Implemented Interfaces:

Converter, ConverterMatcher

public class ExternalizableConverter
extends Object
implements Converter

Converts any object that implements the java.io.Externalizable interface, allowing compatibility with native Java serialization.

Author:

Joe Walnes

Constructor Summary

Constructors

Constructor and Description
ExternalizableConverter(Mapper mapper) Deprecated. As of 1.4 use ExternalizableConverter(Mapper, ClassLoader)
ExternalizableConverter(Mapper mapper, ClassLoader classLoader) Deprecated. As of 1.4.5 use ExternalizableConverter(Mapper, ClassLoaderReference)
ExternalizableConverter(Mapper mapper, ClassLoaderReference classLoaderReference) Construct an ExternalizableConverter.

Method Summary

Modifier and Type	Method and Description
boolean	canConvert(Class type) Determines whether the converter can marshall a particular type.
void	marshal(Object original, HierarchicalStreamWriter writer, MarshallingContext context) Convert an object to textual data.
Object	unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) Convert textual data back into an object.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExternalizableConverter

public ExternalizableConverter(Mapper mapper,
                               ClassLoaderReference classLoaderReference)

Construct an ExternalizableConverter.

Parameters:

mapper - the Mapper chain

classLoaderReference - the reference to XStream's ClassLoader instance

Since:

1.4.5

ExternalizableConverter

public ExternalizableConverter(Mapper mapper,
                               ClassLoader classLoader)

Deprecated. As of 1.4.5 use ExternalizableConverter(Mapper, ClassLoaderReference)

ExternalizableConverter

public ExternalizableConverter(Mapper mapper)

Deprecated. As of 1.4 use ExternalizableConverter(Mapper, ClassLoader)

Method Detail

canConvert

public boolean canConvert(Class type)

Description copied from interface: ConverterMatcher

Determines whether the converter can marshall a particular type.

Specified by:

canConvert in interface ConverterMatcher

Parameters:

type - the Class representing the object type to be converted

marshal

public void marshal(Object original,
                    HierarchicalStreamWriter writer,
                    MarshallingContext context)

Description copied from interface: Converter

Convert an object to textual data.

Specified by:

marshal in interface Converter

Parameters:

original - The object to be marshalled.

writer - A stream to write to.

context - A context that allows nested objects to be processed by XStream.

unmarshal

public Object unmarshal(HierarchicalStreamReader reader,
                        UnmarshallingContext context)

Description copied from interface: Converter

Convert textual data back into an object.

Specified by:

unmarshal in interface Converter

Parameters:

reader - The stream to read the text from.

Returns:

The resulting object.