ConverterRegi<strong>s</strong>try (<strong>s</strong>pring Framework 7.0.2 API)

This is a cache of https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/core/convert/converter/ConverterRegistry.html. It is a snapshot of the page as it appeared on 2026-02-17T10:19:11.947+0000.

ConverterRegi<strong>s</strong>try (<strong>s</strong>pring Framework 7.0.2 API)

All Known subinterfaces:: ConfigurableConversionservice, FormatterRegistry

All Known Implementing Classes:: DefaultConversionservice, DefaultFormattingConversionservice, FormattingConversionservice, GenericConversionservice

public interface ConverterRegistry

For registering converters with a type conversion system.

since:: 3.0
Author:: Keith Donald, Juergen Hoeller

Method summary

Modifier and Type

Method

Description

<s,T> void

addConverter(Class<s> sourceType, Class<T> targetType, Converter<? super s, ? extends T> converter)

Add a plain converter to this registry.

void

addConverter(Converter<?,?> converter)

Add a plain converter to this registry.

void

addConverter(GenericConverter converter)

Add a generic converter to this registry.

void

addConverterFactory(ConverterFactory<?,?> factory)

Add a ranged converter factory to this registry.

void

removeConvertible(Class<?> sourceType, Class<?> targetType)

Remove any converters from sourceType to targetType.

Method Details
- addConverter
  
  void addConverter(Converter<?,?> converter)
  
  Add a plain converter to this registry. The convertible source/target type pair is derived from the Converter's parameterized types.
  
  Throws:
  
  IllegalArgumentException - if the parameterized types could not be resolved
- addConverter
  
  <s,T> void addConverter(Class<s> sourceType, Class<T> targetType, Converter<? super s, ? extends T> converter)
  
  Add a plain converter to this registry. The convertible source/target type pair is specified explicitly.
  Allows for a Converter to be reused for multiple distinct pairs without having to create a Converter class for each pair.
  
  since:
  
  3.1
- addConverter
  
  void addConverter(GenericConverter converter)
  
  Add a generic converter to this registry.
- addConverterFactory
  
  void addConverterFactory(ConverterFactory<?,?> factory)
  
  Add a ranged converter factory to this registry. The convertible source/target type pair is derived from the ConverterFactory's parameterized types.
  
  Throws:
  
  IllegalArgumentException - if the parameterized types could not be resolved
- removeConvertible
  
  void removeConvertible(Class<?> sourceType, Class<?> targetType)
  
  Remove any converters from sourceType to targetType.
  
  Parameters:
  
  sourceType - the source type
  
  targetType - the target type