ma.glasnost.orika.impl

Class MapperFacadeImpl

java.lang.Object

ma.glasnost.orika.impl.MapperFacadeImpl

All Implemented Interfaces:

MapperFacade, StateReporter.Reportable

public class MapperFacadeImpl
extends Object
implements MapperFacade, StateReporter.Reportable

MapperFacadeImpl is the base implementation of MapperFacade

Field Summary

Fields

Modifier and Type	Field and Description
protected MapperFactory	mapperFactory
protected UnenhanceStrategy	unenhanceStrategy

Constructor Summary

Constructors

Constructor and Description
MapperFacadeImpl(MapperFactory mapperFactory, MappingContextFactory contextFactory, UnenhanceStrategy unenhanceStrategy, ExceptionUtility exceptionUtil) Constructs a new MapperFacadeImpl

Method Summary

Modifier and Type	Method and Description
<S,D> D	convert(S source, Class<D> destinationClass, String converterId, MappingContext context) Convert the source object into the appropriate destination type
<S,D> D	convert(S source, Type<S> sourceType, Type<D> destinationType, String converterId, MappingContext context) Convert the source object into the appropriate destination type
void	factoryModified(MapperFactory factory) Notifies the MapperFacade that a MapperFactory associated with it has been modified.
protected Class<?>	getClass(Object object) Get the class for the specified object, accounting for unwrapping
<S,D> D	map(S sourceObject, Class<D> destinationClass) Create and return a new instance of type D mapped with the properties of sourceObject.
<S,D> D	map(S sourceObject, Class<D> destinationClass, MappingContext context) Create and return a new instance of type D mapped with the properties of sourceObject.
<S,D> void	map(S sourceObject, D destinationObject) Maps the properties of sourceObject onto destinationObject.
<S,D> void	map(S sourceObject, D destinationObject, MappingContext context) Maps the properties of sourceObject onto destinationObject.
<S,D> void	map(S sourceObject, D destinationObject, Type<S> sourceType, Type<D> destinationType) Maps the properties of sourceObject onto destinationObject, using sourceType and destinationType to specify the parameterized types of the source and destination object.
<S,D> void	map(S sourceObject, D destinationObject, Type<S> sourceType, Type<D> destinationType, MappingContext context) Maps the properties of sourceObject onto destinationObject, using sourceType and destinationType to specify the parameterized types of the source and destination object.
<S,D> D	map(S sourceObject, Type<S> sourceType, Type<D> destinationClass) Create and return a new instance of type D mapped with the properties of sourceObject.
<S,D> D	map(S sourceObject, Type<S> sourceType, Type<D> destinationType, MappingContext context) Create and return a new instance of type D mapped with the properties of sourceObject.
<S,D> D	map(S sourceObject, Type<S> sourceType, Type<D> destinationType, MappingContext context, MappingStrategy suggestedStrategy)
<S,D> D[]	mapAsArray(D[] destination, Iterable<S> source, Class<D> destinationClass) Maps the source interable into a new Array of typeD.
<S,D> D[]	mapAsArray(D[] destination, Iterable<S> source, Class<D> destinationClass, MappingContext context) Maps the source Iterable into a new Array of typeD.
<S,D> D[]	mapAsArray(D[] destination, Iterable<S> source, Type<S> sourceType, Type<D> destinationType) Maps the source Array into a new List parameterized by destinationType.
<S,D> D[]	mapAsArray(D[] destination, Iterable<S> source, Type<S> sourceType, Type<D> destinationType, MappingContext context) Maps the source Iterable into the destination Array
<Sk,Sv,D> D[]	mapAsArray(D[] destination, Map<Sk,Sv> source, Type<? extends Map<Sk,Sv>> sourceType, Type<D> destinationType) Map from a java.util.Map to a Set
<Sk,Sv,D> D[]	mapAsArray(D[] destination, Map<Sk,Sv> source, Type<? extends Map<Sk,Sv>> sourceType, Type<D> destinationType, MappingContext context) Map from a java.util.Map to a Set
<S,D> D[]	mapAsArray(D[] destination, S[] source, Class<D> destinationClass) Maps the source array into a new Array of typeD.
<S,D> D[]	mapAsArray(D[] destination, S[] source, Class<D> destinationClass, MappingContext context) Maps the source Array into a new Array of typeD.
<S,D> D[]	mapAsArray(D[] destination, S[] source, Type<S> sourceType, Type<D> destinationType) Maps the source Array into a new List parameterized by destinationType.
<S,D> D[]	mapAsArray(D[] destination, S[] source, Type<S> sourceType, Type<D> destinationType, MappingContext context) Maps the source Array into the destination Array
<S,D> void	mapAsCollection(Iterable<S> source, Collection<D> destination, Class<D> destinationClass) Maps the source Iterable into the destination Collection
<S,D> void	mapAsCollection(Iterable<S> source, Collection<D> destination, Class<D> destinationClass, MappingContext context) Map an iterable onto an existing collection
<S,D> void	mapAsCollection(Iterable<S> source, Collection<D> destination, Type<S> sourceType, Type<D> destinationType) Map an iterable onto an existing collection
<S,D> void	mapAsCollection(Iterable<S> source, Collection<D> destination, Type<S> sourceType, Type<D> destinationType, MappingContext context) Map an iterable onto an existing collection
<S,D> void	mapAsCollection(S[] source, Collection<D> destination, Class<D> destinationClass) Map an array onto an existing collection
<S,D> void	mapAsCollection(S[] source, Collection<D> destination, Class<D> destinationClass, MappingContext context) Map an array onto an existing collection
<S,D> void	mapAsCollection(S[] source, Collection<D> destination, Type<S> sourceType, Type<D> destinationType) Map an array onto an existing collection
<S,D> void	mapAsCollection(S[] source, Collection<D> destination, Type<S> sourceType, Type<D> destinationType, MappingContext context) Map an array onto an existing collection
<S,D> List<D>	mapAsList(Iterable<S> source, Class<D> destinationClass) Maps the source Iterable into a new List parameterized by destinationClass.
<S,D> List<D>	mapAsList(Iterable<S> source, Class<D> destinationClass, MappingContext context) Maps the source Iterable into a new List parameterized by destinationClass.
<S,D> List<D>	mapAsList(Iterable<S> source, Type<S> sourceType, Type<D> destinationType) Maps the source Iterable into a new List parameterized by destinationType.
<S,D> List<D>	mapAsList(Iterable<S> source, Type<S> sourceType, Type<D> destinationType, MappingContext context) Maps the source Iterable into a new List parameterized by destinationType.
<Sk,Sv,D> List<D>	mapAsList(Map<Sk,Sv> source, Type<? extends Map<Sk,Sv>> sourceType, Type<D> destinationType) Map from a java.util.Map to a List
<Sk,Sv,D> List<D>	mapAsList(Map<Sk,Sv> source, Type<? extends Map<Sk,Sv>> sourceType, Type<D> destinationType, MappingContext context) Map from a java.util.Map to a List
<S,D> List<D>	mapAsList(S[] source, Class<D> destinationClass) Maps the source Array into a new List parameterized by destinationClass.
<S,D> List<D>	mapAsList(S[] source, Class<D> destinationClass, MappingContext context) Maps the source Array into a new List parameterized by destinationClass.
<S,D> List<D>	mapAsList(S[] source, Type<S> sourceType, Type<D> destinationType) Maps the source Array into a new List parameterized by destinationType.
<S,D> List<D>	mapAsList(S[] source, Type<S> sourceType, Type<D> destinationType, MappingContext context) Maps the source Array into a new List parameterized by destinationType.
<S,Dk,Dv> Map<Dk,Dv>	mapAsMap(Iterable<S> source, Type<S> sourceType, Type<? extends Map<Dk,Dv>> destinationType) Map from an Iterable to an instance of java.util.Map.
<S,Dk,Dv> Map<Dk,Dv>	mapAsMap(Iterable<S> source, Type<S> sourceType, Type<? extends Map<Dk,Dv>> destinationType, MappingContext context) Map from an Iterable to an instance of java.util.Map.
<Sk,Sv,Dk,Dv> Map<Dk,Dv>	mapAsMap(Map<Sk,Sv> source, Type<? extends Map<Sk,Sv>> sourceType, Type<? extends Map<Dk,Dv>> destinationType) Map from one instance of java.util.Map to another.
<Sk,Sv,Dk,Dv> Map<Dk,Dv>	mapAsMap(Map<Sk,Sv> source, Type<? extends Map<Sk,Sv>> sourceType, Type<? extends Map<Dk,Dv>> destinationType, MappingContext context) Map from one instance of java.util.Map to another.
<S,Dk,Dv> Map<Dk,Dv>	mapAsMap(S[] source, Type<S> sourceType, Type<? extends Map<Dk,Dv>> destinationType) Map from an Array to an instance of java.util.Map.
<S,Dk,Dv> Map<Dk,Dv>	mapAsMap(S[] source, Type<S> sourceType, Type<? extends Map<Dk,Dv>> destinationType, MappingContext context) Map from an Array to an instance of java.util.Map.
<S,D> Set<D>	mapAsSet(Iterable<S> source, Class<D> destinationClass) Maps the source iterable into a new Set parameterized by destinationClass.
<S,D> Set<D>	mapAsSet(Iterable<S> source, Class<D> destinationClass, MappingContext context) Maps the source iterable into a new Set parameterized by destinationClass.
<S,D> Set<D>	mapAsSet(Iterable<S> source, Type<S> sourceType, Type<D> destinationType) Maps the source Iterable into a new Set parameterized by destinationType.
<S,D> Set<D>	mapAsSet(Iterable<S> source, Type<S> sourceType, Type<D> destinationType, MappingContext context) Maps the source Iterable into a new Set parameterized by destinationType.
<Sk,Sv,D> Set<D>	mapAsSet(Map<Sk,Sv> source, Type<? extends Map<Sk,Sv>> sourceType, Type<D> destinationType) Map from a java.util.Map to a Set
<Sk,Sv,D> Set<D>	mapAsSet(Map<Sk,Sv> source, Type<? extends Map<Sk,Sv>> sourceType, Type<D> destinationType, MappingContext context) Map from a java.util.Map to a Set
<S,D> Set<D>	mapAsSet(S[] source, Class<D> destinationClass) Maps the source Array into a new Set parameterized by destinationClass.
<S,D> Set<D>	mapAsSet(S[] source, Class<D> destinationClass, MappingContext context) Maps the source Array into a new Set parameterized by destinationClass.
<S,D> Set<D>	mapAsSet(S[] source, Type<S> sourceType, Type<D> destinationType) Maps the source Array into a new Set parameterized by destinationType.
<S,D> Set<D>	mapAsSet(S[] source, Type<S> sourceType, Type<D> destinationType, MappingContext context) Maps the source Array into a new Set parameterized by destinationType.
<S,D> D	newObject(S sourceObject, Type<? extends D> destinationType, MappingContext context) Create new instance of a destination class.
void	reportCurrentState(StringBuilder out) Prints the current state of this MapperFacade to the supplied StringBuilder instance.
<S,D> MappingStrategy	resolveMappingStrategy(S sourceObject, Type initialSourceType, Type initialDestinationType, boolean mapInPlace, MappingContext context) Resolves a reusable MappingStrategy for the given set of inputs.

