一、背景

最近由于項目的包掃描出現(xiàn)了問題，在解決問題的過程中，偶然發(fā)現(xiàn)了Spring和SpringMVC是有父子容器關(guān)系的，而且正是因為這個才往往會出現(xiàn)包掃描的問題，我們在此來分析和理解Spring和SpringMVC的父子容器關(guān)系并且給出Spring和SpringMVC配置文件中包掃描的官方推薦方式。

二、概念理解和知識鋪墊

在Spring整體框架的核心概念中，容器是核心思想，就是用來管理Bean的整個生命周期的，而在一個項目中，容器不一定只有一個，Spring中可以包括多個容器，而且容器有上下層關(guān)系，目前最常見的一種場景就是在一個項目中引入Spring和SpringMVC這兩個框架，那么它其實就是兩個容器，Spring是父容器，SpringMVC是其子容器，并且在Spring父容器中注冊的Bean對于SpringMVC容器中是可見的，而在SpringMVC容器中注冊的Bean對于Spring父容器中是不可見的，也就是子容器可以看見父容器中的注冊的Bean，反之就不行。

我們可以使用統(tǒng)一的如下注解配置來對Bean進(jìn)行批量注冊，而不需要再給每個Bean單獨使用xml的方式進(jìn)行配置。

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

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

在項目中我們經(jīng)常見到還有如下這個配置，其實有了上面的配置，這個是可以省略掉的，因為上面的配置會默認(rèn)打開以下配置。以下配置會默認(rèn)聲明了@Required、@Autowired、 @PostConstruct、@PersistenceContext、@Resource、@PreDestroy等注解。

<context:annotation-config/>

另外，還有一個和SpringMVC相關(guān)如下配置，經(jīng)過驗證，這個是SpringMVC必須要配置的，因為它聲明了@RequestMapping、@RequestBody、@ResponseBody等。并且，該配置默認(rèn)加載很多的參數(shù)綁定方法，比如json轉(zhuǎn)換解析器等。

<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"/>

三、具體場景分析

下面讓我們來詳細(xì)扒一扒Spring與SpringMVC的容器沖突的原因到底在那里？

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

1.在applicationContext.xml中配置了<context:component-scan base-package=“com.hafiz.www" />，負(fù)責(zé)所有需要注冊的Bean的掃描和注冊工作。

2.在applicationContext-MVC.xml中配置<mvc:annotation-driven />，負(fù)責(zé)SpringMVC相關(guān)注解的使用。

3.啟動項目我們發(fā)現(xiàn)SpringMVC無法進(jìn)行跳轉(zhuǎn)，將log的日志打印級別設(shè)置為DEBUG進(jìn)行調(diào)試，發(fā)現(xiàn)SpringMVC容器中的請求好像沒有映射到具體controller中。

4.在applicationContext-MVC.xml中配置<context:component-scan base-package=“com.hafiz.www" />，重啟后，驗證成功，springMVC跳轉(zhuǎn)有效。

下面我們來查看具體原因，翻看源碼，從SpringMVC的DispatcherServlet開始往下找，我們發(fā)現(xiàn)SpringMVC初始化時，會尋找SpringMVC容器中的所有使用了@Controller注解的Bean，來確定其是否是一個handler。1,2兩步的配置使得當(dāng)前springMVC容器中并沒有注冊帶有@Controller注解的Bean，而是把所有帶有@Controller注解的Bean都注冊在Spring這個父容器中了，所以springMVC找不到處理器，不能進(jìn)行跳轉(zhuǎn)。核心源碼如下:

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中會判斷當(dāng)前bean的注解是否是controller，源碼如下：

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

而在第4步配置中，SpringMVC容器中也注冊了所有帶有@Controller注解的Bean，故SpringMVC能找到處理器進(jìn)行處理，從而正常跳轉(zhuǎn)。

我們找到了出現(xiàn)不能正確跳轉(zhuǎn)的原因，那么它的解決辦法是什么呢？

我們注意到在initHandlerMethods()方法中，detectHandlerMethodsInAncestorContexts這個Switch，它主要控制獲取哪些容器中的bean以及是否包括父容器，默認(rèn)是不包括的。所以解決辦法就是在springMVC的配置文件中配置HandlerMapping的detectHandlerMethodsInAncestorContexts屬性為true即可（這里需要根據(jù)具體項目看使用的是哪種HandlerMapping），讓它檢測父容器的bean。如下：

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

但在實際工程中會包括很多配置，我們按照官方推薦根據(jù)不同的業(yè)務(wù)模塊來劃分不同容器中注冊不同類型的Bean：Spring父容器負(fù)責(zé)所有其他非@Controller注解的Bean的注冊，而SpringMVC只負(fù)責(zé)@Controller注解的Bean的注冊，使得他們各負(fù)其責(zé)、明確邊界。配置方式如下

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>

三、總結(jié)

這樣我們在清楚了spring和springMVC的父子容器關(guān)系、以及掃描注冊的原理以后，根據(jù)官方建議我們就可以很好把不同類型的Bean分配到不同的容器中進(jìn)行管理。再出現(xiàn)Bean找不到或者SpringMVC不能跳轉(zhuǎn)以及事務(wù)的配置失效的問題，我們就可以很快的定位以及解決問題了。很開心，有木有~

以上就是本文的全部內(nèi)容，希望對大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評論