org.deephacks.confit.spi

Class Conversion

java.lang.Object

org.deephacks.confit.spi.Conversion

public final class Conversion
extends Object

Conversion is responsible for converting values using registered converters. Inspiration from http://www.springsource.org

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Conversion.ConversionException
static interface	Conversion.Converter<V,T> Converts a object of type V to a object of type T.
static class	Conversion.UniqueId

Method Summary

Methods

Modifier and Type	Method and Description
<T,V> Collection<T>	convert(Collection<V> values, Class<T> clazz)
<T,V> Map<V,T>	convert(Map<V,Object> values, Class<T> clazz)
<T> T	convert(Object source, Class<T> targetclass) Convert a value to a specific class.
<T,V> Set<T>	convert(Set<V> values, Class<T> clazz)
static Conversion	get()
static List<Class<?>>	getParameterizedType(Class<?> ownerClass, Class<?> genericSuperClass) Returns the parameterized type of a class, if exists.
<T,V> void	register(Conversion.Converter converter)

Methods inherited from class java.lang.Object

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

Method Detail

get

public static Conversion get()

convert

public <T> T convert(Object source,
            Class<T> targetclass)

Convert a value to a specific class. The algorithm for finding a suitable converter is as follows: Find converters that is able to convert both source and target; a exact or superclass match. Pick the converter that have the best target match, if both are equal, pick the one with best source match. That is, the converter that is most specialized in converting a value to a specific target class will be prioritized, as long as it recognizes the source value.

Parameters:

source - value to convert.

targetclass - class to convert to.

Returns:

converted value

convert

public <T,V> Set<T> convert(Set<V> values,
                   Class<T> clazz)

convert

public <T,V> Collection<T> convert(Collection<V> values,
                          Class<T> clazz)

convert

public <T,V> Map<V,T> convert(Map<V,Object> values,
                     Class<T> clazz)

register

public <T,V> void register(Conversion.Converter converter)

getParameterizedType

public static List<Class<?>> getParameterizedType(Class<?> ownerClass,
                                  Class<?> genericSuperClass)

Returns the parameterized type of a class, if exists. Wild cards, type variables and raw types will be returned as an empty list.

If a field is of type Set then java.lang.String is returned.

If a field is of type Map then [java.lang.String, java.lang.Integer] is returned.

Parameters:

ownerClass - the implementing target class to check against

genericSuperClass - the generic interface to resolve the type argument from

Returns:

A list of classes of the parameterized type.