Class AnnotationMapper

java.lang.Object

com.thoughtworks.xstream.mapper.MapperWrapper

com.thoughtworks.xstream.mapper.AnnotationMapper

All Implemented Interfaces:

AnnotationConfiguration, Mapper

public class AnnotationMapper
extends MapperWrapper
implements AnnotationConfiguration

A mapper that uses annotations to prepare the remaining mappers in the chain.

Since:

1.3

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private final class	AnnotationMapper.UnprocessedTypesSet

Nested classes/interfaces inherited from interface Mapper

Mapper.ImplicitCollectionMapping, Mapper.Null

Field Summary

Fields

Modifier and Type	Field	Description
private final Set<Class<?>>	annotatedTypes
private Object[]	arguments
private AttributeMapper	attributeMapper
private ClassAliasingMapper	classAliasingMapper
private final Map<Class<?>, Map<List<Object>, Converter>>	converterCache
private final ConverterRegistry	converterRegistry
private DefaultImplementationsMapper	defaultImplementationsMapper
private ElementIgnoringMapper	elementIgnoringMapper
private FieldAliasingMapper	fieldAliasingMapper
private ImplicitCollectionMapper	implicitCollectionMapper
private LocalConversionMapper	localConversionMapper
private boolean	locked

Constructor Summary

Constructors

Constructor	Description
AnnotationMapper(Mapper wrapped, ConverterRegistry converterRegistry, ConverterLookup converterLookup, ClassLoaderReference classLoaderReference, ReflectionProvider reflectionProvider)	Construct an AnnotationMapper.
AnnotationMapper(Mapper wrapped, ConverterRegistry converterRegistry, ConverterLookup converterLookup, ClassLoader classLoader, ReflectionProvider reflectionProvider, JVM jvm)	Deprecated. As of 1.4.5 use AnnotationMapper(Mapper, ConverterRegistry, ConverterLookup, ClassLoaderReference, ReflectionProvider)

Method Summary

Modifier and Type	Method	Description
private void	addParametrizedTypes(Type type, Set<Class<?>> types)
void	autodetectAnnotations(boolean mode)
private Converter	cacheConverter(XStreamConverter annotation, Class targetType)
Class	defaultImplementationOf(Class type)
private Class<?>	getClass(Type typeArgument)
Converter	getLocalConverter(Class definedIn, String fieldName)
private void	processAliasAnnotation(Class<?> type, Set<Class<?>> types)
private void	processAliasTypeAnnotation(Class<?> type)
private void	processAnnotations(Class initialType)
void	processAnnotations(Class[] initialTypes)
private void	processAsAttributeAnnotation(Field field)
private void	processConverterAnnotations(Class<?> type)
private void	processFieldAliasAnnotation(Field field)
private void	processImplicitAnnotation(Field field)
private void	processImplicitCollectionAnnotation(Class<?> type)	Deprecated.
private void	processLocalConverterAnnotation(Field field)
private void	processOmitFieldAnnotation(Field field)
private void	processTypes(Set<Class<?>> types)
private void	readObject(ObjectInputStream in)
String	realMember(Class type, String serialized)	How a serialized member representation should be mapped back to a real member.
String	serializedClass(Class type)	How a class name should be represented in its serialized form.
private void	setupMappers()
private void	writeObject(ObjectOutputStream out)

Methods inherited from class MapperWrapper

aliasForAttribute, aliasForAttribute, aliasForSystemAttribute, attributeForAlias, attributeForAlias, getConverterFromAttribute, getConverterFromAttribute, getConverterFromAttribute, getConverterFromItemType, getConverterFromItemType, getConverterFromItemType, getFieldNameForItemTypeAndName, getImplicitCollectionDefForFieldName, getItemTypeForItemFieldName, isIgnoredElement, isImmutableValueType, isReferenceable, lookupMapperOfType, realClass, serializedMember, shouldSerializeMember

Methods inherited from class Object

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

Field Details

locked

private boolean locked

arguments

private transient Object[] arguments

converterRegistry

private final ConverterRegistry converterRegistry

classAliasingMapper

private transient ClassAliasingMapper classAliasingMapper

defaultImplementationsMapper