Methods inherited from class java.lang.Object

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

Field Detail

mapperFactory

protected final MapperFactory mapperFactory

unenhanceStrategy

protected final UnenhanceStrategy unenhanceStrategy

Constructor Detail

MapperFacadeImpl

public MapperFacadeImpl(MapperFactory mapperFactory,
                        MappingContextFactory contextFactory,
                        UnenhanceStrategy unenhanceStrategy,
                        ExceptionUtility exceptionUtil)

Constructs a new MapperFacadeImpl

Parameters:

mapperFactory -

contextFactory -

unenhanceStrategy -

Method Detail

map

public <S,D> D map(S sourceObject,
                   Type<S> sourceType,
                   Type<D> destinationClass)

Description copied from interface: MapperFacade

Create and return a new instance of type D mapped with the properties of sourceObject.

Specified by:

map in interface MapperFacade

Parameters:

sourceObject - the object to map from

sourceType - the type of the source object

destinationClass - the type of the new object to return

Returns:

a new instance of type D mapped with the properties of sourceObject

getClass

protected Class<?> getClass(Object object)

Get the class for the specified object, accounting for unwrapping

Parameters:

object -

Returns:

the unwrapped class for the specified target object

resolveMappingStrategy

public <S,D> MappingStrategy resolveMappingStrategy(S sourceObject,
                                                    Type initialSourceType,
                                                    Type initialDestinationType,
                                                    boolean mapInPlace,
                                                    MappingContext context)

