org.springframework.core.convert.converter

Interface ConverterRegistry

All Known Subinterfaces:

ConfigurableConversionService, FormatterRegistry

All Known Implementing Classes:

DefaultConversionService, DefaultFormattingConversionService, FormattingConversionService, GenericConversionService

public interface ConverterRegistry

For registering converters with a type conversion system.

Since:

3.0

Author:

Keith Donald, Juergen Hoeller

Method Summary

Methods

Modifier and Type	Method and Description
void	addConverter(Class<?> sourceType, Class<?> targetType, Converter<?,?> converter) Add a plain converter to this registry.
void	addConverter(Converter<?,?> converter) Add a plain converter to this registry.
void	addConverter(GenericConverter converter) Add a generic converter to this registry.
void	addConverterFactory(ConverterFactory<?,?> converterFactory) Add a ranged converter factory to this registry.
void	removeConvertible(Class<?> sourceType, Class<?> targetType) Remove any converters from sourceType to targetType.

Method Detail

addConverter

void addConverter(Converter<?,?> converter)

Add a plain converter to this registry. The convertible sourceType/targetType pair is derived from the Converter's parameterized types.

Throws:

IllegalArgumentException - if the parameterized types could not be resolved

addConverter

void addConverter(Class<?> sourceType,
                Class<?> targetType,
                Converter<?,?> converter)

Add a plain converter to this registry. The convertible sourceType/targetType pair is specified explicitly. Allows for a Converter to be reused for multiple distinct pairs without having to create a Converter class for each pair.

Since:

3.1

addConverter

void addConverter(GenericConverter converter)

Add a generic converter to this registry.

addConverterFactory

void addConverterFactory(ConverterFactory<?,?> converterFactory)

Add a ranged converter factory to this registry. The convertible sourceType/rangeType pair is derived from the ConverterFactory's parameterized types.

Throws:

IllegalArgumentException - if the parameterized types could not be resolved.

removeConvertible

void removeConvertible(Class<?> sourceType,
                     Class<?> targetType)

Remove any converters from sourceType to targetType.

Parameters:

sourceType - the source type

targetType - the target type