Spring和SpringMVC父子容器關係初窺

一、背景


最近由於項目的包掃描出現了問題,在解決問題的過程中,偶然發現了Spring和SpringMVC是有父子容器關係的,而且正是因爲這個才往往會出現包掃描的問題,我們在此來分析和理解Spring和SpringMVC的父子容器關係並且給出Spring和SpringMVC配置文件中包掃描的官方推薦方式。


二、概念理解和知識鋪墊


在Spring整體框架的核心概念中,容器是核心思想,就是用來管理Bean的整個生命週期的,而在一個項目中,容器不一定只有一個,Spring中可以包括多個容器,而且容器有上下層關係


目前最常見的一種場景就是在一個項目中引入Spring和SpringMVC這兩個框架,那麼它其實就是兩個容器,Spring是父容器,SpringMVC是其子容器


並且在Spring父容器中註冊的Bean對於SpringMVC容器中是可見的,而在SpringMVC容器中註冊的Bean對於Spring父容器中是不可見的,也就是子容器可以看見父容器中的註冊的Bean,反之就不行。


我們可以使用統一的如下註解配置來對Bean進行批量註冊,而不需要再給每個Bean單獨使用xml的方式進行配置。


<context:component-scan base-package="com.hafiz.www" />


從Spring提供的參考手冊中我們得知該配置的功能是掃描配置的base-package包下的所有使用了@Component註解的類,並且將它們自動註冊到容器中,同時也掃描@Controller,@Service,@Respository這三個註解,因爲他們是繼承自@Component


在項目中我們經常見到還有如下這個配置,其實有了上面的配置,這個是可以省略掉的,因爲上面的配置會默認打開以下配置。


以下配置會默認聲明瞭@Required、@Autowired、 @PostConstruct、@PersistenceContext、@Resource、@PreDestroy等註解


<context:annotation-config/>


另外,還有一個和SpringMVC相關如下配置,經過驗證,這個是SpringMVC必須要配置的,因爲它聲明瞭@RequestMapping、@RequestBody、@ResponseBody等。並且,該配置默認加載很多的參數綁定方法,比如json轉換解析器等。


<mvc:annotation-driven />


而上面這句配置Spring3.1之前的版本和以下配置方式等價


<!--配置註解控制器映射器,它是SpringMVC中用來將Request請求URL到映射到具體Controller-->
<bean class="org.springframework.web.servlet.mvc.annotation.DefaultAnnotationHandlerMapping"/>
<!--配置註解控制器映射器,它是SpringMVC中用來將具體請求映射到具體方法-->
<bean class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter"/>


Spring3.1之後的版本和以下配置方式等價


<!--配置註解控制器映射器,它是SpringMVC中用來將Request請求URL到映射到具體Controller-->
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"/>
<!--配置註解控制器映射器,它是SpringMVC中用來將具體請求映射到具體方法-->
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"/>


如果你依然在編程的世界裏迷茫,不知道自己的未來規劃,可以加入JAVA架構學習交流羣:835544715 裏面可以與大神一起交流並走出迷茫。進羣免費領取學習資料,看看前輩們是如何在編程的世界裏傲然前行!羣裏不停更新最新的教程和學習方法(進羣送JAVA架構視頻資料),有想學習JAVA的,或是轉行,還有工作中想提升自己能力的,正在學習的小夥伴歡迎加入學習


三、具體場景分析


下面讓我們來詳細扒一扒Spring與SpringMVC的容器衝突的原因到底在那裏?


我們共有Spring和SpringMVC兩個容器,它們的配置文件分別爲applicationContext.xml和applicationContext-MVC.xml


1、在applicationContext.xml中配置了<context:component-scan base-package=“com.hafiz.www" />,負責所有需要註冊的Bean的掃描和註冊工作


2、在applicationContext-MVC.xml中配置<mvc:annotation-driven />,負責SpringMVC相關注解的使用


