型変換
デフォルトでは、さまざまな数値および日付型のフォーマッタがインストールされており、フィールドおよびパラメーターに対する @NumberFormat
、@DurationFormat
、@DateTimeFormat
によるカスタマイズもサポートされます。
カスタムフォーマッタとコンバーターを登録するには、次を使用します。
Java
Kotlin
XML
@Configuration
public class WebConfiguration implements WebMvcConfigurer {
@Override
public void addFormatters(FormatterRegistry registry) {
// ...
}
}
@Configuration
class WebConfiguration : WebMvcConfigurer {
override fun addFormatters(registry: FormatterRegistry) {
// ...
}
}
<mvc:annotation-driven conversion-service="conversionService"/>
<bean id="conversionService"
class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
<property name="converters">
<set>
<bean class="org.example.MyConverter"/>
</set>
</property>
<property name="formatters">
<set>
<bean class="org.example.MyFormatter"/>
<bean class="org.example.MyAnnotationFormatterFactory"/>
</set>
</property>
<property name="formatterRegistrars">
<set>
<bean class="org.example.MyFormatterRegistrar"/>
</set>
</property>
</bean>
デフォルトでは、Spring MVC は日付値を解析およびフォーマットするときに、リクエストロケールを考慮します。これは、日付が「入力」フォームフィールドを持つ文字列として表されるフォームで機能します。ただし、「日付」および「時間」フォームフィールドの場合、ブラウザーは HTML 仕様で定義された固定形式を使用します。このような場合、日付と時刻のフォーマットは次のようにカスタマイズできます。
Java
Kotlin
@Configuration
public class DateTimeWebConfiguration implements WebMvcConfigurer {
@Override
public void addFormatters(FormatterRegistry registry) {
DateTimeFormatterRegistrar registrar = new DateTimeFormatterRegistrar();
registrar.setUseIsoFormat(true);
registrar.registerFormatters(registry);
}
}
@Configuration
class DateTimeWebConfiguration : WebMvcConfigurer {
override fun addFormatters(registry: FormatterRegistry) {
DateTimeFormatterRegistrar().apply {
setUseIsoFormat(true)
registerFormatters(registry)
}
}
}
FormatterRegistrar 実装をいつ使用するかについての詳細は、FormatterRegistrar SPI および FormattingConversionServiceFactoryBean を参照してください。 |