osgi.enroute.dto.api

Interface DTOs.Converter

Enclosing interface:

DTOs

public static interface DTOs.Converter

Converts an object to another type

Method Summary

Modifier and Type	Method and Description
<T> T	to(java.lang.Class<T> dest) Convert an object source to the type given in dest.
java.lang.Object	to(java.lang.reflect.Type dest) Convert an object to the given type.
<T> T	to(TypeReference<T> dest) Convert an object to the given type reference.

Method Detail

to

<T> T to(java.lang.Class<T> dest)
  throws java.lang.Exception

Convert an object source to the type given in dest. If the conversion cannot be done, return null. If the destination type is an interface then an attempt is made to detect an implementation class. This works well for all the collection interfaces.

The conversion uses the type information and any generic information to do a proper conversion. I.e. a List<Integer> can be converted to a String[] and vice versa. It also recognizes DTOs and allows them to be converted to maps and vice versa. Maps can also be converted to interfaces, the names of the methods then act as keys in the map. Same conventions for name mangling are used as the DS configuration properties

Parameters:

dest - The destination type.

Returns:

a converted object implementing/extending T

Throws:

java.lang.Exception

to

<T> T to(TypeReference<T> dest)
  throws java.lang.Exception

Convert an object to the given type reference.

Parameters:

dest - the destination type specification

Returns:

the converted object or null if no conversion could be found.

Throws:

java.lang.Exception

to

java.lang.Object to(java.lang.reflect.Type dest)
             throws java.lang.Exception

Convert an object to the given type. This type can be any of the given implementers of type, like ParameterizedType, etc. The converter must be able to follow these generic chains.

Parameters:

dest - the destination type

Returns:

the converted object or null if no conversion could be found.

Throws:

java.lang.Exception