Spring boot中SpringMVC自动配置原理

SpringMVC(1.5.10版本)自动配置原理

官方文档：https://docs.spring.io/spring-boot/docs/1.5.10.RELEASE/reference/html/

1. Spring MVC auto-configuration

   Spring Boot 自动配置好了SpringMVC， 以下是SpringBoot对SpringMVC的默认配置WebMvcAutoConfiguration）：

• Inclusion of ContentNegotiatingViewResolver and BeanNameViewResolver beans

①自动配置了ViewResolver（视图解析器：根据方法的返回值得到视图对象（View），视图对象决定如何渲染（转发？重定向？））

②ContentNegotiatingViewResolver：组合所有的视图解析器

③如何定制：我们可以自己给容器中添加一个视图解析器；自动的将其组合进来

• Support for serving static resources, including support for WebJars (see below) 静态资源文件夹路 径
• webjars Static index.html support. 静态首页访问
• Custom Favicon support (see below). favicon.ico
• 自动注册了 of Converter , GenericConverter , Formatter beans

①Converter：转换器；

public String hello(User user) 类型转换使用Converter

② Formatter 格式化器

1900/01/03.===Date

@Bean 
@ConditionalOnProperty(prefix = "spring.mvc", name = "date‐format")//在文件中配置日期格 式化的规则
public Formatter<Date> dateFormatter() { 
   //日期格式化组件 
   return new DateFormatter(this.mvcProperties.getDateFormat());
}

自己添加的格式化器转换器，我们只需要放在容器中即可。

• Support for HttpMessageConverters (see below)

①HttpMessageConverter：SpringMVC用来转换Http请求和响应的；User—Json。

②HttpMessageConverters 从容器中确定；获取所有的HttpMessageConverter。
自己给容器中添加HttpMessageConverter，只需要将自己的组件注册容器中 （@Bean，@Component）

• Automatic registration of MessageCodesResolver (see below).定义错误代码生成规则
• Automatic use of a ConfigurableWebBindingInitializer bean (see below).
  我们可以配置一个ConfigurableWebBindingInitializer来替换默认的；（添加到容器）

初始化WebDataBinder
作用：用来请求数据=====JavaBean

org.springframework.boot.autoconfigure.web：web的所有自动配置场景：

If you want to keep Spring Boot MVC features, and you just want to add additional 
MVC configuration (interceptors, formatters, view controllers etc.) you can add your 
own @Configuration class of type WebMvcConfigurerAdapter , but without @EnableWebMvc .
If you wish to provide custom instances of RequestMappingHandlerMapping , 
RequestMappingHandlerAdapter or ExceptionHandlerExceptionResolver you can 
declare a WebMvcRegistrationsAdapter instance providing such components.

If you want to take complete control of Spring MVC, you can add your own 
@Configuration annotated with @EnableWebMvc .

2、如何扩展一个Spring MVC

  编写一个类型是WebMvcConfigurerAdapter的配置类（@Configuration），；不能标注@EnableWebMvc。

  它既保留了所有的自动配置，也能用我们扩展的配置。

//使用WebMvcConfigurerAdapter可以来扩展SpringMVC的功能 
@Configuration
public class MyMvcConfig extends WebMvcConfigurerAdapter {

    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        //super.addViewControllers(registry);
        
        //浏览器发送/config请求到demo.html页面
        registry.addViewController("/config").setViewName("demo");
    }
}

原理：

  1）WebMvcAutoConfiguration是SpringMVC的自动配置类
  2）、在做其他自动配置时会导入：@Import(EnableWebMvcConfiguration.class)

@Configuration 
public static class EnableWebMvcConfiguration extends DelegatingWebMvcConfiguration { 
   private final WebMvcConfigurerComposite configurers = new WebMvcConfigurerComposite(); 
   //从容器中获取所有的WebMvcConfigurer 
   @Autowired(required = false) 
   public void setConfigurers(List<WebMvcConfigurer> configurers) { 
   if (!CollectionUtils.isEmpty(configurers)) { 
   this.configurers.addWebMvcConfigurers(configurers); 
   //一个参考实现；将所有的WebMvcConfigurer相关配置都来一起调用； 
   @Override 
   // public void addViewControllers(ViewControllerRegistry registry) {
    // for (WebMvcConfigurer delegate : this.delegates) { 
    // delegate.addViewControllers(registry); 
    // 
    }
   } 
  } 
}

  3）容器中所有的WebMvcConfigurer都会一起起作用，自定义的配置类也会被调用。

  最终效果：SpringMVC的自动配置和我们的扩展配置都会起作用。

  扩展配置类会和自动配置类放入同一个容器，SpringBoot在装载配置的时候，会将所有配置都取出，所以扩展配置和SpringBoot都会生效。当然，以上代码只是对WebMvc的扩展配置，其他配置可以参考以上模式，只要找到相对应的XXXconfigurer接口进行实现即可。

3、全面接管Spring MVC

  若不需要Spring Boot中对Spring MVC的自动配置，只需要在配置类上添加@EnableWebMvc注解即可。

为什么@EnableWebMvc自动配置就失效了？

1）@EnableWebMvc的核心

@Import(DelegatingWebMvcConfiguration.class) 
public @interface EnableWebMvc {

2）DelegatingWebMvcConfiguration.class

@Configuration 
public class DelegatingWebMvcConfiguration extends WebMvcConfigurationSupport {

  因为@EnableWebMvc导入了WebMvcConfigurationSupport，所以就导致了WebMvcAutoConfiguration的失效。

3）WebMvcAutoConfiguration

@Configuration @ConditionalOnWebApplication 
@ConditionalOnClass({ Servlet.class, DispatcherServlet.class, WebMvcConfigurerAdapter.class }) 
//容器中没有这个组件的时候，这个自动配置类才生效 
@ConditionalOnMissingBean(WebMvcConfigurationSupport.class) 
@AutoConfigureOrder(Ordered.HIGHEST_PRECEDENCE + 10) 
@AutoConfigureAfter({ DispatcherServletAutoConfiguration.class, ValidationAutoConfiguration.class }) 
public class WebMvcAutoConfiguration {

4、如何修改Spring Boot的默认配置

  1）SpringBoot在自动配置很多组件的时候，先看容器中有没有用户自己配置的（·@Bean、@Component），如果有，就用用户配置的；如果没有，才自动配置。如果有些组件可以有多个（ViewResolver）将用户配置的和自己默认的组合起来。
  2）在SpringBoot中会有非常多的xxxConfigurer帮助我们进行扩展配置 。
  3）在SpringBoot中会有很多的xxxCustomizer帮助我们进行定制配置

2.0版本的Spring MVC的自动配置原理参考链接：https://www.jianshu.com/p/66fa0264ebb0