public interface GenericConverter
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.
TypeDescriptor,
Converter,
ConverterFactory,
ConditionalConverter| 限定符和类型 | 接口和说明 |
|---|---|
static 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.
|
@Nullable Set<GenericConverter.ConvertiblePair> getConvertibleTypes()
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.
@Nullable Object convert(@Nullable Object source, TypeDescriptor sourceType, TypeDescriptor targetType)
TypeDescriptor.source - the source object to convert (may be null)sourceType - the type descriptor of the field we are converting fromtargetType - the type descriptor of the field we are converting to