From 01775ba53d54faee062af94969a21de69d57d9d5 Mon Sep 17 00:00:00 2001 From: Dave Syer Date: Wed, 26 Mar 2014 08:43:26 +0000 Subject: [PATCH] Clarify role of MVC autoconfiguration Users only have to add a normal `WebMvcConfigurer` to configure their own features. Sometimes that's not clear enough (and it's good to stress that `@EnableWebMvc` is the thing that switches off the Boot configurtation. Fixes gh-583 --- .../src/main/asciidoc/spring-boot-features.adoc | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/spring-boot-docs/src/main/asciidoc/spring-boot-features.adoc b/spring-boot-docs/src/main/asciidoc/spring-boot-features.adoc index 61e73af5a4c..81ee3659996 100644 --- a/spring-boot-docs/src/main/asciidoc/spring-boot-features.adoc +++ b/spring-boot-docs/src/main/asciidoc/spring-boot-features.adoc @@ -783,8 +783,7 @@ available at http://spring.io/guides that cover Spring MVC. [[boot-features-spring-mvc-auto-configuration]] ==== Spring MVC auto-configuration Spring Boot provides auto-configuration for Spring MVC that works well with most -applications. If you want to take complete control of Spring MVC you can add your -own `@Configuration` annotated with `@EnableWebMvc`. +applications. The auto-configuration adds the following features on top of Spring's defaults: @@ -795,7 +794,13 @@ The auto-configuration adds the following features on top of Spring's defaults: * Static `index.html` support. * Custom `Favicon` support. - +If you want to take complete control of Spring MVC you can add your +own `@Configuration` annotated with `@EnableWebMvc`. If you want the +Boot features, and just want to add additional [normal MVC +configuration](http://docs.spring.io/spring/docs/current/spring-framework-reference/html/mvc.html), +like interceptors, formatters, view controllers etc, you can simply +add your own `@Bean` of type `WebMvcConfigurerAdapter` (like normal +MVC), but don't forget *not* to add `@EnableWebMvc`. [[boot-features-spring-mvc-message-converters]] ==== HttpMessageConverters