Skip to content

Commit

Permalink
Document that Spring MVC has own ConversionService
Browse files Browse the repository at this point in the history
Update documentation to make it clearer that Spring MVC does not use the
`ApplicationConversionService` unless configured explicitly.

Closes spring-projectsgh-22718
  • Loading branch information
philwebb committed Jan 31, 2021
1 parent 5360ca6 commit 549d4f7
Showing 1 changed file with 10 additions and 0 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -2271,6 +2271,16 @@ If you want to provide custom instances of `RequestMappingHandlerMapping`, `Requ

If you want to take complete control of Spring MVC, you can add your own `@Configuration` annotated with `@EnableWebMvc`, or alternatively add your own `@Configuration`-annotated `DelegatingWebMvcConfiguration` as described in the Javadoc of `@EnableWebMvc`.

[NOTE]
====
Spring MVC uses a different `ConversionService` to the one used to convert values from your `application.properties` or `application.yaml` file.
The means that `Period`, `Duration` and `DataSize` converters are not available and that `@DurationUnit` and `@DataSizeUnit` annotations will be ignored.
If you want to customize the `ConversionService` used by Spring MVC, you can provide a `WebMvcConfigurer` bean with an `addFormatters` method.
From this method you can register any converter that you like, or you can delegate to the static methods available on `ApplicationConversionService`.
====



[[boot-features-spring-mvc-message-converters]]
==== HttpMessageConverters
Expand Down

0 comments on commit 549d4f7

Please sign in to comment.