Class FormattingConversionServiceFactoryBean
- All Implemented Interfaces:
org.springframework.beans.factory.Aware
,org.springframework.beans.factory.FactoryBean<FormattingConversionService>
,org.springframework.beans.factory.InitializingBean
,EmbeddedValueResolverAware
FormattingConversionService
configured with converters and formatters for common types such as numbers and
datetimes.
Additional converters and formatters can be registered declaratively through
setConverters(Set)
and setFormatters(Set)
. Another option
is to register converters and formatters in code by implementing the
FormatterRegistrar
interface. You can then configure provide the set
of registrars to use through setFormatterRegistrars(Set)
.
A good example for registering converters and formatters in code is
JodaTimeFormatterRegistrar
, which registers a number of
date-related formatters and converters. For a more detailed list of cases
see setFormatterRegistrars(Set)
Like all FactoryBean
implementations, this class is suitable for
use when configuring a Spring application context using Spring <beans>
XML. When configuring the container with
@Configuration
classes, simply instantiate, configure and return the appropriate
FormattingConversionService
object from a
@Bean
method.
- Since:
- 3.0
- Author:
- Keith Donald, Juergen Hoeller, Rossen Stoyanchev, Chris Beams
-
Field Summary
Fields inherited from interface org.springframework.beans.factory.FactoryBean
OBJECT_TYPE_ATTRIBUTE
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
Class<? extends FormattingConversionService>
boolean
void
setConverters
(Set<?> converters) Configure the set of custom converter objects that should be added.void
setEmbeddedValueResolver
(org.springframework.util.StringValueResolver embeddedValueResolver) Set the StringValueResolver to use for resolving embedded definition values.void
setFormatterRegistrars
(Set<FormatterRegistrar> formatterRegistrars) Configure the set of FormatterRegistrars to invoke to register Converters and Formatters in addition to those added declaratively viasetConverters(Set)
andsetFormatters(Set)
.void
setFormatters
(Set<?> formatters) Configure the set of custom formatter objects that should be added.void
setRegisterDefaultFormatters
(boolean registerDefaultFormatters) Indicate whether default formatters should be registered or not.
-
Constructor Details
-
FormattingConversionServiceFactoryBean
public FormattingConversionServiceFactoryBean()
-
-
Method Details
-
setConverters
Configure the set of custom converter objects that should be added.- Parameters:
converters
- instances of any of the following:Converter
,ConverterFactory
,GenericConverter
-
setFormatters
Configure the set of custom formatter objects that should be added.- Parameters:
formatters
- instances ofFormatter
orAnnotationFormatterFactory
-
setFormatterRegistrars
Configure the set of FormatterRegistrars to invoke to register Converters and Formatters in addition to those added declaratively via
setConverters(Set)
andsetFormatters(Set)
.FormatterRegistrars are useful when registering multiple related converters and formatters for a formatting category, such as Date formatting. All types related needed to support the formatting category can be registered from one place.
FormatterRegistrars can also be used to register Formatters indexed under a specific field type different from its own <T>, or when registering a Formatter from a Printer/Parser pair.
-
setRegisterDefaultFormatters
public void setRegisterDefaultFormatters(boolean registerDefaultFormatters) Indicate whether default formatters should be registered or not.By default, built-in formatters are registered. This flag can be used to turn that off and rely on explicitly registered formatters only.
-
setEmbeddedValueResolver
public void setEmbeddedValueResolver(org.springframework.util.StringValueResolver embeddedValueResolver) Description copied from interface:EmbeddedValueResolverAware
Set the StringValueResolver to use for resolving embedded definition values.- Specified by:
setEmbeddedValueResolver
in interfaceEmbeddedValueResolverAware
-
afterPropertiesSet
public void afterPropertiesSet()- Specified by:
afterPropertiesSet
in interfaceorg.springframework.beans.factory.InitializingBean
-
getObject
- Specified by:
getObject
in interfaceorg.springframework.beans.factory.FactoryBean<FormattingConversionService>
-
getObjectType
- Specified by:
getObjectType
in interfaceorg.springframework.beans.factory.FactoryBean<FormattingConversionService>
-
isSingleton
public boolean isSingleton()- Specified by:
isSingleton
in interfaceorg.springframework.beans.factory.FactoryBean<FormattingConversionService>
-