4_2.springboot2.x配置之springmvc自动配置

我会带着你远行 2023-06-05 12:51 8阅读 0赞

## 1、Spring MVC auto-configuration ##

**查看官方文档:**

Spring Boot为Spring MVC提供了自动配置，适用于大多数应用程序。  
自动配置在Spring的默认值之上添加了以下功能：  
**1、包含ContentNegotiatingViewResolver 和BeanNameViewResolver beans。**

*  自动配置了ViewResolver（视图解析器：根据方法的返回值得到视图对象（View），视图对象决定如何渲染（转发？重定向？））
 *  ContentNegotiatingViewResolver：组合所有的视图解析器的；
    
    我们可以自己给容器中添加一个视图解析器；自动的将其组合进来

**2、支持提供静态资源，包括对WebJars的支持。**  
**3、自动注册Converter ， GenericConverter 和Formatter beans。**

*  Converter：转换器； public String hello(User user)：类型转换使用Converter
 *  `Formatter` 格式化器； 2017.12.17===Date；
    
    自己添加的格式化器转换器，我们只需要放在容器中即可

**4、支持HttpMessageConverters**

*  Support for `HttpMessageConverters` (see below).
    
     *  HttpMessageConverter：SpringMVC用来转换Http请求和响应的；User—Json；
     *  `HttpMessageConverters` 是从容器中确定；获取所有的HttpMessageConverter；
        
        自己给容器中添加HttpMessageConverter，只需要将自己的组件注册容器中（@Bean,@Component）

**5、自动注册MessageCodesResolver 。**  
**6、静态index.html 支持**  
**7、自定义Favicon 支持**  
**8、自动使用ConfigurableWebBindingInitializer bean**

可以配置一个ConfigurableWebBindingInitializer来替换默认的；（添加到容器）

如果你想保留Spring Boot MVC功能，并且你想添加额外的 MVC配置（拦截器，格式化程序，视图控制器和其他功能），你可以添加自己的@Configuration 类（WebMvcConfigurer ）类但没有 @EnableWebMvc 。如果您希望提供RequestMappingHandlerMapping ， RequestMappingHandlerAdapter 或ExceptionHandlerExceptionResolver 的自定义实例，则可以声明WebMvcRegistrationsAdapter 实例以提供此类组件。  
如果您想完全控制Spring MVC，可以添加自己的@Configuration 注释@EnableWebMvc 。

## 2、扩展SpringMVC ##

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

例如：视图映射功能，浏览器发送请求，springboot实现请求到相应页面，并且通过模板引擎解析

@Configuration//扩展springmvc功能
    public class MyMvcConfig implements WebMvcConfigurer { 
        //用来做视图映射
        @Override
        public void addViewControllers(ViewControllerRegistry registry) { 
            registry.addViewController("/").setViewName("login");
            registry.addViewController("/index.html").setViewName("login");
            registry.addViewController("/main.html").setViewName("dashboard");
        }

原理：WebMvcAutoConfiguration

// Defined as a nested config to ensure WebMvcConfigurer is not read when not
    	// on the classpath
    	@Configuration
    	@Import(EnableWebMvcConfiguration.class)
    	@EnableConfigurationProperties({  WebMvcProperties.class, ResourceProperties.class })
    	@Order(0)
    	public static class WebMvcAutoConfigurationAdapter implements WebMvcConfigurer { 
    
    		private static final Log logger = LogFactory.getLog(WebMvcConfigurer.class);
    
    		private final ResourceProperties resourceProperties;
    
    		private final WebMvcProperties mvcProperties;
    
    		private final ListableBeanFactory beanFactory;
    
    		private final ObjectProvider<HttpMessageConverters> messageConvertersProvider;
    
    		final ResourceHandlerRegistrationCustomizer resourceHandlerRegistrationCustomizer;

1）、WebMvcAutoConfiguration是SpringMVC的自动配置类

2）、在做其他自动配置时会导入；@Import(**EnableWebMvcConfiguration**.class)

public static class EnableWebMvcConfiguration extends DelegatingWebMvcConfiguration implements ResourceLoaderAware {

DelegatingWebMvcConfiguration
    
    @Configuration
    public class DelegatingWebMvcConfiguration extends WebMvcConfigurationSupport { 
    
    	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，DelegatingWebMvcConfiguration中一个参考实现将所有的WebMvcConfigurer相关配置都来一起调用；

@Override
    	public void configureViewResolvers(ViewResolverRegistry registry) { 
    		for (WebMvcConfigurer delegate : this.delegates) { 
    			delegate.configureViewResolvers(registry);
    		}
    	}

3）、容器中所有的WebMvcConfigurer都会一起起作用；

4）、我们的配置类也会被调用；

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

## 3、全面接管SpringMVC ##

SpringBoot对SpringMVC的自动配置不需要了，所有都是我们自己配置；所有的SpringMVC的自动配置都失效了

**我们需要在配置类中添加@EnableWebMvc即可；**

//使用WebMvcConfigurerAdapter可以来扩展SpringMVC的功能
    @EnableWebMvc
    @Configuration
    public class MyMvcConfig extends WebMvcConfigurer { 
    
        @Override
        public void addViewControllers(ViewControllerRegistry registry) { 
           // super.addViewControllers(registry);
            //浏览器发送 /hello 请求来到 success
            registry.addViewController("/hello").setViewName("success");
        }
    }

原理：

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

1）@EnableWebMvc的核心

@Retention(RetentionPolicy.RUNTIME)
    @Target(ElementType.TYPE)
    @Documented
    @Import(DelegatingWebMvcConfiguration.class)
    public @interface EnableWebMvc { 
    }

2）、

@Configuration
    public class DelegatingWebMvcConfiguration extends WebMvcConfigurationSupport {

3）容器中没有这个组件的时候，这个自动配置类才生效

@Configuration
    @ConditionalOnWebApplication(type = Type.SERVLET)
    @ConditionalOnClass({  Servlet.class, DispatcherServlet.class, WebMvcConfigurer.class })
    @ConditionalOnMissingBean(WebMvcConfigurationSupport.class)
    @AutoConfigureOrder(Ordered.HIGHEST_PRECEDENCE + 10)
    @AutoConfigureAfter({  DispatcherServletAutoConfiguration.class, TaskExecutionAutoConfiguration.class,
    		ValidationAutoConfiguration.class })
    public class WebMvcAutoConfiguration {

4）、@EnableWebMvc将WebMvcConfigurationSupport组件导入进来；

5）、导入的WebMvcConfigurationSupport只是SpringMVC最基本的功能；

## 4、如何修改SpringBoot的默认配置 ##

模式：

1）、SpringBoot在自动配置很多组件的时候，先看容器中有没有用户自己配置的（@Bean、@Component）如果有就用用户配置的，如果没有，才自动配置；如果有些组件可以有多个（ViewResolver）将用户配置的和自己默认的组合起来；

2）、在SpringBoot中会有非常多的xxxConfigurer帮助我们进行扩展配置

3）、在SpringBoot中会有很多的xxxCustomizer帮助我们进行定制配置

更多内容请查看官方文档：https://docs.spring.io/spring-boot/docs/2.1.9.RELEASE/reference/html/boot-features-developing-web-applications.html\#boot-features-spring-mvc-auto-configuration