Springboot 对 Springmvc 的扩展

我们查看 Springboot 官方文档,里面有关于对 Springmvc 的扩展介绍

后面这段话的意思是: 如果你想保留 Spring Boot MVC 的功能,并且你希望添加其它的 MVC 配置(拦截器、格式化器、视图控制器、和其它的功能),你可以添加自己的 @Configuration 配置类,并且让该配置类实现 WebMvcConfigurer 接口,但是不要在该配置类上添加 @EnableWebMvc 注解,如果你想要 RequestMappingHandlerMapping、RequestMappingHandlerAdapter、ExeceptionHandlerExceptionResolver 的定制实例,可以声明一个 WebMvcRegistrationsAdapter 实例来提供上面这些组件.

如果你想全面接管 Spring MVC ,那么你可以添加带有 @EnableWebMvc、@Configuration 注解的配置类

关于 @EnableWebMvc 注解的作用,可以参考一下这篇博客 https://www.cnblogs.com/xiaomaomao/p/13998924.html

按照上面的提示,创建一个配置类并实现 WebMvcConfigurer 接口(当然也可以继承 WebMvcConfigurerAdapter 这个抽象类,其实是同一个意思,因为WebMvcConfigurerAdapter 也是 WebMvcConfigurer 的实现类)

/**
 * 1、这里我们可以实现 WebMvcConfigurer 接口,并重写其中的方法来完成 springmvc 的扩展功能
 * 2、也可以继承 WebMvcConfigurerAdapter 抽象类,其实 WebMvcConfigurerAdapter 也是实现了
 * WebMvcConfigurer 接口
 */
@Configuration
public class MyWebMvcConfig extends WebMvcConfigurerAdapter {
    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        // 浏览器访问 localhost:8080/ 时,会跳转到视图 resources/templates/success.html 页面
        registry.addViewController("/xiaomao").setViewName("xiaomao/success");
        // 浏览器访问 localhost:8080/xiaomaomao 时,会跳转到视图 resources/templates/success.html 页面
        registry.addViewController("/xiaomaomao").setViewName("xiaomao/success");
    }
}

 下面这种方式也具有相同的作用

@Bean
public WebMvcConfigurerAdapter webMvcConfigurerAdapter() {

	WebMvcConfigurerAdapter adapter = new WebMvcConfigurerAdapter() {
	@Override
	public void addViewControllers(ViewControllerRegistry registry) {
		// 浏览器访问 localhost:8080/ 时,会跳转到视图 resources/templates/success.html 页面
		registry.addViewController("/").setViewName("xiaomao/login");
		// 浏览器访问 localhost:8080/xiaomaomao 时,会跳转到视图 resources/templates/success.html 页面
		registry.addViewController("/xiaomao").setViewName("xiaomao/login");
		}
	};
	return adapter;
}

原理:

我们都知道 springboot 对 springmvc 的自动配置相关信息都在 WebMvcConfiguration 这个类里面,点进去这个类可以看到里面有一个静态内部类 WebMvcAutoConfigurationAdapter

// 标记这是一个配置类
@Configuration
// 如果当前是 web 应用
@ConditionalOnWebApplication
// 如果存在 Servlet、DispatcherServlet、WebMvcConfigurerAdapter 这些类
@ConditionalOnClass({ Servlet.class, DispatcherServlet.class,WebMvcConfigurerAdapter.class })
// 如果应用中不存在 WebMvcConfigurationSupport 这个类
@ConditionalOnMissingBean(WebMvcConfigurationSupport.class)
// 自动配置顺序
@AutoConfigureOrder(Ordered.HIGHEST_PRECEDENCE + 10)
@AutoConfigureAfter({ DispatcherServletAutoConfiguration.class,ValidationAutoConfiguration.class })
// springboot 对于 springmvc 的自动配置都在这个类里面
public class WebMvcAutoConfiguration {
	...
	@Configuration
	@Import(EnableWebMvcConfiguration.class)
	@EnableConfigurationProperties({ WebMvcProperties.class, ResourceProperties.class })
	// WebMvcAutoConfigurationAdapter 是 WebMvcAutoConfiguration 的静态内部类
	// 它继承了 WebMvcConfigurerAdapter 这个抽象类,看到这个类是不是有点熟悉,我们对 springmvc 进行扩展的
	// 时候也是继承的这个类
	public static class WebMvcAutoConfigurationAdapter extends WebMvcConfigurerAdapter {
	...
	}
}

那么 WebMvcAutoConfigurationAdapter 这个配置类起作用的应该是  @Import(EnableWebMvcConfiguration.class),点进去 EnableWebMvcConfiguration 这个类看一下

@Configuration
public static class EnableWebMvcConfiguration extends DelegatingWebMvcConfiguration {
	private final WebMvcProperties mvcProperties;
	private final ListableBeanFactory beanFactory;
	private final WebMvcRegistrations mvcRegistrations;
	...
}

发现这个类继承了 DelegatingWebMvcConfiguration ,继续点进去看

@Configuration
public class DelegatingWebMvcConfiguration extends WebMvcConfigurationSupport {
// WebMvc 配置综合类
private final WebMvcConfigurerComposite configurers = new WebMvcConfigurerComposite();

// 方法上使用 @Atuowired 注解,如果该方法有参数,那么参数会从 IOC 容器中去取
@Autowired(required = false)
// 那么容器中所有的 WebMvcConfigurer 都会赋值给 configurers 这个参数
public void setConfigurers(List<WebMvcConfigurer> configurers) {
	if (!CollectionUtils.isEmpty(configurers)) {
		// 调用 WebMvcConfigurerComposite 的 addWebMvcConfigurers() 方法
		this.configurers.addWebMvcConfigurers(configurers);
	}
}

点进去 addWebMvcConfigurers(List<WebMvcConfigurer configurers) 方法进行查看

class WebMvcConfigurerComposite implements WebMvcConfigurer {

	private final List<WebMvcConfigurer> delegates = new ArrayList<WebMvcConfigurer>();

	public void addWebMvcConfigurers(List<WebMvcConfigurer> configurers) {
		if (!CollectionUtils.isEmpty(configurers)) {
			// 将 IOC 容器中所有的 WebMvcConfigurer 都赋值给了 delegates 这个 List 集合
			this.delegates.addAll(configurers);
		}
	}
}

我们可以在 DelegatingWebMvcConfiguration 类中去寻找一个我们刚才设置的 addViewControllers() 当做参考，发现它调用了 WebMvcConfigurerComposite 的addViewControllers()方法 

@Override
public void addViewControllers(ViewControllerRegistry registry) {
	// delegates 就是我们从 IOC 容器中取出来的所有的 WebMvcConfigurer
	for (WebMvcConfigurer delegate : this.delegates) {
		// 对每个 WebMvcConfigurer 都执行 addViewControllers 操作
		delegate.addViewControllers(registry);
	}
}

这样,所有的 WebMvcConfigurer 都执行了 addViewControllers 操作(包括我们自定义的和 springboot 默认对 mvc 的配置)