Resolves a reusable MappingStrategy for the given set of inputs.

Specified by:

resolveMappingStrategy in interface MapperFacade

Parameters:

sourceObject -

context -

initialSourceType - the source type to map

initialDestinationType - the destination type

mapInPlace - whether the strategy should map objects in-place

Returns:

a MappingStrategy suitable to map the source and destination object

map

public <S,D> D map(S sourceObject,
                   Type<S> sourceType,
                   Type<D> destinationType,
                   MappingContext context)

Description copied from interface: MapperFacade

Create and return a new instance of type D mapped with the properties of sourceObject.

Specified by:

map in interface MapperFacade

Parameters:

sourceObject - the object to map from

sourceType - the type of the source object

destinationType - the type of the new object to return

context - the current mapping context

Returns:

a new instance of type D mapped with the properties of sourceObject

map

public <S,D> D map(S sourceObject,
                   Type<S> sourceType,
                   Type<D> destinationType,
                   MappingContext context,
                   MappingStrategy suggestedStrategy)

map

public <S,D> void map(S sourceObject,
                      D destinationObject,
                      Type<S> sourceType,
                      Type<D> destinationType,
                      MappingContext context)

Description copied from interface: MapperFacade

Maps the properties of sourceObject onto destinationObject, using sourceType and destinationType to specify the parameterized types of the source and destination object.

Specified by:

map in interface MapperFacade

Parameters:

sourceObject - the object from which to read the properties

destinationObject - the object onto which the properties should be mapped

sourceType - the parameterized type of the source object

destinationType - the parameterized type of the destination object

context - the context from the current mapping request

map

public <S,D> void map(S sourceObject,
                      D destinationObject,
                      Type<S> sourceType,
                      Type<D> destinationType)

Description copied from interface: MapperFacade

Maps the properties of sourceObject onto destinationObject, using sourceType and destinationType to specify the parameterized types of the source and destination object.

Specified by:

map in interface MapperFacade

Parameters:

sourceObject - the object from which to read the properties

destinationObject - the object onto which the properties should be mapped

sourceType - the parameterized type of the source object

destinationType - the parameterized type of the destination object

map

