程序包 cn.taketoday.core.conversion

接口 GenericConverter

所有已知子接口:

ConditionalGenericConverter

所有已知实现类:

ArrayToArrayConverter, ArrayToCollectionConverter, ArrayToObjectConverter, ArrayToStringConverter, ByteBufferConverter, CollectionToArrayConverter, CollectionToCollectionConverter, CollectionToObjectConverter, CollectionToStringConverter, FallbackObjectToStringConverter, GenericConversionService.ConverterAdapter, GenericConversionService.ConverterFactoryAdapter, GenericConversionService.NoOpConverter, IdToEntityConverter, MapToMapConverter, ObjectToArrayConverter, ObjectToCollectionConverter, ObjectToObjectConverter, ObjectToOptionalConverter, StreamConverter, StringToArrayConverter, StringToCollectionConverter

public interface GenericConverter

Generic converter interface for converting between two or more types.

This is the most flexible of the Converter SPI interfaces, but also the most complex. It is flexible in that a GenericConverter may support converting between multiple source/target type pairs (see getConvertibleTypes(). In addition, GenericConverter implementations have access to source/target field context during the type conversion process. This allows for resolving source and target field metadata such as annotations and generics information, which can be used to influence the conversion logic.

This interface should generally not be used when the simpler Converter or ConverterFactory interface is sufficient.

Implementations may additionally implement ConditionalConverter.

从以下版本开始:

4.0

作者:

Keith Donald, Juergen Hoeller, Harry Yang

另请参阅:

• TypeDescriptor
• Converter
• ConverterFactory
• ConditionalConverter

嵌套类概要

嵌套类

修饰符和类型	接口	说明
static final class	GenericConverter.ConvertiblePair	Holder for a source-to-target class pair.

方法概要

修饰符和类型	方法	说明
Object	convert(Object source, TypeDescriptor sourceType, TypeDescriptor targetType)	Convert the source object to the targetType described by the TypeDescriptor.
Set<GenericConverter.ConvertiblePair>	getConvertibleTypes()	Return the source and target types that this converter can convert between.

方法详细资料

getConvertibleTypes

@Nullable
Set<GenericConverter.ConvertiblePair> getConvertibleTypes()

Return the source and target types that this converter can convert between.

Each entry is a convertible source-to-target type pair.

For conditional converters this method may return null to indicate all source-to-target pairs should be considered.

convert

@Nullable
Object convert(@Nullable
 Object source,
 TypeDescriptor sourceType,
 TypeDescriptor targetType)

Convert the source object to the targetType described by the TypeDescriptor.

参数:

source - the source object to convert (may be null)

sourceType - the type descriptor of the field we are converting from

targetType - the type descriptor of the field we are converting to

返回:

the converted object