程序包 org.springframework.boot.convert

类 ApplicationConversionService

java.lang.Object

org.springframework.core.convert.support.GenericConversionService

org.springframework.format.support.FormattingConversionService

org.springframework.boot.convert.ApplicationConversionService

所有已实现的接口:

Aware, EmbeddedValueResolverAware, ConversionService, ConverterRegistry, ConfigurableConversionService, FormatterRegistry

public class ApplicationConversionService
extends FormattingConversionService

A specialization of FormattingConversionService configured by default with converters and formatters appropriate for most Spring Boot applications.

Designed for direct instantiation but also exposes the static addApplicationConverters(org.springframework.core.convert.converter.ConverterRegistry) and addApplicationFormatters(FormatterRegistry) utility methods for ad-hoc use against registry instance.

从以下版本开始:

2.0.0

作者:

Phillip Webb, Shixiong Guo

构造器概要

构造器

构造器	说明
ApplicationConversionService()
ApplicationConversionService(StringValueResolver embeddedValueResolver)

方法概要

修饰符和类型	方法	说明
static void	addApplicationConverters(ConverterRegistry registry)	Add converters useful for most Spring Boot applications.
static void	addApplicationFormatters(FormatterRegistry registry)	Add formatters useful for most Spring Boot applications.
static void	addBeans(FormatterRegistry registry, ListableBeanFactory beanFactory)	Add Printer, Parser, Formatter, Converter, ConverterFactory, GenericConverter, and beans from the specified bean factory.
static Map<String,Object>	addBeans(FormatterRegistry registry, ListableBeanFactory beanFactory, String qualifier)	Add Printer, Parser, Formatter, Converter, ConverterFactory, GenericConverter, and beans from the specified bean factory.
<S, T> void	addConverter(Class<S> sourceType, Class<T> targetType, Converter<? super S,? extends T> converter)
void	addConverter(Converter<?,?> converter)
void	addConverter(GenericConverter converter)
void	addConverterFactory(ConverterFactory<?,?> factory)
static void	addDelimitedStringConverters(ConverterRegistry registry)	Add converters to support delimited strings.
void	addFormatter(Formatter<?> formatter)
void	addFormatterForFieldAnnotation(AnnotationFormatterFactory<? extends Annotation> annotationFormatterFactory)
void	addFormatterForFieldType(Class<?> fieldType, Formatter<?> formatter)
void	addFormatterForFieldType(Class<?> fieldType, Printer<?> printer, Parser<?> parser)
void	addParser(Parser<?> parser)
void	addPrinter(Printer<?> printer)
static void	configure(FormatterRegistry registry)	Configure the given FormatterRegistry with formatters and converters appropriate for most Spring Boot applications.
static ConversionService	getSharedInstance()	Return a shared default application ConversionService instance, lazily building it once needed.
boolean	isConvertViaObjectSourceType(TypeDescriptor sourceType, TypeDescriptor targetType)	Return true if objects of sourceType can be converted to the targetType and the converter has Object.class as a supported source type.
void	removeConvertible(Class<?> sourceType, Class<?> targetType)

从类继承的方法 org.springframework.format.support.FormattingConversionService

setEmbeddedValueResolver

从类继承的方法 org.springframework.core.convert.support.GenericConversionService

canBypassConvert, canConvert, canConvert, convert, convert, convertNullSource, getConverter, getDefaultConverter, toString

从类继承的方法 java.lang.Object

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

从接口继承的方法 org.springframework.core.convert.ConversionService

convert

构造器详细资料

ApplicationConversionService

public ApplicationConversionService()

ApplicationConversionService

public ApplicationConversionService(StringValueResolver embeddedValueResolver)

方法详细资料

addPrinter

public void addPrinter(Printer<?> printer)

指定者:

addPrinter 在接口中 FormatterRegistry

覆盖:

addPrinter 在类中 FormattingConversionService

addParser

public void addParser(Parser<?> parser)

指定者:

addParser 在接口中 FormatterRegistry

覆盖:

addParser 在类中 FormattingConversionService

addFormatter

public void addFormatter(Formatter<?> formatter)

指定者:

addFormatter 在接口中 FormatterRegistry

覆盖:

addFormatter 在类中 FormattingConversionService

addFormatterForFieldType

public void addFormatterForFieldType(Class<?> fieldType,
 Formatter<?> formatter)

指定者:

addFormatterForFieldType 在接口中 FormatterRegistry