public <S,D> void map(S sourceObject,
                      D destinationObject,
                      MappingContext context)

Description copied from interface: MapperFacade

Maps the properties of sourceObject onto destinationObject.

Specified by:

map in interface MapperFacade

Parameters:

sourceObject - the object from which to read the properties

destinationObject - the object onto which the properties should be mapped

context - the context from the current mapping request

map

public <S,D> void map(S sourceObject,
                      D destinationObject)

Description copied from interface: MapperFacade

Maps the properties of sourceObject onto destinationObject.

Specified by:

map in interface MapperFacade

Parameters:

sourceObject - the object from which to read the properties

destinationObject - the object onto which the properties should be mapped

mapAsSet

public final <S,D> Set<D> mapAsSet(Iterable<S> source,
                                   Type<S> sourceType,
                                   Type<D> destinationType)

Description copied from interface: MapperFacade

Maps the source Iterable into a new Set parameterized by destinationType.

Specified by:

mapAsSet in interface MapperFacade

Parameters:

source - the Iterable from which to map

sourceType - the type of the source elements

destinationType - the type of the new object to return

Returns:

a new Set containing elements of type destinationType mapped from the elements of source.

mapAsSet

public final <S,D> Set<D> mapAsSet(Iterable<S> source,
                                   Type<S> sourceType,
                                   Type<D> destinationType,
                                   MappingContext context)

Description copied from interface: MapperFacade

Maps the source Iterable into a new Set parameterized by destinationType.

Specified by:

mapAsSet in interface MapperFacade

Parameters:

source - the Iterable from which to map

sourceType - the type of the source elements

destinationType - the type of the new object to return

context - the current mapping context

Returns:

a new Set containing elements of type destinationType mapped from the elements of source.

mapAsList

public final <S,D> List<D> mapAsList(Iterable<S> source,
                                     Type<S> sourceType,
                                     Type<D> destinationType)

Description copied from interface: MapperFacade

Maps the source Iterable into a new List parameterized by destinationType.

Specified by:

mapAsList in interface MapperFacade

Parameters:

source - the Iterable from which to map

sourceType - the type of the source elements

destinationType - the type of the new object to return

Returns:

a new List containing elements of type destinationType mapped from the elements of source.

mapAsList

public final <S,D> List<D> mapAsList(Iterable<S> source,
                                     Type<S> sourceType,
                                     Type<D> destinationType,
                                     MappingContext context)

Description copied from interface: MapperFacade

Maps the source Iterable into a new List parameterized by destinationType.

Specified by:

mapAsList in interface MapperFacade

Parameters:

source - the Iterable from which to map

sourceType - the type of the source elements

destinationType - the type of the new object to return

context - the current mapping context

Returns:

a new List containing elements of type destinationType mapped from the elements of source.

mapAsArray

public <S,D> D[] mapAsArray(D[] destination,
                            Iterable<S> source,
                            Type<S> sourceType,
                            Type<D> destinationType)

Description copied from interface: MapperFacade

Maps the source Array into a new List parameterized by destinationType.

Specified by:

mapAsArray in interface MapperFacade

Parameters:

destination - the destination Array which is returned

source - the Array from which to map

sourceType - the type of the source elements

destinationType - the type of the new object to return

Returns:

the destination Array mapped from the elements of source.

mapAsArray

public <S,D> D[] mapAsArray(D[] destination,
                            S[] source,
                            Type<S> sourceType,
                            Type<D> destinationType)

Description copied from interface: MapperFacade

Maps the source Array into a new List parameterized by destinationType.

Specified by:

mapAsArray in interface MapperFacade

Parameters:

destination - the destination Array which is returned

source - the Array from which to map

sourceType - the type of the source elements

destinationType - the type of the new object to return

Returns:

the destination Array mapped from the elements of source.

mapAsArray

public <S,D> D[] mapAsArray(D[] destination,
                            Iterable<S> source,
                            Type<S> sourceType,
                            Type<D> destinationType,
                            MappingContext context)

Description copied from interface: MapperFacade

Maps the source Iterable into the destination Array

Specified by:

mapAsArray in interface MapperFacade

Parameters:

destination - the destination Array which is returned

source - the Iterable from which to map

sourceType - the type of the source elements

destinationType - the type of the new object to return

context - the current mapping context

Returns:

the destination Array mapped from the elements of source.

mapAsArray

public <S,D> D[] mapAsArray(D[] destination,
                            S[] source,
                            Type<S> sourceType,
                            Type<D> destinationType,
                            MappingContext context)

Description copied from interface: MapperFacade

Maps the source Array into the destination Array

Specified by:

mapAsArray in interface MapperFacade

Parameters:

destination - the destination Array which is returned

source - the Array from which to map

sourceType - the type of the source elements

destinationType - the type of the new object to return

context - the current mapping context

Returns:

the destination Array mapped from the elements of source.

mapAsList

public <S,D> List<D> mapAsList(S[] source,
                               Type<S> sourceType,
                               Type<D> destinationType)

Description copied from interface: MapperFacade

