Class JavaBeanConverter

java.lang.Object

com.thoughtworks.xstream.converters.javabean.JavaBeanConverter

All Implemented Interfaces:

Converter, ConverterMatcher

public class JavaBeanConverter
extends Object
implements Converter

Can convert any bean with a public default constructor. The BeanProvider used as default is based on BeanInfo. Indexed properties are currently not supported.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	JavaBeanConverter.DuplicateFieldException	Deprecated. As of 1.3
static class	JavaBeanConverter.DuplicatePropertyException	Exception to indicate double processing of a property to avoid silent clobbering.

Field Summary

Fields

Modifier and Type	Field	Description
protected final JavaBeanProvider	beanProvider
private String	classAttributeIdentifier	Deprecated. As of 1.3, no necessity for field anymore.
protected final Mapper	mapper
private final Class	type

Constructor Summary

Constructors

Constructor	Description
JavaBeanConverter(Mapper mapper)
JavaBeanConverter(Mapper mapper, JavaBeanProvider beanProvider)
JavaBeanConverter(Mapper mapper, JavaBeanProvider beanProvider, Class type)
JavaBeanConverter(Mapper mapper, Class type)
JavaBeanConverter(Mapper mapper, String classAttributeIdentifier)	Deprecated. As of 1.3, use JavaBeanConverter(Mapper) and XStream.aliasAttribute(String, String)

Method Summary

Modifier and Type	Method	Description
boolean	canConvert(Class type)	Checks if the bean provider can instantiate this type.
private Class	determineType(HierarchicalStreamReader reader, Object result, String fieldName)
private Object	instantiateNewInstance(UnmarshallingContext context)
void	marshal(Object source, 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 Object

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

Field Details

mapper

protected final Mapper mapper

beanProvider

protected final JavaBeanProvider beanProvider

type

private final Class type

classAttributeIdentifier

private String classAttributeIdentifier

Deprecated.

As of 1.3, no necessity for field anymore.

Constructor Details

JavaBeanConverter

public JavaBeanConverter(Mapper mapper)

JavaBeanConverter

public JavaBeanConverter(Mapper mapper,
 Class type)

JavaBeanConverter

public JavaBeanConverter(Mapper mapper,
 JavaBeanProvider beanProvider)

JavaBeanConverter

public JavaBeanConverter(Mapper mapper,
 JavaBeanProvider beanProvider,
 Class type)

JavaBeanConverter

public JavaBeanConverter(Mapper mapper,
 String classAttributeIdentifier)

Deprecated.

As of 1.3, use JavaBeanConverter(Mapper) and XStream.aliasAttribute(String, String)

Method Details

canConvert

public boolean canConvert(Class type)

Checks if the bean provider can instantiate this type. If you need less strict checks, subclass JavaBeanConverter

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.

instantiateNewInstance

private Object instantiateNewInstance(UnmarshallingContext context)

determineType

private Class determineType(HierarchicalStreamReader reader,
 Object result,
 String fieldName)