Class DefaultConversionService
- java.lang.Object
- org.springframework.core.convert.support.GenericConversionService
- org.springframework.core.convert.support.DefaultConversionService
- All Implemented Interfaces:
ConversionService,ConverterRegistry,ConfigurableConversionService
public class DefaultConversionService extends GenericConversionService
A specialization ofGenericConversionServiceconfigured by default with converters appropriate for most environments.Designed for direct instantiation but also exposes the static
addDefaultConverters(ConverterRegistry)utility method for ad-hoc use against anyConverterRegistryinstance.- Since:
- 3.1
- Author:
- Chris Beams, Juergen Hoeller, Stephane Nicoll
Constructor Summary
Constructors Constructor Description DefaultConversionService()Create a newDefaultConversionServicewith the set of default converters.
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static voidaddCollectionConverters(ConverterRegistry converterRegistry)Add common collection converters.static voidaddDefaultConverters(ConverterRegistry converterRegistry)Add converters appropriate for most environments.static ConversionServicegetSharedInstance()Return a shared defaultConversionServiceinstance, lazily building it once needed.Methods inherited from class org.springframework.core.convert.support.GenericConversionService
addConverter, addConverter, addConverter, addConverterFactory, canBypassConvert, canConvert, canConvert, convert, convert, convert, convertNullSource, getConverter, getDefaultConverter, removeConvertible, toString
Constructor Detail
DefaultConversionService
public DefaultConversionService()
Create a newDefaultConversionServicewith the set of default converters.
Method Detail
getSharedInstance
public static ConversionService getSharedInstance()
Return a shared defaultConversionServiceinstance, lazily building it once needed.NOTE: We highly recommend constructing individual
ConversionServiceinstances for customization purposes. This accessor is only meant as a fallback for code paths which need simple type coercion but cannot access a longer-livedConversionServiceinstance any other way.- Returns:
- the shared
ConversionServiceinstance (nevernull) - Since:
- 4.3.5
addDefaultConverters
public static void addDefaultConverters(ConverterRegistry converterRegistry)
Add converters appropriate for most environments.- Parameters:
converterRegistry- the registry of converters to add to (must also be castable to ConversionService, e.g. being aConfigurableConversionService)- Throws:
ClassCastException- if the given ConverterRegistry could not be cast to a ConversionService
addCollectionConverters
public static void addCollectionConverters(ConverterRegistry converterRegistry)
Add common collection converters.- Parameters:
converterRegistry- the registry of converters to add to (must also be castable to ConversionService, e.g. being aConfigurableConversionService)- Throws:
ClassCastException- if the given ConverterRegistry could not be cast to a ConversionService- Since:
- 4.2.3