Maps the source Array into a new List parameterized by destinationType.

Specified by:

mapAsList in interface MapperFacade

Parameters:

source - the Array from which to map

sourceType - the type of the source elements

destinationType - the type of the new object to return

Returns:

a new List containing elements of type destinationType mapped from the elements of source.

mapAsList

public <S,D> List<D> mapAsList(S[] source,
                               Type<S> sourceType,
                               Type<D> destinationType,
                               MappingContext context)

Description copied from interface: MapperFacade

Maps the source Array into a new List parameterized by destinationType.

Specified by:

mapAsList in interface MapperFacade

Parameters:

source - the Array from which to map

sourceType - the type of the source elements

destinationType - the type of the new object to return

context - the current mapping context

Returns:

a new List containing elements of type destinationType mapped from the elements of source.

mapAsSet

public <S,D> Set<D> mapAsSet(S[] source,
                             Type<S> sourceType,
                             Type<D> destinationType)

Description copied from interface: MapperFacade

Maps the source Array into a new Set parameterized by destinationType.

Specified by:

mapAsSet in interface MapperFacade

Parameters:

source - the Array from which to map

sourceType - the type of the source elements

destinationType - the type of the new object to return

Returns:

a new Set containing elements of type destinationType mapped from the elements of source.

mapAsSet

public <S,D> Set<D> mapAsSet(S[] source,
                             Type<S> sourceType,
                             Type<D> destinationType,
                             MappingContext context)

Description copied from interface: MapperFacade

Maps the source Array into a new Set parameterized by destinationType.

Specified by:

mapAsSet in interface MapperFacade

Parameters:

source - the Array from which to map

sourceType - the type of the source elements

destinationType - the type of the new object to return

context - the current mapping context

Returns:

a new Set containing elements of type destinationType mapped from the elements of source.

mapAsCollection

public <S,D> void mapAsCollection(Iterable<S> source,
                                  Collection<D> destination,
                                  Type<S> sourceType,
                                  Type<D> destinationType,
                                  MappingContext context)

Map an iterable onto an existing collection

Specified by:

mapAsCollection in interface MapperFacade

Parameters:

source - the source iterable

destination - the destination into which the results will be mapped

sourceType - the type of

destinationType -

context -

mapAsCollection

public <S,D> void mapAsCollection(S[] source,
                                  Collection<D> destination,
                                  Type<S> sourceType,
                                  Type<D> destinationType,
                                  MappingContext context)

Map an array onto an existing collection

Specified by:

mapAsCollection in interface MapperFacade

Parameters:

source -

destination -

sourceType -

destinationType -

context -

newObject

public <S,D> D newObject(S sourceObject,
                         Type<? extends D> destinationType,
                         MappingContext context)

Description copied from interface: MapperFacade

Create new instance of a destination class. Abstract types are unsupported.

Specified by:

newObject in interface MapperFacade

Parameters:

sourceObject - the source objet

destinationType - the type of the destination

context - the current mapping context

Returns:

new instance of destinationClass

convert

public <S,D> D convert(S source,
                       Type<S> sourceType,
                       Type<D> destinationType,
                       String converterId,
                       MappingContext context)

Description copied from interface: MapperFacade

Convert the source object into the appropriate destination type

Specified by:

convert in interface MapperFacade

Parameters:

source - the source object to map

sourceType - the type of the source object

destinationType - the type of the destination object to produce

converterId - the specific converter to use; if null, the first compatible global converter is used

Returns:

an instance of the converted destination type

map

public <S,D> D map(S sourceObject,
                   Class<D> destinationClass)

Description copied from interface: MapperFacade

Create and return a new instance of type D mapped with the properties of sourceObject.

Specified by:

map in interface MapperFacade

Parameters:

sourceObject - the object to map from

destinationClass - the type of the new object to return

Returns:

a new instance of type D mapped with the properties of sourceObject

map

public <S,D> D map(S sourceObject,
                   Class<D> destinationClass,
                   MappingContext context)

Description copied from interface: MapperFacade

Create and return a new instance of type D mapped with the properties of sourceObject.

Specified by:

map in interface MapperFacade

Parameters:

sourceObject - the object to map from

destinationClass - the type of the new object to return

context - the context from the current mapping request

Returns:

a new instance of type D mapped with the properties of sourceObject

mapAsSet

public <S,D> Set<D> mapAsSet(Iterable<S> source,
                             Class<D> destinationClass)

Description copied from interface: MapperFacade

Maps the source iterable into a new Set parameterized by destinationClass.

Specified by:

mapAsSet in interface MapperFacade

Parameters:

source - the Iterable from which to map

destinationClass - the type of elements to be contained in the returned Set.

Returns:

a new Set containing elements of type destinationClass mapped from the elements of source.

mapAsSet

public <S,D> Set<D> mapAsSet(Iterable<S> source,
                             Class<D> destinationClass,
                             MappingContext context)

Description copied from interface: MapperFacade

Maps the source iterable into a new Set parameterized by destinationClass.

Specified by:

