org.springframework.core.convert.converter
Interface ConditionalGenericConverter

All Superinterfaces:

GenericConverter

public interface ConditionalGenericConverter
extends GenericConverter

A generic converter that conditionally executes.

Applies a rule that determines if a converter between a set of convertible types matches given a client request to convert between a source field of convertible type S and a target field of convertible type T.

Often used to selectively match custom conversion logic based on the presence of a field or class-level characteristic, such as an annotation or method. For example, when converting from a String field to a Date field, an implementation might return true if the target field has also been annotated with @DateTimeFormat.

As another example, when converting from a String field to an Account field, an implementation might return true if the target Account class defines a public static findAccount(String) method.

Since:

3.0

Author:

Keith Donald

Nested Class Summary

Nested classes/interfaces inherited from interface org.springframework.core.convert.converter.GenericConverter

GenericConverter.ConvertiblePair

Method Summary

boolean

matches(TypeDescriptor sourceType, TypeDescriptor targetType) Should the converter from sourceType to targetType currently under consideration be selected?

Methods inherited from interface org.springframework.core.convert.converter.GenericConverter

convert, getConvertibleTypes

Method Detail

matches

boolean matches(TypeDescriptor sourceType,
                TypeDescriptor targetType)

Should the converter from sourceType to targetType currently under consideration be selected?

Parameters:

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

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

Returns:

true if conversion should be performed, false otherwise