ma.glasnost.orika

Interface MapperFacade

All Known Implementing Classes:

ConfigurableMapper, MapperFacadeImpl

public interface MapperFacade

The main runtime interface between a Java application and Orika. This is the central interface abstracting the service of a Java bean mapping.

The main operation of MapperFacade is map() that copy from a deeply structured one object to an other.

MapperFacade manages the state of a mapping operation through MappingContext.
The operation of mapping may include :

• Creation of new objects : newObject()
• Conversion object to another type: convert()
• Mapping recursively an object to an other class : map()

Example of code to map an instance of Entity(entity ) to DTO class:

 ...
 DTO newDTO = mapperFacade.map(entity, DTO.class);
 ...
 

Author:

S.M. El Aatifi

Method Summary

Modifier and Type	Method and Description
<S,D> D	convert(S source, Class<D> destinationClass, String converterId, MappingContext mappingContext) Convert the source object into the appropriate destination type
<S,D> D	convert(S source, Type<S> sourceType, Type<D> destinationType, String converterId, MappingContext mappingContext) 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.
<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> destinationType) 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[]	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 source, Type<? extends D> destinationType, MappingContext context) Create new instance of a destination class.
<S,D> MappingStrategy	resolveMappingStrategy(S sourceObject, Type sourceType, Type destinationType, boolean mapInPlace, MappingContext context)

Method Detail

map

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

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

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

<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.

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

map

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

Maps the properties of sourceObject onto destinationObject.

Parameters:

sourceObject - the object from which to read the properties

destinationObject - the object onto which the properties should be mapped

map

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

Maps the properties of sourceObject onto destinationObject.

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

<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.

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

<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.

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

mapAsSet

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Maps the source interable into a new Array of typeD.

Parameters:

destination -

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 Array containing elements of type destinationClass mapped from the elements of source.

mapAsArray

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

Maps the source array into a new Array of typeD.

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

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

Maps the source Iterable into a new Array of typeD.

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

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

Maps the source Array into a new Array of typeD.

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.

mapAsCollection

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

Maps the source Iterable into the destination Collection

Parameters:

source - the source Iterable

destination - the destination Collection

destinationClass - the destination class

mapAsCollection

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

Map an iterable onto an existing collection

Parameters:

source - the source iterable

destination - the destination collection

destinationClass - the type of elements in the destination

context - the current mapping context

mapAsCollection

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

Map an array onto an existing collection

Parameters:

source - the source array

destination - the destination collection

destinationClass - the type of elements in the destination

mapAsCollection

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

Map an array onto an existing collection

Parameters:

source - the source array

destination - the destination collection

destinationClass - the type of elements in the destination

context - the current mapping context

map

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

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

Parameters:

sourceObject - the object to map from

sourceType - the type of the source object

destinationType - the type of the new object to return

Returns:

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

map

<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.

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

mapAsSet

<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.

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

<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.

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.

mapAsSet

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

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

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

<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.

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.

mapAsList

<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.

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.

mapAsList

<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.

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.

mapAsList

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

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

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

<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.

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.

mapAsArray

<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.

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

<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.

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.

mapAsArray

<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

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

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

Maps the source Array into the destination Array

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.

mapAsCollection

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

Map an iterable onto an existing collection

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

<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

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

context - the current mapping context

mapAsCollection

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

Map an array onto an existing collection

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

mapAsCollection

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

Map an array onto an existing collection

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

context - the current mapping context

convert

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

Convert the source object into the appropriate destination type

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

convert

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

Convert the source object into the appropriate destination type

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

mapAsMap

<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.

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

<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.

Parameters:

source -

sourceType -

destinationType -

context - context the context from the current mapping request

Returns:

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

mapAsMap

<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.

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

<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.

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

<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.

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

<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.

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

<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

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

<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

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

<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

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

<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

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

<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

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

<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

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

newObject

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

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

Parameters:

source - the source objet

destinationType - the type of the destination

context - the current mapping context

Returns:

new instance of destinationClass

resolveMappingStrategy

<S,D> MappingStrategy resolveMappingStrategy(S sourceObject,
                                             Type sourceType,
                                             Type destinationType,
                                             boolean mapInPlace,
                                             MappingContext context)

Parameters:

sourceObject - the source object being mapped

sourceType - the source type to map

destinationType - the destination type

mapInPlace - whether the strategy should map objects in-place

context - the current MappingContext

Returns:

a MappingStrategy appropriate for mapping between the provided types

factoryModified

void factoryModified(MapperFactory factory)

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