mapAsSet in interface MapperFacade

Parameters:

source - the Iterable from which to map

destinationClass - the type of elements to be contained in the returned Set.

context - the context from the current mapping request

Returns:

a new Set containing elements of type destinationClass mapped from the elements of source.

mapAsSet

public <S,D> Set<D> mapAsSet(S[] source,
                             Class<D> destinationClass)

Description copied from interface: MapperFacade

Maps the source Array into a new Set parameterized by destinationClass.

Specified by:

mapAsSet in interface MapperFacade

Parameters:

source - the Array from which to map

destinationClass - the type of elements to be contained in the returned Set.

Returns:

a new Set containing elements of type destinationClass mapped from the elements of source.

mapAsSet

public <S,D> Set<D> mapAsSet(S[] source,
                             Class<D> destinationClass,
                             MappingContext context)

Description copied from interface: MapperFacade

Maps the source Array into a new Set parameterized by destinationClass.

Specified by:

mapAsSet in interface MapperFacade

Parameters:

source - the Array from which to map

destinationClass - the type of elements to be contained in the returned Set.

context - the context from the current mapping request

Returns:

a new Set containing elements of type destinationClass mapped from the elements of source.

mapAsList

public <S,D> List<D> mapAsList(Iterable<S> source,
                               Class<D> destinationClass)

Description copied from interface: MapperFacade

Maps the source Iterable into a new List parameterized by destinationClass.

Specified by:

mapAsList in interface MapperFacade

Parameters:

source - the Iterable from which to map

destinationClass - the type of elements to be contained in the returned Set.

Returns:

a new List containing elements of type destinationClass mapped from the elements of source.

mapAsList

public <S,D> List<D> mapAsList(Iterable<S> source,
                               Class<D> destinationClass,
                               MappingContext context)

Description copied from interface: MapperFacade

Maps the source Iterable into a new List parameterized by destinationClass.

Specified by:

mapAsList in interface MapperFacade

Parameters:

source - the Iterable from which to map

destinationClass - the type of elements to be contained in the returned Set.

context - the context from the current mapping request

Returns:

a new List containing elements of type destinationClass mapped from the elements of source.

mapAsList

public <S,D> List<D> mapAsList(S[] source,
                               Class<D> destinationClass)

Description copied from interface: MapperFacade

Maps the source Array into a new List parameterized by destinationClass.

Specified by:

mapAsList in interface MapperFacade

Parameters:

source - the Array from which to map

destinationClass - the type of elements to be contained in the returned Set.

Returns:

a new List containing elements of type destinationClass mapped from the elements of source.

mapAsList

public <S,D> List<D> mapAsList(S[] source,
                               Class<D> destinationClass,
                               MappingContext context)

Description copied from interface: MapperFacade

Maps the source Array into a new List parameterized by destinationClass.

Specified by:

mapAsList in interface MapperFacade

Parameters:

source - the Array from which to map

destinationClass - the type of elements to be contained in the returned Set.

context - the context from the current mapping request

Returns:

a new List containing elements of type destinationClass mapped from the elements of source.

mapAsArray

public <S,D> D[] mapAsArray(D[] destination,
                            Iterable<S> source,
                            Class<D> destinationClass)

Description copied from interface: MapperFacade

Maps the source interable into a new Array of typeD.

Specified by:

mapAsArray in interface MapperFacade

source - the Array from which to map

destinationClass - the type of elements to be contained in the returned Set.

Returns:

a new Array containing elements of type destinationClass mapped from the elements of source.

mapAsArray

public <S,D> D[] mapAsArray(D[] destination,
                            S[] source,
                            Class<D> destinationClass)

Description copied from interface: MapperFacade

Maps the source array into a new Array of typeD.

Specified by:

mapAsArray in interface MapperFacade

Parameters:

destination - the destination array which is also returned

source - the source array

destinationClass - the destination class

Returns:

a new Array containing elements of type destinationClass mapped from the elements of source.

mapAsArray

public <S,D> D[] mapAsArray(D[] destination,
                            Iterable<S> source,
                            Class<D> destinationClass,
                            MappingContext context)

Description copied from interface: MapperFacade

Maps the source Iterable into a new Array of typeD.

Specified by:

mapAsArray in interface MapperFacade

Parameters:

destination - the destination array which is also returned

source - the source Iterable

destinationClass - the destination class

context - the current MappingContext

Returns:

a new Array containing elements of type destinationClass mapped from the elements of source.

mapAsArray

public <S,D> D[] mapAsArray(D[] destination,
                            S[] source,
                            Class<D> destinationClass,
                            MappingContext context)

Description copied from interface: MapperFacade

Maps the source Array into a new Array of typeD.

Specified by:

mapAsArray in interface MapperFacade

Parameters:

destination - the destination array which is also returned

source - the source Array

destinationClass - the destination class

context - the current MappingContext

Returns:

a new Array containing elements of type destinationClass mapped from the elements of source.

convert

public <S,D> D convert(S source,
                       Class<D> destinationClass,
                       String converterId,
                       MappingContext context)