覆盖:

addFormatterForFieldType 在类中 FormattingConversionService

addConverter

public void addConverter(Converter<?,?> converter)

指定者:

addConverter 在接口中 ConverterRegistry

覆盖:

addConverter 在类中 GenericConversionService

addFormatterForFieldType

public void addFormatterForFieldType(Class<?> fieldType,
 Printer<?> printer,
 Parser<?> parser)

指定者:

addFormatterForFieldType 在接口中 FormatterRegistry

覆盖:

addFormatterForFieldType 在类中 FormattingConversionService

addFormatterForFieldAnnotation

public void addFormatterForFieldAnnotation(AnnotationFormatterFactory<? extends Annotation> annotationFormatterFactory)

指定者:

addFormatterForFieldAnnotation 在接口中 FormatterRegistry

覆盖:

addFormatterForFieldAnnotation 在类中 FormattingConversionService

addConverter

public <S,
T> void addConverter(Class<S> sourceType,
 Class<T> targetType,
 Converter<? super S,? extends T> converter)

指定者:

addConverter 在接口中 ConverterRegistry

覆盖:

addConverter 在类中 GenericConversionService

addConverter

public void addConverter(GenericConverter converter)

指定者:

addConverter 在接口中 ConverterRegistry

覆盖:

addConverter 在类中 GenericConversionService

addConverterFactory

public void addConverterFactory(ConverterFactory<?,?> factory)

指定者:

addConverterFactory 在接口中 ConverterRegistry

覆盖:

addConverterFactory 在类中 GenericConversionService

removeConvertible

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

指定者:

removeConvertible 在接口中 ConverterRegistry

覆盖:

removeConvertible 在类中 GenericConversionService

isConvertViaObjectSourceType

public boolean isConvertViaObjectSourceType(TypeDescriptor sourceType,
 TypeDescriptor targetType)

Return true if objects of sourceType can be converted to the targetType and the converter has Object.class as a supported source type.

参数:

sourceType - the source type to test

targetType - the target type to test

返回:

if conversion happens through an ObjectTo... converter

从以下版本开始:

2.4.3

getSharedInstance

public static ConversionService getSharedInstance()

Return a shared default application ConversionService instance, lazily building it once needed.

Note: This method actually returns an ApplicationConversionService instance. However, the ConversionService signature has been preserved for binary compatibility.

返回:

the shared ApplicationConversionService instance (never null)

configure

public static void configure(FormatterRegistry registry)

Configure the given FormatterRegistry with formatters and converters appropriate for most Spring Boot applications.

参数:

registry - the registry of converters to add to (must also be castable to ConversionService, e.g. being a ConfigurableConversionService)

抛出:

ClassCastException - if the given FormatterRegistry could not be cast to a ConversionService

addApplicationConverters

public static void addApplicationConverters(ConverterRegistry registry)

Add converters useful for most Spring Boot applications.

参数:

registry - the registry of converters to add to (must also be castable to ConversionService, e.g. being a ConfigurableConversionService)

抛出:

ClassCastException - if the given ConverterRegistry could not be cast to a ConversionService

addDelimitedStringConverters

public static void addDelimitedStringConverters(ConverterRegistry registry)

Add converters to support delimited strings.

参数:

registry - the registry of converters to add to (must also be castable to ConversionService, e.g. being a ConfigurableConversionService)

抛出:

ClassCastException - if the given ConverterRegistry could not be cast to a ConversionService

addApplicationFormatters

public static void addApplicationFormatters(FormatterRegistry registry)

Add formatters useful for most Spring Boot applications.

参数:

registry - the service to register default formatters with

addBeans

public static void addBeans(FormatterRegistry registry,
 ListableBeanFactory beanFactory)

Add Printer, Parser, Formatter, Converter, ConverterFactory, GenericConverter, and beans from the specified bean factory.

参数:

registry - the service to register beans with

beanFactory - the bean factory to get the beans from

从以下版本开始:

2.2.0

addBeans

public static Map<String,Object> addBeans(FormatterRegistry registry,
 ListableBeanFactory beanFactory,
 String qualifier)

Add Printer, Parser, Formatter, Converter, ConverterFactory, GenericConverter, and beans from the specified bean factory.

参数:

registry - the service to register beans with

beanFactory - the bean factory to get the beans from

qualifier - the qualifier required on the beans or null

返回:

the beans that were added

从以下版本开始:

3.5.0