springboot 添加mvc功能

先放出來(lái)幾個(gè)類(包含注解或接口)來(lái)觀摩一下

• WebMvcConfigurer
• @EnableWebMvc
• WebMvcConfigurerAdapter（已過(guò)時(shí)，不再詳述，可以理解為繼承該類有和實(shí)現(xiàn)WebMvcConfigurer一樣的效果）
• WebMvcConfigurationSupport
• WebApplicationInitializer

這里只聊springboot或者無(wú)web.xml環(huán)境的情況，無(wú)論如何得看一下這個(gè)祖宗，以下代碼來(lái)源于spring官網(wǎng)

public class MyWebApplicationInitializer implements WebApplicationInitializer {
    @Override
    public void onStartup(ServletContext servletCxt) {
        // Load Spring web application configuration
        AnnotationConfigWebApplicationContext ac = new AnnotationConfigWebApplicationContext();
        ac.register(AppConfig.class);
        ac.refresh();

        // Create and register the DispatcherServlet
        DispatcherServlet servlet = new DispatcherServlet(ac);
        ServletRegistration.Dynamic registration = servletCxt.addServlet("app", servlet);
        registration.setLoadOnStartup(1);
        registration.addMapping("/app/*");
    }
}

這個(gè)是一切無(wú)配置文件spring和springmvc整合的基礎(chǔ)，用來(lái)替代原始的web.xml中的ContextLoadListener和DispatcherServlet，兩者效果等同；

現(xiàn)在我們先基于上述代碼的情況來(lái)說(shuō)，請(qǐng)注意以下結(jié)論的前提是基于上述示例代碼，很重要，其實(shí)就像是很久之前我們從零開(kāi)始搭建整合方案一樣，現(xiàn)在只是配置了整合的類，還沒(méi)有功能，如果我們想要再配置一個(gè)json的消息轉(zhuǎn)換器

那么我們就會(huì)有如下幾種方案

• 繼承WebMvcConfigurationSupport
• 實(shí)現(xiàn)WebMvcConfigurer
• 繼承WebMvcConfigurerAdapter（已過(guò)時(shí)不再詳述）

繼承WebMvcConfigurationSupport和實(shí)現(xiàn)WebMvcConfigurer的區(qū)別如下

• WebMvcConfigurationSupport直接繼承并使用@Configuration標(biāo)識(shí)即可，而實(shí)現(xiàn)WebMvcConfigurer則需要標(biāo)識(shí)為注解@Configuration以外還需要使用注解@EnableWebMvc標(biāo)識(shí)才可，所以一個(gè)項(xiàng)目中可以有多個(gè)地方去實(shí)現(xiàn)這個(gè)接口，只要標(biāo)識(shí)為配置類。然后在一處地方開(kāi)啟@EnableWebMvc就可。這里提前說(shuō)一下如果是springboot環(huán)境這里還大有說(shuō)頭,這里還有個(gè)大坑，留在后面說(shuō)
• WebMvcConfigurationSupport更偏向底層，可以定制化的功能更多，而WebMvcConfigurer是一個(gè)接口，是針對(duì)WebMvcConfigurationSupport功能將一些常用的功能選擇性的暴露出來(lái)，實(shí)際上WebMvcConfigurer是依賴于WebMvcConfigurationSupport來(lái)實(shí)現(xiàn)功能添加的

為什么說(shuō)WebMvcConfigurer是依賴于WebMvcConfigurationSupport來(lái)實(shí)現(xiàn)功能添加的？我們來(lái)看一下配合該接口的注解@EnableWebMvc源碼

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

來(lái)看一下這個(gè)注解導(dǎo)入的配置類DelegatingWebMvcConfiguration為何物？以下摘取該類部分源碼

@Configuration
public class DelegatingWebMvcConfiguration extends WebMvcConfigurationSupport {
 private final WebMvcConfigurerComposite configurers = new WebMvcConfigurerComposite();
 @Autowired(required = false)
 public void setConfigurers(List<WebMvcConfigurer> configurers) {
  if (!CollectionUtils.isEmpty(configurers)) {
   this.configurers.addWebMvcConfigurers(configurers);
  }
 }
}

首先這個(gè)配置類其實(shí)就是我們上面最開(kāi)始說(shuō)的用繼承來(lái)擴(kuò)展功能的WebMvcConfigurationSupport,那么為什么實(shí)現(xiàn)WebMvcConfigurer接口也行？注意看上圖中的代碼，提供了一個(gè)configurers屬性， 然后通過(guò)setConfigurers方法注入將ioc容器中的所有實(shí)現(xiàn)了WebMvcConfigurer接口的配置類都添加到configurers中；后續(xù)實(shí)現(xiàn)代碼不是本章討論范圍，我也沒(méi)有往下看，單看這里其實(shí)就已經(jīng)明白了。

**上述是整合的基礎(chǔ)，那么當(dāng)我們?cè)趕pringboot中要添加功能的時(shí)候要注意一些什么事情呢？**這個(gè)也是寫這篇文章的目的，因?yàn)樽罱陧?xiàng)目中有人在擴(kuò)展功能的時(shí)候去繼承了WebMvcConfigurationSupport這個(gè)類，然后聯(lián)想到之前的項(xiàng)目也有人在springboot項(xiàng)目中使用了注解@EnableWebMvc，這兩種情況都不會(huì)導(dǎo)致項(xiàng)目啟動(dòng)報(bào)錯(cuò)，但卻在不該使用的時(shí)候使用了這些功能，導(dǎo)致了項(xiàng)目其實(shí)是不能正常使用的。現(xiàn)在來(lái)看一下為什么？