Description copied from interface: MapperFacade

Convert the source object into the appropriate destination type

Specified by:

convert in interface MapperFacade

Parameters:

source - the source object to map

destinationClass - the type of the destination class to produce

converterId - the specific converter to use; if null, the first compatible global converter is used

Returns:

an instance of the converted destination type

mapAsMap

public <Sk,Sv,Dk,Dv> Map<Dk,Dv> mapAsMap(Map<Sk,Sv> source,
                                         Type<? extends Map<Sk,Sv>> sourceType,
                                         Type<? extends Map<Dk,Dv>> destinationType)

Description copied from interface: MapperFacade

Map from one instance of java.util.Map to another.

Specified by:

mapAsMap in interface MapperFacade

Parameters:

source - the source Map

sourceType - the parameterized type of the source Map object

destinationType - the parameterized type of the destination Map object

Returns:

a new Map instance, with key and value types as defined by destinationType

mapAsMap

public <Sk,Sv,Dk,Dv> Map<Dk,Dv> mapAsMap(Map<Sk,Sv> source,
                                         Type<? extends Map<Sk,Sv>> sourceType,
                                         Type<? extends Map<Dk,Dv>> destinationType,
                                         MappingContext context)

Description copied from interface: MapperFacade

Map from one instance of java.util.Map to another.

Specified by:

mapAsMap in interface MapperFacade

context - context the context from the current mapping request

Returns:

a new Map instance, with key and value types as defined by destinationType

mapAsMap

public <S,Dk,Dv> Map<Dk,Dv> mapAsMap(Iterable<S> source,
                                     Type<S> sourceType,
                                     Type<? extends Map<Dk,Dv>> destinationType)

Description copied from interface: MapperFacade

Map from an Iterable to an instance of java.util.Map.

Specified by:

mapAsMap in interface MapperFacade

Parameters:

source - the source Map

sourceType - the parameterized type of the source Map object

destinationType - the parameterized type of the destination Map object

Returns:

a new Map instance, with key and value types as defined by destinationType

mapAsMap

public <S,Dk,Dv> Map<Dk,Dv> mapAsMap(Iterable<S> source,
                                     Type<S> sourceType,
                                     Type<? extends Map<Dk,Dv>> destinationType,
                                     MappingContext context)

Description copied from interface: MapperFacade

Map from an Iterable to an instance of java.util.Map.

Specified by:

mapAsMap in interface MapperFacade

Parameters:

source - the source Map

sourceType - the parameterized type of the source Map object

destinationType - the parameterized type of the destination Map object

context - the current mapping context

Returns:

a new Map instance, with key and value types as defined by destinationType

mapAsMap

public <S,Dk,Dv> Map<Dk,Dv> mapAsMap(S[] source,
                                     Type<S> sourceType,
                                     Type<? extends Map<Dk,Dv>> destinationType)

Description copied from interface: MapperFacade

Map from an Array to an instance of java.util.Map.

Specified by:

mapAsMap in interface MapperFacade

Parameters:

source - the source Array

sourceType - the parameterized type of the source Map object

destinationType - the parameterized type of the destination Map object

Returns:

a new Map instance, with key and value types as defined by destinationType

mapAsMap

public <S,Dk,Dv> Map<Dk,Dv> mapAsMap(S[] source,
                                     Type<S> sourceType,
                                     Type<? extends Map<Dk,Dv>> destinationType,
                                     MappingContext context)

Description copied from interface: MapperFacade

Map from an Array to an instance of java.util.Map.

Specified by:

mapAsMap in interface MapperFacade

Parameters:

source - the source Array

sourceType - the parameterized type of the source Array element

destinationType - the parameterized type of the destination Map object

context - the current mapping context

Returns:

a new Map instance, with key and value types as defined by destinationType

mapAsList

public <Sk,Sv,D> List<D> mapAsList(Map<Sk,Sv> source,
                                   Type<? extends Map<Sk,Sv>> sourceType,
                                   Type<D> destinationType)

Description copied from interface: MapperFacade

Map from a java.util.Map to a List

Specified by:

mapAsList in interface MapperFacade

Parameters:

source - the source Map

sourceType - the parameterized type of the source Map object

destinationType - the parameterized type of the destination List elements

Returns:

a new List instance, with element types as defined by destinationType

mapAsList

public <Sk,Sv,D> List<D> mapAsList(Map<Sk,Sv> source,
                                   Type<? extends Map<Sk,Sv>> sourceType,
                                   Type<D> destinationType,
                                   MappingContext context)

Description copied from interface: MapperFacade

Map from a java.util.Map to a List

Specified by:

mapAsList in interface MapperFacade

Parameters:

source - the source Map

sourceType - the parameterized type of the source Map object

destinationType - the parameterized type of the destination List elements

context - the current mapping context

Returns:

a new List instance, with element types as defined by destinationType

mapAsSet

public <Sk,Sv,D> Set<D> mapAsSet(Map<Sk,Sv> source,
                                 Type<? extends Map<Sk,Sv>> sourceType,
                                 Type<D> destinationType)

