Class NamedCollectionConverter

java.lang.Object

com.thoughtworks.xstream.converters.collections.AbstractCollectionConverter

com.thoughtworks.xstream.converters.collections.CollectionConverter

com.thoughtworks.xstream.converters.extended.NamedCollectionConverter

All Implemented Interfaces:

Converter, ConverterMatcher

public class NamedCollectionConverter
extends CollectionConverter

A collection converter that uses predefined names for its items.

To be used as local converter. Note, suppress the usage of the implicit type argument, if registered with annotation.

Since:

1.4.5

Field Summary

Fields

Modifier and Type	Field	Description
private final String	name
private final Class	type

Constructor Summary

Constructors

Constructor	Description
NamedCollectionConverter(Mapper mapper, String itemName, Class itemType)	Constructs a NamedCollectionConverter.
NamedCollectionConverter(Class type, Mapper mapper, String itemName, Class itemType)	Constructs a NamedCollectionConverter handling an explicit Collection type.

Method Summary

Modifier and Type	Method	Description
protected Object	readBareItem(HierarchicalStreamReader reader, UnmarshallingContext context, Object current)	Read a bare item of the collection from the reader.
protected void	writeCompleteItem(Object item, MarshallingContext context, HierarchicalStreamWriter writer)	Write an item of the collection into the writer including surrounding tags.
protected void	writeItem(Object item, MarshallingContext context, HierarchicalStreamWriter writer)	Deprecated. As of 1.4.11 use writeCompleteItem(Object, MarshallingContext, HierarchicalStreamWriter) instead.

Methods inherited from class CollectionConverter

addCurrentElementToCollection, canConvert, createCollection, marshal, populateCollection, populateCollection, unmarshal

Methods inherited from class AbstractCollectionConverter

mapper, readCompleteItem, readItem, writeBareItem, writeNullItem

Methods inherited from class Object

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

Field Details

name

private final String name

type

private final Class type

Constructor Details

NamedCollectionConverter

public NamedCollectionConverter(Mapper mapper,
 String itemName,
 Class itemType)

Constructs a NamedCollectionConverter.

Parameters:

mapper - the mapper

itemName - the name of the items

itemType - the base type of the items

Since:

1.4.5

NamedCollectionConverter

public NamedCollectionConverter(Class type,
 Mapper mapper,
 String itemName,
 Class itemType)

Constructs a NamedCollectionConverter handling an explicit Collection type.

Parameters:

type - the Collection type to handle

mapper - the mapper

itemName - the name of the items

itemType - the base type of the items

Since:

1.4.5

Method Details

writeCompleteItem

protected void writeCompleteItem(Object item,
 MarshallingContext context,
 HierarchicalStreamWriter writer)

Description copied from class: AbstractCollectionConverter

Write an item of the collection into the writer including surrounding tags.

Overrides:

writeCompleteItem in class AbstractCollectionConverter

Parameters:

item - the item to write

context - the current marshalling context

writer - the target writer

writeItem

protected void writeItem(Object item,
 MarshallingContext context,
 HierarchicalStreamWriter writer)

Deprecated.

As of 1.4.11 use writeCompleteItem(Object, MarshallingContext, HierarchicalStreamWriter) instead.

Overrides:

writeItem in class AbstractCollectionConverter

readBareItem

protected Object readBareItem(HierarchicalStreamReader reader,
 UnmarshallingContext context,
 Object current)

Description copied from class: AbstractCollectionConverter

Read a bare item of the collection from the reader.

Overrides:

readBareItem in class AbstractCollectionConverter

Parameters:

reader - the source reader

context - the unmarshalling context

current - the target collection (if already available)

Returns:

the read item