您好,登錄后才能下訂單哦!
這篇文章主要介紹分析SpringBoot MVC自動配置失效的原因是什么,文中示例代碼介紹的非常詳細,具有一定的參考價值,感興趣的小伙伴們一定要看完!
引出問題
上面是SpringBoot MVC的自動配置,問題是這樣的,當我們需要自己配置MVC時,有三種選擇:
在老版本中我們常用的做法就是繼承WebMvcConfigurerAdapter類,這個類本身是實現了WebMvcConfigurer接口的,因為老版本JDK接口沒有默認方法,直接實現WebMvcConfigurer比較繁瑣,而后來接口可以有默認方法了,WebMvcConfigurerAdapter就被標記為過時了,所以我們現在配置MVC只需要實現WebMvcConfigurer接口或者繼承WebMvcConfigurationSupport,但是后者會導致SpringBoot的配置失效,因為在自動配置類上有@ConditionalOnMissingBean(WebMvcConfigurationSupport.class)這樣一個注解,表示沒有WebMvcConfigurationSupport類及其子類的實例時才會加載自動配置(另外使用@EnableWebMvc注解也會導致自動配置失效)。
MVC自動配置失效的原因就是這個了,基本上所有網上的文章分析到這一步也就完了,但是注意上圖我畫的紅方框,在這個自動配置類中有兩個靜態內部類,我們知道靜態內部類是優于外部類加載的(SpringBoot自動配置大量使用了此特性),而其中EnableWebMvcConfiguration這個類,我注意到它是繼承自DelegatingWebMvcConfiguration,而DelegatingWebMvcConfiguration又繼承自WebMvcConfigurationSupport類,相信看到這你也應該會有疑惑了,為什么這個配置類沒有導致自動配置失效,而我們自己實現的就會?
分析過程
我知道配置類的解析注冊是在ConfigurationClassPostProcessor類中,而這個類我前面的文章多次分析過,雖然這個類的實現流程不難,但細節非常繞,所以之前沒有深挖。遇到這個問題時,我首先想的是對這個類的理解不夠深刻,因此第一時間想到仔細研究這個類,在花費了大量時間斷點分析后,卻沒有太大的收獲。
接著我又想,是不是配置類的注冊順序在自動配置的后面。這里我就犯了一個顯而易見的錯誤,因為我考慮的是注冊的順序,不是實例化。因為ConditionalOnMissingBean注解是沒有指定bean的實例時才會去加載,而我腦海里當時想成了ConditionalOnMissingClass。所以我在DefaultListableBeanFactory中的registerBeanDefinition和preInstantiateSingletons方法上打上了斷點,力圖確認注冊順序如我所想:
public void registerBeanDefinition(String beanName, BeanDefinition beanDefinition) throws BeanDefinitionStoreException { BeanDefinition existingDefinition = this.beanDefinitionMap.get(beanName); if (existingDefinition != null) { .... this.beanDefinitionMap.put(beanName, beanDefinition); } else { if (hasBeanCreationStarted()) { // Cannot modify startup-time collection elements anymore (for stable iteration) synchronized (this.beanDefinitionMap) { this.beanDefinitionMap.put(beanName, beanDefinition); List<String> updatedDefinitions = new ArrayList<>(this.beanDefinitionNames.size() + 1); updatedDefinitions.addAll(this.beanDefinitionNames); updatedDefinitions.add(beanName); this.beanDefinitionNames = updatedDefinitions; removeManualSingletonName(beanName); } } else { // Still in startup registration phase this.beanDefinitionMap.put(beanName, beanDefinition); this.beanDefinitionNames.add(beanName); removeManualSingletonName(beanName); } this.frozenBeanDefinitionNames = null; } } public void preInstantiateSingletons() throws BeansException { List<String> beanNames = new ArrayList<>(this.beanDefinitionNames); .... }
但結果beanDefinitionNames中的順序卻是兩個靜態內部類在前,也就是說靜態內部類肯定是在外部類之前就注冊到IOC容器中了,這下我就傻了。但幸好也是因此,否則我就該認為這就是結果了。最終我想到了應該看類的實例化順序,但是正常情況下類的實例化順序就是上面的斷點圖中的順序,我想會不會是有什么類依賴了WebMvcAutoConfiguration,導致它提前實例化。于是我將斷點又設置到AbstractBeanFactory中的doGetBean方法并加上了條件(不得不說idea的功能非常強大,回到上一個調用點、給斷點設置條件、調用堆棧信息大大節省了我的調試時間):
然后啟動項目就可以看到首先實例化的果然是WebMvcAutoConfiguration類,這樣就搞清楚了為什么EnableWebMvcConfiguration沒有導致自動配置失效。
但是還沒完,為什么自動配置類會在靜態內部類之前實例化呢?是由誰觸發的呢?繼續深入,這時我想到了看調用棧:
粗略看一下調用棧信息,如果對Spring源碼熟悉,可以發現自動配置類的實例化是在instantiateUsingFactoryMethod中觸發的:
String factoryBeanName = mbd.getFactoryBeanName(); if (factoryBeanName != null) { if (factoryBeanName.equals(beanName)) { throw new BeanDefinitionStoreException(mbd.getResourceDescription(), beanName, "factory-bean reference points back to the same bean definition"); } factoryBean = this.beanFactory.getBean(factoryBeanName); if (mbd.isSingleton() && this.beanFactory.containsSingleton(beanName)) { throw new ImplicitlyAppearedSingletonException(); } factoryClass = factoryBean.getClass(); isStatic = false; } else { // It's a static factory method on the bean class. if (!mbd.hasBeanClass()) { throw new BeanDefinitionStoreException(mbd.getResourceDescription(), beanName, "bean definition declares neither a bean class nor a factory-bean reference"); } factoryBean = null; factoryClass = mbd.getBeanClass(); isStatic = true; }
這段代碼在bean實例化的那一篇分析過,這個方法的作用是通過factoryMethod實例化當前的BeanDefinition,而實例化該BD優先會實例化factoryBeanName屬性指向的Bean,這里的factoryBeanName就是org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfiguration,factoryMethod則是formContentFilter,而這兩個屬性的設置則是在ConfigurationClassPostProcessor解析@Configuration和@Bean就設置好了(@Bean標注的方法名會設置到factoryMethod,而該方法所在配置類的名稱就是factoryBeanName),這里就不展開分析了。
@Configuration(proxyBeanMethods = false) @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 { public static final String DEFAULT_PREFIX = ""; public static final String DEFAULT_SUFFIX = ""; private static final String[] SERVLET_LOCATIONS = { "/" }; @Bean @ConditionalOnMissingBean(HiddenHttpMethodFilter.class) @ConditionalOnProperty(prefix = "spring.mvc.hiddenmethod.filter", name = "enabled", matchIfMissing = false) public OrderedHiddenHttpMethodFilter hiddenHttpMethodFilter() { return new OrderedHiddenHttpMethodFilter(); } @Bean @ConditionalOnMissingBean(FormContentFilter.class) @ConditionalOnProperty(prefix = "spring.mvc.formcontent.filter", name = "enabled", matchIfMissing = true) public OrderedFormContentFilter formContentFilter() { return new OrderedFormContentFilter(); } ...... }
formContentFilter就是在MVC自動配置類中配置的,默認是加載的,而filter就不用多說了,在Tomcat啟動后就會觸發初始化,追蹤調用棧也可以看到。另外我們還看到自動配置類中還配置了一個HiddenHttpMethodFilter,不過這個默認是不加載的,所以我們只要在application.properties中配置了如下屬性,自動配置類就不會實例化了,但是兩個靜態內部類的實例化還是不會受影響的。
spring.mvc.formcontent.filter.enabled=false
以上是分析SpringBoot MVC自動配置失效的原因是什么的所有內容,感謝各位的閱讀!希望分享的內容對大家有幫助,更多相關知識,歡迎關注億速云行業資訊頻道!
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。