Description copied from interface: MapperFacade

Map from a java.util.Map to a Set

Specified by:

mapAsSet in interface MapperFacade

Parameters:

source - the source Map

sourceType - the parameterized type of the source Map object

destinationType - the parameterized type of the destination Set elements

Returns:

a new Set instance, with element types defined by destinationType

mapAsSet

public <Sk,Sv,D> Set<D> mapAsSet(Map<Sk,Sv> source,
                                 Type<? extends Map<Sk,Sv>> sourceType,
                                 Type<D> destinationType,
                                 MappingContext context)

Description copied from interface: MapperFacade

Map from a java.util.Map to a Set

Specified by:

mapAsSet in interface MapperFacade

Parameters:

source - the source Map

sourceType - the parameterized type of the source Map object

destinationType - the parameterized type of the destination Set elements

context - the current mapping context

Returns:

a new Map instance, with element types as defined by destinationType

mapAsArray

public <Sk,Sv,D> D[] mapAsArray(D[] destination,
                                Map<Sk,Sv> source,
                                Type<? extends Map<Sk,Sv>> sourceType,
                                Type<D> destinationType)

Description copied from interface: MapperFacade

Map from a java.util.Map to a Set

Specified by:

mapAsArray in interface MapperFacade

Parameters:

destination - the destination Array which is also returned

source - the source Map

sourceType - the parameterized type of the source Map object

destinationType - the parameterized type of the destination Array elements

Returns:

the destination Array

mapAsArray

public <Sk,Sv,D> D[] mapAsArray(D[] destination,
                                Map<Sk,Sv> source,
                                Type<? extends Map<Sk,Sv>> sourceType,
                                Type<D> destinationType,
                                MappingContext context)

Description copied from interface: MapperFacade

Map from a java.util.Map to a Set

Specified by:

mapAsArray in interface MapperFacade

Parameters:

destination - the destination Array which is also returned

source - the source Map

sourceType - the parameterized type of the source Map object

destinationType - the parameterized type of the destination Array elements

context - the current mapping context

Returns:

the destination Array

mapAsCollection

public <S,D> void mapAsCollection(Iterable<S> source,
                                  Collection<D> destination,
                                  Class<D> destinationClass)

Description copied from interface: MapperFacade

Maps the source Iterable into the destination Collection

Specified by:

mapAsCollection in interface MapperFacade

Parameters:

source - the source Iterable

destination - the destination Collection

destinationClass - the destination class

mapAsCollection

public <S,D> void mapAsCollection(Iterable<S> source,
                                  Collection<D> destination,
                                  Class<D> destinationClass,
                                  MappingContext context)

Description copied from interface: MapperFacade

Map an iterable onto an existing collection

Specified by:

mapAsCollection in interface MapperFacade

Parameters:

source - the source iterable

destination - the destination collection

destinationClass - the type of elements in the destination

context - the current mapping context

mapAsCollection

public <S,D> void mapAsCollection(S[] source,
                                  Collection<D> destination,
                                  Class<D> destinationClass)

Description copied from interface: MapperFacade

Map an array onto an existing collection

Specified by:

mapAsCollection in interface MapperFacade

Parameters:

source - the source array

destination - the destination collection

destinationClass - the type of elements in the destination

mapAsCollection

public <S,D> void mapAsCollection(S[] source,
                                  Collection<D> destination,
                                  Class<D> destinationClass,
                                  MappingContext context)

Description copied from interface: MapperFacade

Map an array onto an existing collection

Specified by:

mapAsCollection in interface MapperFacade

Parameters:

source - the source array

destination - the destination collection

destinationClass - the type of elements in the destination

context - the current mapping context

mapAsCollection

public <S,D> void mapAsCollection(Iterable<S> source,
                                  Collection<D> destination,
                                  Type<S> sourceType,
                                  Type<D> destinationType)

Description copied from interface: MapperFacade

Map an iterable onto an existing collection

Specified by:

mapAsCollection in interface MapperFacade

Parameters:

source - the source iterable

destination - the destination collection

sourceType - the type of elements in the source

destinationType - the type of elements in the destination

mapAsCollection

public <S,D> void mapAsCollection(S[] source,
                                  Collection<D> destination,
                                  Type<S> sourceType,
                                  Type<D> destinationType)

Description copied from interface: MapperFacade

Map an array onto an existing collection

Specified by:

mapAsCollection in interface MapperFacade

Parameters:

source - the source array

destination - the destination collection

sourceType - the type of elements in the source

destinationType - the type of elements in the destination

factoryModified

public void factoryModified(MapperFactory factory)

Description copied from interface: MapperFacade

Notifies the MapperFacade that a MapperFactory associated with it has been modified.

Specified by:

factoryModified in interface MapperFacade

reportCurrentState

public void reportCurrentState(StringBuilder out)

Prints the current state of this MapperFacade to the supplied StringBuilder instance.

Specified by:

reportCurrentState in interface StateReporter.Reportable

Parameters:

out -