private transient DefaultImplementationsMapper defaultImplementationsMapper

implicitCollectionMapper

private transient ImplicitCollectionMapper implicitCollectionMapper

fieldAliasingMapper

private transient FieldAliasingMapper fieldAliasingMapper

elementIgnoringMapper

private transient ElementIgnoringMapper elementIgnoringMapper

attributeMapper

private transient AttributeMapper attributeMapper

localConversionMapper

private transient LocalConversionMapper localConversionMapper

converterCache

private final Map<Class<?>, Map<List<Object>, Converter>> converterCache

annotatedTypes

private final Set<Class<?>> annotatedTypes

Constructor Details

AnnotationMapper

public AnnotationMapper(Mapper wrapped,
 ConverterRegistry converterRegistry,
 ConverterLookup converterLookup,
 ClassLoaderReference classLoaderReference,
 ReflectionProvider reflectionProvider)

Construct an AnnotationMapper.

Parameters:

wrapped - the next Mapper in the chain

Since:

1.4.5

AnnotationMapper

public AnnotationMapper(Mapper wrapped,
 ConverterRegistry converterRegistry,
 ConverterLookup converterLookup,
 ClassLoader classLoader,
 ReflectionProvider reflectionProvider,
 JVM jvm)

Deprecated.

As of 1.4.5 use AnnotationMapper(Mapper, ConverterRegistry, ConverterLookup, ClassLoaderReference, ReflectionProvider)

Construct an AnnotationMapper.

Parameters:

wrapped - the next Mapper in the chain

Since:

1.3

Method Details

realMember

public String realMember(Class type,
 String serialized)

Description copied from interface: Mapper

How a serialized member representation should be mapped back to a real member.

Specified by:

realMember in interface Mapper

Overrides:

realMember in class MapperWrapper

serializedClass

public String serializedClass(Class type)

Description copied from interface: Mapper

How a class name should be represented in its serialized form.

Specified by:

serializedClass in interface Mapper

Overrides:

serializedClass in class MapperWrapper

defaultImplementationOf

public Class defaultImplementationOf(Class type)

Specified by:

defaultImplementationOf in interface Mapper

Overrides:

defaultImplementationOf in class MapperWrapper

getLocalConverter

public Converter getLocalConverter(Class definedIn,
 String fieldName)

Specified by:

getLocalConverter in interface Mapper

Overrides:

getLocalConverter in class MapperWrapper

autodetectAnnotations

public void autodetectAnnotations(boolean mode)

Specified by:

autodetectAnnotations in interface AnnotationConfiguration

processAnnotations

public void processAnnotations(Class[] initialTypes)

Specified by:

processAnnotations in interface AnnotationConfiguration

processAnnotations

private void processAnnotations(Class initialType)

processTypes

private void processTypes(Set<Class<?>> types)

addParametrizedTypes

private void addParametrizedTypes(Type type,
 Set<Class<?>> types)

processConverterAnnotations

private void processConverterAnnotations(Class<?> type)

processAliasAnnotation

private void processAliasAnnotation(Class<?> type,
 Set<Class<?>> types)

processAliasTypeAnnotation

private void processAliasTypeAnnotation(Class<?> type)

processImplicitCollectionAnnotation

@Deprecated
private void processImplicitCollectionAnnotation(Class<?> type)

Deprecated.

processFieldAliasAnnotation

private void processFieldAliasAnnotation(Field field)

processAsAttributeAnnotation

private void processAsAttributeAnnotation(Field field)

processImplicitAnnotation

private void processImplicitAnnotation(Field field)

processOmitFieldAnnotation

private void processOmitFieldAnnotation(Field field)

processLocalConverterAnnotation

private void processLocalConverterAnnotation(Field field)

cacheConverter

private Converter cacheConverter(XStreamConverter annotation,
 Class targetType)

getClass

private Class<?> getClass(Type typeArgument)

setupMappers

private void setupMappers()

writeObject

private void writeObject(ObjectOutputStream out)
                  throws IOException

Throws:

IOException

readObject

private void readObject(ObjectInputStream in)
                 throws IOException,
ClassNotFoundException

Throws:

IOException

ClassNotFoundException