org.jeesy.classinfo.converter

Class ConverterManager

java.lang.Object

org.jeesy.classinfo.converter.impl.ChainableConversionService

org.jeesy.classinfo.converter.ConverterManager

All Implemented Interfaces:

ConversionService, Converter<Object,Object>, ConverterRegistry, StringConverter

Direct Known Subclasses:

DefaultConverter

public class ConverterManager
extends ChainableConversionService
implements ConverterRegistry, Converter<Object,Object>, ConversionService, StringConverter

Storage of from/to string conversion setup Can be created for particular area of functionality to convert from/to string on demand. Briefly it have mapping expectedType->converter instance and single fallback converter. Client requests converter by src and dst types via converterFor(Class, Class) and if no such converter registered fallback will be returned. DefaultConverter is the default fallback.

Author:

Artem Mironov

Field Summary

Fields inherited from class org.jeesy.classinfo.converter.impl.ChainableConversionService

fallback

Constructor Summary

Constructors

Constructor and Description
ConverterManager()
ConverterManager(ConversionService fallback)

Method Summary

Methods

Modifier and Type	Method and Description
<I,O> O	convert(I src, Class<O> dstType)
Object	convert(Object src, TypeInfo<Object> srcType, TypeInfo<Object> dstType) Converter from SrcType to DstType.
<I,O,T extends Converter<I,O>> T	converterByType(Class<T> converterClass) Get converter instance by converter class.
<SrcType,DstType> Converter<SrcType,DstType>	converterFor(Class<SrcType> srcType, Class<DstType> dstType) Lookup exact converter for the specified raw types.
<I,O> O	convertType(I src, TypeInfo<I> srcType, TypeInfo<O> dstType) Convert source value of specified type to value of destination type
<T> T	fromString(TypeInfo<T> type, String value) Create new instance of expected type from string value
<SrcType,DstType> void	register(Class<SrcType> srcType, Class<DstType> dstType, Converter<SrcType,DstType> converter)
<SrcType,DstType> void	register(Class<SrcType> srcType, Class<DstType> dstType, TwoWayConverter<SrcType,DstType> converter)
<SrcType,DstType> void	register(Converter<SrcType,DstType> converter)
<T> String	toString(TypeInfo<T> type, T value) Convert object to string.

Methods inherited from class org.jeesy.classinfo.converter.impl.ChainableConversionService

getFallback

Methods inherited from class java.lang.Object

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

Constructor Detail

ConverterManager

public ConverterManager()

ConverterManager

public ConverterManager(ConversionService fallback)

Method Detail

converterFor

public <SrcType,DstType> Converter<SrcType,DstType> converterFor(Class<SrcType> srcType,
                                                        Class<DstType> dstType)

Description copied from interface: ConversionService

Lookup exact converter for the specified raw types.

Specified by:

converterFor in interface ConversionService

Parameters:

srcType - source type

dstType - destination type

Returns:

converter what can converter values of source type to destination type

register

public <SrcType,DstType> void register(Class<SrcType> srcType,
                              Class<DstType> dstType,
                              Converter<SrcType,DstType> converter)

Specified by:

register in interface ConverterRegistry

register

public <SrcType,DstType> void register(Class<SrcType> srcType,
                              Class<DstType> dstType,
                              TwoWayConverter<SrcType,DstType> converter)

Specified by:

register in interface ConverterRegistry

register

public <SrcType,DstType> void register(Converter<SrcType,DstType> converter)

Specified by:

register in interface ConverterRegistry

convert

public <I,O> O convert(I src,
              Class<O> dstType)
          throws ConversionException

Throws:

ConversionException

convertType

public <I,O> O convertType(I src,
                  TypeInfo<I> srcType,
                  TypeInfo<O> dstType)
              throws ConversionException

Description copied from interface: ConversionService

Convert source value of specified type to value of destination type

Specified by:

convertType in interface ConversionService

Parameters:

src - source value

srcType - extended source type

dstType - destination type

Returns:

converted value of type which can be assigned to dstType

Throws:

ConversionException

convert

public Object convert(Object src,
             TypeInfo<Object> srcType,
             TypeInfo<Object> dstType)
               throws ConversionException

Description copied from interface: Converter

Converter from SrcType to DstType. Implementation should assume following: * SrcType is assignable from srcType.getRaw() * DstType is assignable from destType.getRaw() * src.getClass().isAssignableFrom(srcType) == true * DstType class is assignable from returned object

Specified by:

convert in interface Converter<Object,Object>

Parameters:

src - source object

srcType - source object type info

dstType - destination object type info

Returns:

destination object

Throws:

ConversionException

converterByType

public <I,O,T extends Converter<I,O>> T converterByType(Class<T> converterClass)

Get converter instance by converter class. Uses new instance with default constructor.

Specified by:

converterByType in interface ConversionService

Type Parameters:

T - generic converter target type

I - type of the source what converter supports

Parameters:

converterClass - Converter class to instantiate

Returns:

new or cached converter instance

fromString

public <T> T fromString(TypeInfo<T> type,
               String value)
             throws ConversionException

Description copied from interface: StringConverter

Create new instance of expected type from string value

Specified by:

fromString in interface StringConverter

Parameters:

type - Expected target type

value - String value to convert

Returns:

instance of expected type or child

Throws:

ConversionException - if something goes wrong

toString

public <T> String toString(TypeInfo<T> type,
                  T value)
                throws ConversionException

Description copied from interface: StringConverter

Convert object to string. It's desirable what result can be parsed back and obj.equals(fromString(*,ojb.getClass(),toString(*,obj))) == true

Specified by:

toString in interface StringConverter

Parameters:

type - type info of value

value - Object to convert @return string

Throws:

ConversionException - if something goes wrong