首先看一下springboot給我們提供的自動(dòng)整合類，請(qǐng)參考類

org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfiguration

我來(lái)截取部分代碼

@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 {    
    
    @Configuration
 @Import(EnableWebMvcConfiguration.class)
 @EnableConfigurationProperties({ WebMvcProperties.class, ResourceProperties.class })
 @Order(0)
 public static class WebMvcAutoConfigurationAdapter implements WebMvcConfigurer, ResourceLoaderAware {
    }    
     /**
  * Configuration equivalent to {@code @EnableWebMvc}.
  */
 @Configuration
 public static class EnableWebMvcConfiguration extends DelegatingWebMvcConfiguration {
    }
}

現(xiàn)在說(shuō)一下結(jié)論，springboot為我們提供的整合功能，已經(jīng)默認(rèn)的幫我們添加了很多功能，如消息轉(zhuǎn)換器，靜態(tài)資源映射，視圖解析器，看下WebMvcAutoConfiguration的內(nèi)部類WebMvcAutoConfigurationAdapter，其實(shí)就是實(shí)現(xiàn)了接口WebMvcConfigurer，然后再通過(guò)注解@Import(EnableWebMvcConfiguration.class)又將EnableWebMvcConfiguration這個(gè)配置類導(dǎo)入了進(jìn)來(lái)，而我們點(diǎn)進(jìn)去發(fā)現(xiàn)這個(gè)類的作用其實(shí)就是等同于之前我們說(shuō)過(guò)的@EnableWebMvc。因此我們說(shuō)的消息轉(zhuǎn)換器啊，靜態(tài)資源映射，視圖解析器等這些默認(rèn)實(shí)現(xiàn)就在WebMvcAutoConfiguration的內(nèi)部類WebMvcAutoConfigurationAdapter又通過(guò)@Bean注入進(jìn)來(lái)的

也就是說(shuō)springboot其實(shí)幫我們整合好之后又默認(rèn)幫我們做了一切常用的實(shí)現(xiàn)，這樣我們開(kāi)箱即用的不僅是整合好的框架，還有一些約定大于配置的功能，如靜態(tài)資源要放在static下，其實(shí)就是默認(rèn)幫我們做了資源映射，詳細(xì)可以看下

org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfiguration.WebMvcAutoConfigurationAdapter#addResourceHandlers

默認(rèn)整合的功能基本滿足于我們?nèi)粘５拈_(kāi)發(fā)，而如果我們還需要添加功能要怎么辦呢？其實(shí)就是直接實(shí)現(xiàn)接口WebMvcConfigurer然后將當(dāng)前類使用注解@Configuration標(biāo)識(shí)為配置類即可。

那么為什么不能再繼續(xù)繼承接口WebMvcConfigurationSupport了呢？還是來(lái)看一下我們的自動(dòng)配置類WebMvcAutoConfiguration吧,仔細(xì)看一下上面的配置類上的條件表達(dá)式中有這么一句非常非常重要的@ConditionalOnMissingBean(WebMvcConfigurationSupport.class)，

上面我們所屬的所有整合功能的前提是當(dāng)前ioc容器中沒(méi)有WebMvcConfigurationSupport這個(gè)bean，我們看到了springboot自己的實(shí)現(xiàn)是在當(dāng)前自動(dòng)配置類生效的時(shí)候才通過(guò)實(shí)現(xiàn)接口WebMvcConfigurer的，所以容器中在當(dāng)前配置類未執(zhí)行之前也是沒(méi)有這個(gè)WebMvcConfigurationSupport的，現(xiàn)在我們突然在項(xiàng)目中添加功能的時(shí)候去繼承了這個(gè)類，然后標(biāo)識(shí)為配置類之后，立馬在容器中就出現(xiàn)了這個(gè)bean，然后springboot就會(huì)以為我們要全面接管整合springmvc，我們要拋棄它的默認(rèn)實(shí)現(xiàn)，然后自己玩。然后就悲劇了?，F(xiàn)在整個(gè)mvc中反而只有我們自己新加的這個(gè)擴(kuò)展空間了。這在絕大多數(shù)情況下根本不是我們想要的。

還有一個(gè)問(wèn)題，為什么加注解@EnableWebMvc也不行？

其實(shí)通過(guò)上面的講解我們已經(jīng)能夠看出來(lái)，這個(gè)注解其實(shí)就是導(dǎo)入了DelegatingWebMvcConfiguration這個(gè)配置類，而這個(gè)類就是繼承WebMvcConfigurationSupport的，這兩個(gè)效果是相同的，所以也不行。

總而言之一句話，在WebMvcAutoConfiguration這個(gè)配置類執(zhí)行之前，無(wú)論是繼承WebMvcConfigurationSupport還是在某個(gè)配置類上添加了注解@EnableWebMvc，都會(huì)導(dǎo)致容器中會(huì)被注入類型為WebMvcConfigurationSupport的bean，而springboot在實(shí)現(xiàn)自動(dòng)配置時(shí)將這種行為定義成了你要自己去實(shí)現(xiàn)``

以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。

最新評(píng)論