Package com.thoughtworks.xstream.converters.javabean

Class JavaBeanConverter

java.lang.Object

com.thoughtworks.xstream.converters.javabean.JavaBeanConverter

All Implemented Interfaces:

Converter, ConverterMatcher

public class JavaBeanConverter
extends java.lang.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 JavaBeanProvider	beanProvider
private java.lang.String	classAttributeIdentifier	Deprecated. As of 1.3, no necessity for field anymore.
protected Mapper	mapper
private java.lang.Class	type

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
boolean	canConvert(java.lang.Class type)	Checks if the bean provider can instantiate this type.
private java.lang.Class	determineType(HierarchicalStreamReader reader, java.lang.Object result, java.lang.String fieldName)
private java.lang.Object	instantiateNewInstance(UnmarshallingContext context)
void	marshal(java.lang.Object source, HierarchicalStreamWriter writer, MarshallingContext context)	Convert an object to textual data.
java.lang.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

Field Detail

mapper

protected final Mapper mapper

beanProvider

protected final JavaBeanProvider beanProvider

type

private final java.lang.Class type

classAttributeIdentifier

private java.lang.String classAttributeIdentifier

Deprecated.

As of 1.3, no necessity for field anymore.

Constructor Detail

JavaBeanConverter

public JavaBeanConverter(Mapper mapper)

JavaBeanConverter

public JavaBeanConverter(Mapper mapper,
                         java.lang.Class type)

JavaBeanConverter

public JavaBeanConverter(Mapper mapper,
                         JavaBeanProvider beanProvider)

JavaBeanConverter

public JavaBeanConverter(Mapper mapper,
                         JavaBeanProvider beanProvider,
                         java.lang.Class type)

JavaBeanConverter

public JavaBeanConverter(Mapper mapper,
                         java.lang.String classAttributeIdentifier)

Deprecated.

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

Method Detail

canConvert

public boolean canConvert(java.lang.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(java.lang.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 java.lang.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.

instantiateNewInstance

private java.lang.Object instantiateNewInstance(UnmarshallingContext context)

determineType

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