Package org.springframework.format

Interface FormatterRegistry

All Superinterfaces:

ConverterRegistry

All Known Implementing Classes:

DefaultFormattingConversionService, FormattingConversionService

public interface FormatterRegistry
extends ConverterRegistry

A registry of field formatting logic.

Since:

3.0

Author:

Keith Donald, Juergen Hoeller

Method Summary

Modifier and Type	Method	Description
void	addFormatter(Formatter<?> formatter)	Adds a Formatter to format fields of a specific type.
void	addFormatterForFieldAnnotation(AnnotationFormatterFactory<? extends Annotation> annotationFormatterFactory)	Adds a Formatter to format fields annotated with a specific format annotation.
void	addFormatterForFieldType(Class<?> fieldType, Formatter<?> formatter)	Adds a Formatter to format fields of the given type.
void	addFormatterForFieldType(Class<?> fieldType, Printer<?> printer, Parser<?> parser)	Adds a Printer/Parser pair to format fields of a specific type.
void	addParser(Parser<?> parser)	Adds a Parser to parse fields of a specific type.
void	addPrinter(Printer<?> printer)	Adds a Printer to print fields of a specific type.

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

addConverter, addConverter, addConverter, addConverterFactory, removeConvertible

Method Details

addPrinter

void addPrinter(Printer<?> printer)

Adds a Printer to print fields of a specific type. The field type is implied by the parameterized Printer instance.

Parameters:

printer - the printer to add

Since:

5.2

See Also:

• addFormatter(Formatter)

addParser

void addParser(Parser<?> parser)

Adds a Parser to parse fields of a specific type. The field type is implied by the parameterized Parser instance.

Parameters:

parser - the parser to add

Since:

5.2

See Also:

• addFormatter(Formatter)

addFormatter

void addFormatter(Formatter<?> formatter)

Adds a Formatter to format fields of a specific type. The field type is implied by the parameterized Formatter instance.

Parameters:

formatter - the formatter to add

Since:

3.1

See Also:

• addFormatterForFieldType(Class, Formatter)

addFormatterForFieldType

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

Adds a Formatter to format fields of the given type.

On print, if the Formatter's type T is declared and fieldType is not assignable to T, a coercion to T will be attempted before delegating to formatter to print a field value. On parse, if the parsed object returned by formatter is not assignable to the runtime field type, a coercion to the field type will be attempted before returning the parsed field value.

Parameters:

fieldType - the field type to format

formatter - the formatter to add

addFormatterForFieldType

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

Adds a Printer/Parser pair to format fields of a specific type. The formatter will delegate to the specified printer for printing and the specified parser for parsing.

On print, if the Printer's type T is declared and fieldType is not assignable to T, a coercion to T will be attempted before delegating to printer to print a field value. On parse, if the object returned by the Parser is not assignable to the runtime field type, a coercion to the field type will be attempted before returning the parsed field value.

Parameters:

fieldType - the field type to format

printer - the printing part of the formatter

parser - the parsing part of the formatter

addFormatterForFieldAnnotation

void addFormatterForFieldAnnotation(AnnotationFormatterFactory<? extends Annotation> annotationFormatterFactory)

Adds a Formatter to format fields annotated with a specific format annotation.

Parameters:

annotationFormatterFactory - the annotation formatter factory to add