3、啓動項目我們發現SpringMVC無法進行跳轉,將log的日誌打印級別設置爲DEBUG進行調試,發現SpringMVC容器中的請求好像沒有映射到具體controller中


4、在applicationContext-MVC.xml中配置<context:component-scan base-package=“com.hafiz.www" />,重啓後,驗證成功,springMVC跳轉有效


下面我們來查看具體原因,翻看源碼,從SpringMVC的DispatcherServlet開始往下找,我們發現SpringMVC初始化時,會尋找SpringMVC容器中的所有使用了@Controller註解的Bean,來確定其是否是一個handler


1、2兩步的配置使得當前SpringMVC容器中並沒有註冊帶有@Controller註解的Bean,而是把所有帶有@Controller註解的Bean都註冊在Spring這個父容器中了,所以SpringMVC找不到處理器,不能進行跳轉。核心源碼如下:


protected void initHandlerMethods() {
if (logger.isDebugEnabled()) {
logger.debug("Looking for request mappings in application context: " + getApplicationContext());
}
String[] beanNames = (this.detectHandlerMethodsInAncestorContexts ?
 BeanFactoryUtils.beanNamesForTypeIncludingAncestors(getApplicationContext(), Object.class) :
getApplicationContext().getBeanNamesForType(Object.class));
for (String beanName : beanNames) {
if (isHandler(getApplicationContext().getType(beanName))){
detectHandlerMethods(beanName);
}
}
handlerMethodsInitialized(getHandlerMethods());
}


在方法isHandler中會判斷當前bean的註解是否是controller,源碼如下:


protected boolean isHandler(Class<?> beanType{
return AnnotationUtils.findAnnotation(beanType, Controller.class) != null;
}


而在第4步配置中,SpringMVC容器中也註冊了所有帶有@Controller註解的Bean,故SpringMVC能找到處理器進行處理,從而正常跳轉。


我們找到了出現不能正確跳轉的原因,那麼它的解決辦法是什麼呢?


我們注意到在initHandlerMethods()方法中,detectHandlerMethodsInAncestorContexts這個Switch,它主要控制獲取哪些容器中的bean以及是否包括父容器,默認是不包括的。


所以解決辦法就是在SpringMVC的配置文件中配置HandlerMapping的detectHandlerMethodsInAncestorContexts屬性爲true即可(這裏需要根據具體項目看使用的是哪種HandlerMapping),讓它檢測父容器的bean。如下:


<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping">
   <property name="detectHandlerMethodsInAncestorContexts">
      <value>true</value>
  </property>

</bean>


但在實際工程中會包括很多配置,我們按照官方推薦根據不同的業務模塊來劃分不同容器中註冊不同類型的Bean:


Spring父容器負責所有其他非@Controller註解的Bean的註冊,而SpringMVC只負責@Controller註解的Bean的註冊,使得他們各負其責、明確邊界。配置方式如下


1、在applicationContext.xml中配置:


<!-- Spring容器中註冊非@controller註解的Bean -->
<context:component-scan base-package="com.hafiz.www">
  <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
</context:component-scan>


2、applicationContext-MVC.xml中配置


<!-- SpringMVC容器中只註冊帶有@controller註解的Bean -->
<context:component-scan base-package="com.hafiz.www" use-default-filters="false">
   <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller" />
</context:component-scan>


想要學習Java高架構、分佈式架構、高可擴展、高性能、高併發、性能優化、Spring boot、Redis、ActiveMQ、Nginx、Mycat、Netty、Jvm大型分佈式項目實戰學習架構師視頻免費獲取   架構羣:835544715


三、總結


這樣我們在清楚了Spring和SpringMVC的父子容器關係、以及掃描註冊的原理以後,根據官方建議我們就可以很好把不同類型的Bean分配到不同的容器中進行管理。再出現Bean找不到或者SpringMVC不能跳轉以及事務的配置失效的問題,我們就可以很快的定位以及解決問題了。很開心,有木有~

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章