org.jeneva.impl

Class Mapper

java.lang.Object

org.jeneva.impl.Mapper

All Implemented Interfaces:

IMapper

public class Mapper
extends java.lang.Object
implements IMapper

Represents Mapping and Filtering helper class

Constructor Summary

Constructors

Constructor and Description
Mapper(IJenevaContext context) Initializes new instance of the Mapper class

Method Summary

Methods

Modifier and Type	Method and Description
<T extends Dtobase> T	filter(T item, java.lang.Class<?> type, byte level) Recursively goes through fields of the item object and copies selectively field values to the returned object.
<T extends Dtobase> java.util.List<T>	filterList(java.lang.Iterable<T> items, java.lang.Class<?> type, byte level) Recursively goes through fields of each object in collection and copies selectively field values to the returned object.
<T extends Dtobase> void	map(T source, java.lang.Class<?> type) Recursively goes through the source object's fields and assigns back-reference if needed.
<T extends Dtobase> void	mapCollection(java.lang.Iterable<T> source, java.lang.Class<?> type) Recursively goes through the source object's collection fields and assigns back-reference if needed.
<T extends Dtobase> void	mapTo(T source, T dest, java.lang.Class<?> type) Recursively copies fields from source object to the dest object according to Jeneva rules Only assigned fields are copied.
<T extends Dtobase> void	mapToCollection(java.util.Collection<T> source, java.util.Collection<T> dest, java.lang.Class<?> type, T parent) Recursively copies objects' fields from source collection to the dest collection according to Jeneva rules.

Methods inherited from class java.lang.Object

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

Constructor Detail

Mapper

public Mapper(IJenevaContext context)

Initializes new instance of the Mapper class

Parameters:

context - Jeneva context

Method Detail

mapTo

public <T extends Dtobase> void mapTo(T source,
                             T dest,
                             java.lang.Class<?> type)

Recursively copies fields from source object to the dest object according to Jeneva rules Only assigned fields are copied. This method is used for Updates and Merges

Specified by:

mapTo in interface IMapper

Parameters:

source - source domain/DTO object

dest - destination domain/DTO object

type - domain/DTO type

mapToCollection

public <T extends Dtobase> void mapToCollection(java.util.Collection<T> source,
                                       java.util.Collection<T> dest,
                                       java.lang.Class<?> type,
                                       T parent)

Recursively copies objects' fields from source collection to the dest collection according to Jeneva rules. This method is smart enough to correlate objects to objects based on the overridden equals() method. Only assigned fields are copied. This method is used for Updates and Merges

Specified by:

mapToCollection in interface IMapper

Parameters:

source - source domain/DTO object collection

dest - destination domain/DTO object collection

type - domain/DTO object type

parent - parent domain/DTO object

mapCollection

public <T extends Dtobase> void mapCollection(java.lang.Iterable<T> source,
                                     java.lang.Class<?> type)

Recursively goes through the source object's collection fields and assigns back-reference if needed. This method relies on the IChild interface implemented by domain classes. This method is used for Inserts

Specified by:

mapCollection in interface IMapper

Parameters:

source - source domain/DTO object collection

type - source domain/DTO object type

map

public <T extends Dtobase> void map(T source,
                           java.lang.Class<?> type)

Recursively goes through the source object's fields and assigns back-reference if needed. This method relies on the IChild interface implemented by domain classes. This method is used for Inserts

Specified by:

map in interface IMapper

Parameters:

source - source domain/DTO object

type - source domain/DTO object type

filterList

public <T extends Dtobase> java.util.List<T> filterList(java.lang.Iterable<T> items,
                                               java.lang.Class<?> type,
                                               byte level)

Recursively goes through fields of each object in collection and copies selectively field values to the returned object. Not all field values are copied. The selection is based on the @Dto annotation value and nestedValue fields, and the level parameter.

Specified by:

filterList in interface IMapper

Parameters:

items - collection of domain/DTO objects

type - domain/DTO object type

level - required serialization level

Returns:

mapped list

filter

public <T extends Dtobase> T filter(T item,
                           java.lang.Class<?> type,
                           byte level)

Recursively goes through fields of the item object and copies selectively field values to the returned object. Not all field values are copied. The selection is based on the @Dto annotation value and nestedValue fields, and the level parameter.

Specified by:

filter in interface IMapper

Parameters:

item - domain/DTO object

type - domain/DTO object type

level - required serialization level

Returns:

mapped object