Class EncodedByteArrayConverter

java.lang.Object

com.thoughtworks.xstream.converters.extended.EncodedByteArrayConverter

All Implemented Interfaces:

Converter, ConverterMatcher, SingleValueConverter

public class EncodedByteArrayConverter
extends Object
implements Converter, SingleValueConverter

Converts a byte array by default to a single Base64 encoding string.

Field Summary

Fields

Modifier and Type	Field	Description
private static final ByteConverter	byteConverter
private final StringCodec	codec

Constructor Summary

Constructors

Constructor	Description
EncodedByteArrayConverter()	Constructs an EncodedByteArrayConverter.
EncodedByteArrayConverter(StringCodec stringCodec)	Constructs an EncodedByteArrayConverter with a provided string codec.

Method Summary

Modifier and Type	Method	Description
boolean	canConvert(Class type)	Determines whether the converter can marshall a particular type.
Object	fromString(String str)	Unmarshals an Object from its single value representation.
void	marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context)	Convert an object to textual data.
String	toString(Object obj)	Marshals an Object into a single value representation.
Object	unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context)	Convert textual data back into an object.
private Object	unmarshalIndividualByteElements(HierarchicalStreamReader reader, UnmarshallingContext context)

Methods inherited from class Object

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

Field Details

byteConverter

private static final ByteConverter byteConverter

codec

private final StringCodec codec

Constructor Details

EncodedByteArrayConverter

public EncodedByteArrayConverter()

Constructs an EncodedByteArrayConverter. Initializes the converter with a Base64 codec.

EncodedByteArrayConverter

public EncodedByteArrayConverter(StringCodec stringCodec)

Constructs an EncodedByteArrayConverter with a provided string codec.

Parameters:

stringCodec - the codec to encode and decode the data as string

Since:

1.4.11

Method Details

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 source,
 HierarchicalStreamWriter writer,
 MarshallingContext context)

Description copied from interface: Converter

Convert an object to textual data.

Specified by:

marshal in interface Converter

Parameters:

source - 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.

context -

Returns:

The resulting object.

unmarshalIndividualByteElements

private Object unmarshalIndividualByteElements(HierarchicalStreamReader reader,
 UnmarshallingContext context)

toString

public String toString(Object obj)

Description copied from interface: SingleValueConverter

Marshals an Object into a single value representation.

Specified by:

toString in interface SingleValueConverter

Parameters:

obj - the Object to be converted

Returns:

a String with the single value of the Object or null

fromString

public Object fromString(String str)

Description copied from interface: SingleValueConverter

Unmarshals an Object from its single value representation.

Specified by:

fromString in interface SingleValueConverter

Parameters:

str - the String with the single value of the Object

Returns:

the Object