Generated by
JDiff

org.springframework.core.convert.converter Documentation Differences

This file contains all the changes in documentation in the package org.springframework.core.convert.converter as colored differences. Deletions are shown like this, and additions are shown like this.
If no deletions or additions are shown in an entry, the HTML tags will be what has changed. The new HTML tags are shown in the differences. If no documentation existed, and then some was added in a later version, this change is noted in the appropriate class pages of differences, but the change is not shown on this page. Only changes in existing text are shown here. Similarly, documentation which was inherited from another class or interface is not shown here.
Note that an HTML error in the new documentation may cause the display of other documentation changes to be presented incorrectly. For instance, failure to close a <code> tag will cause all subsequent paragraphs to be displayed differently.

Class ConditionalGenericConverter

A generic converter that conditionally executes. Applies a rule that determines if a converter between a set of convertible typesGenericConverter matches given a client requestthat to convert between a source fieldmay conditionally execute based on attributes of convertiblethe type{@code Ssource} and a{@code 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 methodTypeDescriptor. For example, when converting from a String field to a Date field, an implementation might return trueSee if the target field has also been annotatedConditionalConverter withfor @DateTimeFormatdetails. As another example, when converting from a String field to an Account field, an implementation might return true if the target Account@author class definesKeith Donald a @author publicPhillip staticWebb findAccount(String)@since method3. 0 @author Keithsee Donald GenericConverter @sincesee 3.0ConditionalConverter

Class Converter

A converter converts a source object of type S to a target of type T. Implementations of this interface are thread-safe and can be shared.

Implementations may additionally implement ConditionalConverter. @author Keith Donald @since 3.00 @see ConditionalConverter @param The source type @param The target type


Class ConverterFactory

A factory for "ranged" converters that can convert objects from S to subtypes of R.

Implementations may additionally implement ConditionalConverter. @author Keith Donald @since 3.00 @see ConditionalConverter @param The source type converters created by this factory can convert from @param The target range (or base) type converters created by this factory can convert to; for example Number for a set of number subtypes.


Class 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 influence the conversion logic.

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

Implementations may additionally implement ConditionalConverter. @author Keith Donald @author Juergen Hoeller @since 3.0 @see TypeDescriptor @see Converter @see ConverterFactoryConverterFactory @see ConditionalConverter

Class GenericConverter, Set<ConvertiblePair> getConvertibleTypes()

Return the source and target types which this converter can convert between. EachEach entry is a convertible source-to-target type pair.

For conditional converters this method may return {@code null} to indicate all source-to-target pairs should be considered. *