com.owlike.genson.reflect

Class AbstractBeanDescriptorProvider

java.lang.Object

com.owlike.genson.reflect.AbstractBeanDescriptorProvider

All Implemented Interfaces:

BeanDescriptorProvider

Direct Known Subclasses:

BaseBeanDescriptorProvider

public abstract class AbstractBeanDescriptorProvider
extends Object
implements BeanDescriptorProvider

Abstract implementation of BeanDescriptorProvider applying the template pattern. If you wonder how to implement the different abstract methods defined in this class have a look at the BaseBeanDescriptorProvider.

Author:

eugen

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractBeanDescriptorProvider.ContextualConverterFactory
static class	AbstractBeanDescriptorProvider.ContextualFactoryDecorator

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractBeanDescriptorProvider(AbstractBeanDescriptorProvider.ContextualConverterFactory contextualConverterFactory)

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract BeanCreator	checkAndMerge(Type ofType, List<BeanCreator> creators) Implementations of this method can do some additional checks on the creators validity or do any other operations related to creators.
protected abstract PropertyAccessor	checkAndMergeAccessors(String name, LinkedList<PropertyAccessor> accessors) Implementations are supposed to merge the PropertyAccessors from accessors list into a single PropertyAccessor.
protected abstract PropertyMutator	checkAndMergeMutators(String name, LinkedList<PropertyMutator> mutators) Implementations are supposed to merge the PropertyMutators from mutators list into a single PropertyMutator.
protected <T> BeanDescriptor<T>	create(Class<T> forClass, Type ofType, BeanCreator creator, List<PropertyAccessor> accessors, Map<String,PropertyMutator> mutators) Creates an instance of BeanDescriptor based on the passed arguments.
protected abstract void	mergeMutatorsWithCreatorProperties(Type ofType, Map<String,PropertyMutator> mutators, List<BeanCreator> creators) Implementations may do additional merge operations based on resolved creators and their properties and the resolved mutators.
<T> BeanDescriptor<T>	provide(Class<T> ofClass, Genson genson)
<T> BeanDescriptor<T>	provide(Class<T> ofClass, Type ofType, Genson genson) Provides a BeanDescriptor that can serialize/deserialize "ofClass" type, based on "type" argument.
BeanDescriptor<?>	provide(Type ofType, Genson genson) Provides a BeanDescriptor for type "ofType" using current Genson instance.
protected abstract List<BeanCreator>	provideBeanCreators(Type ofType, Genson genson) Provides a list of BeanCreator for type ofType.
protected abstract void	provideBeanPropertyAccessors(Type ofType, Map<String,LinkedList<PropertyAccessor>> accessorsMap, Genson genson) Adds resolved PropertyAccessor to accessorsMap.
protected abstract void	provideBeanPropertyMutators(Type ofType, Map<String,LinkedList<PropertyMutator>> mutatorsMap, Genson genson) Adds resolved PropertyMutator to mutatorsMap.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractBeanDescriptorProvider

protected AbstractBeanDescriptorProvider(AbstractBeanDescriptorProvider.ContextualConverterFactory contextualConverterFactory)

Method Detail

provide

public <T> BeanDescriptor<T> provide(Class<T> ofClass,
                            Genson genson)

Specified by:

provide in interface BeanDescriptorProvider

See Also:

BeanDescriptorProvider.provide(Type, Genson)

provide

public BeanDescriptor<?> provide(Type ofType,
                        Genson genson)

Description copied from interface: BeanDescriptorProvider

Provides a BeanDescriptor for type "ofType" using current Genson instance.

Specified by:

provide in interface BeanDescriptorProvider

Parameters:

ofType - is the type for which we need a BeanDescriptor.

genson - is the current Genson instance.

Returns:

A BeanDescriptor instance able to serialize/deserialize objects of type ofType.

provide

public <T> BeanDescriptor<T> provide(Class<T> ofClass,
                            Type ofType,
                            Genson genson)

Description copied from interface: BeanDescriptorProvider

Provides a BeanDescriptor that can serialize/deserialize "ofClass" type, based on "type" argument. The arguments "ofClass" and "type" will be the same in most cases, but for example in BeanViews ofClass will correspond to the parameterized type and "type" to the BeanView implementation.

Specified by:

provide in interface BeanDescriptorProvider

Parameters:

ofClass - is the Class for which we need a BeanDescriptor that will be able to serialize/deserialize objects of that type;

ofType - to use to build this descriptor (use its declared methods, fields, etc).

genson - is the current Genson instance.

Returns:

A BeanDescriptor instance able to serialize/deserialize objects of type ofClass.

create

protected <T> BeanDescriptor<T> create(Class<T> forClass,
                           Type ofType,
                           BeanCreator creator,
                           List<PropertyAccessor> accessors,
                           Map<String,PropertyMutator> mutators)

Creates an instance of BeanDescriptor based on the passed arguments. Subclasses can override this method to create their own BeanDescriptors.

Parameters:

forClass -

ofType -

creator -

accessors -

mutators -

Returns:

a instance

provideBeanCreators

protected abstract List<BeanCreator> provideBeanCreators(Type ofType,
                                    Genson genson)

Provides a list of BeanCreator for type ofType.

Parameters:

ofType -

genson -

Returns:

provideBeanPropertyMutators

protected abstract void provideBeanPropertyMutators(Type ofType,
                               Map<String,LinkedList<PropertyMutator>> mutatorsMap,
                               Genson genson)

Adds resolved PropertyMutator to mutatorsMap.

Parameters:

ofType -

mutatorsMap -

genson -

provideBeanPropertyAccessors

protected abstract void provideBeanPropertyAccessors(Type ofType,
                                Map<String,LinkedList<PropertyAccessor>> accessorsMap,
                                Genson genson)

Adds resolved PropertyAccessor to accessorsMap.

Parameters:

ofType -

accessorsMap -

genson -

checkAndMerge

protected abstract BeanCreator checkAndMerge(Type ofType,
                        List<BeanCreator> creators)

Implementations of this method can do some additional checks on the creators validity or do any other operations related to creators. This method must merge all creators into a single one.

Parameters:

creators -

Returns:

the creator that will be used by the BeanDescriptor

checkAndMergeMutators

protected abstract PropertyMutator checkAndMergeMutators(String name,
                                    LinkedList<PropertyMutator> mutators)

Implementations are supposed to merge the PropertyMutators from mutators list into a single PropertyMutator.

Parameters:

name -

mutators -

Returns:

a single PropertyMutator or null.

mergeMutatorsWithCreatorProperties

protected abstract void mergeMutatorsWithCreatorProperties(Type ofType,
                                      Map<String,PropertyMutator> mutators,
                                      List<BeanCreator> creators)

Implementations may do additional merge operations based on resolved creators and their properties and the resolved mutators.

Parameters:

ofType -

mutators -

creators -

checkAndMergeAccessors

protected abstract PropertyAccessor checkAndMergeAccessors(String name,
                                      LinkedList<PropertyAccessor> accessors)

Implementations are supposed to merge the PropertyAccessors from accessors list into a single PropertyAccessor.

Parameters:

name -

accessors -

Returns: