0 Tage Serie
java / intermediate
Snippet

Implementieren benutzerdefinierter Typkonverter für den Spring Data ConversionService

Der `ConversionService` von Spring bietet ein einheitliches SPI zur Durchführung von Typkonvertierungen zwischen Strings und stark typisierten Domänenobjekten. Durch Implementieren von `org.springframework.core.convert.converter.Converter<S, T>` können rohe HTTP-Anfrageparameter, Pfadvariablen und Konfigurationswerte nahtlos in unveränderliche Java-Records geparst werden, wodurch Controller-Methoden ohne manuelle Parsing-Logik typsicher bleiben.

snippet.java
java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
public record IsoCurrency(String currencyCode, int fractionDigits) {}
@Component
public class StringToIsoCurrencyConverter implements Converter<String, IsoCurrency> {
@Override
public IsoCurrency convert(String source) {
if (source == null || source.isBlank()) {
return null;
}
String normalized = source.trim().toUpperCase();
Currency currency = Currency.getInstance(normalized);
return new IsoCurrency(currency.getCurrencyCode(), currency.getDefaultFractionDigits());
}
}
@Configuration
public class WebFormattingConfiguration implements WebMvcConfigurer {
@Override
public void addFormatters(FormatterRegistry registry) {
registry.addConverter(new StringToIsoCurrencyConverter());
}
}
spring
Erklärung
1
public class StringToIsoCurrencyConverter implements Converter<String, IsoCurrency>
Definiert einen zustandslosen Konverter-Vertrag, der einen Quell-String auf ein IsoCurrency-Zielrecord abbildet.
2
Currency currency = Currency.getInstance(normalized);
Validiert die String-Darstellung und parst standardisierte ISO-Währungs-Metadaten.
3
registry.addConverter(new StringToIsoCurrencyConverter());
Registriert den Konverter in der FormatterRegistry von Spring MVC für automatisches Parameter-Binding.