Class MapConverter

java.lang.Object

com.thoughtworks.xstream.converters.collections.AbstractCollectionConverter

com.thoughtworks.xstream.converters.collections.MapConverter

All Implemented Interfaces:

Converter, ConverterMatcher

Direct Known Subclasses:

EnumMapConverter, NamedMapConverter, SingletonMapConverter, TreeMapConverter

public class MapConverter
extends AbstractCollectionConverter

Converts a java.util.Map to XML, specifying an 'entry' element with 'key' and 'value' children.

Note: 'key' and 'value' is not the name of the generated tag. The children are serialized as normal elements and the implementation expects them in the order 'key'/'value'.

Supports java.util.HashMap, java.util.Hashtable, java.util.LinkedHashMap and java.util.concurrent.ConcurrentHashMap.

Field Summary

Fields

Modifier and Type	Field	Description
private final Class	type

Constructor Summary

Constructors

Constructor	Description
MapConverter(Mapper mapper)
MapConverter(Mapper mapper, Class type)	Construct a MapConverter for a special Map type.

Method Summary

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

Methods inherited from class AbstractCollectionConverter

mapper, readBareItem, readCompleteItem, readItem, writeBareItem, writeCompleteItem, writeItem, writeNullItem

Methods inherited from class Object

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

Field Details

type

private final Class type

Constructor Details

MapConverter

public MapConverter(Mapper mapper)

MapConverter

public MapConverter(Mapper mapper,
 Class type)

Construct a MapConverter for a special Map type.

Parameters:

mapper - the mapper

type - the type to handle

Since:

1.4.5

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

Specified by:

canConvert in class AbstractCollectionConverter

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

Specified by:

marshal in class AbstractCollectionConverter

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

Specified by:

unmarshal in class AbstractCollectionConverter

Parameters:

reader - The stream to read the text from.

context -

Returns:

The resulting object.

populateMap

protected void populateMap(HierarchicalStreamReader reader,
 UnmarshallingContext context,
 Map map)

populateMap

protected void populateMap(HierarchicalStreamReader reader,
 UnmarshallingContext context,
 Map map,
 Map target)

putCurrentEntryIntoMap

protected void putCurrentEntryIntoMap(HierarchicalStreamReader reader,
 UnmarshallingContext context,
 Map map,
 Map target)

createCollection

protected Object createCollection(Class type)

Overrides:

createCollection in class AbstractCollectionConverter