SpringMVC請求流程原始碼分析-有解無憂

一、SpringMVC使用

1.工程創建

創建maven工程，
添加java、resources目錄，
引入Spring-webmvc 依賴，

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>5.3.4</version>
</dependency>

洗掉 src/main/webapp/WEB-INF/web.xml 組態檔，從tomcat的示例工程中找一份web.xml替換，這里推薦從\webapps\ROOT\WEB-INF中拿，并且在其中添加context的監聽器和servlet配置，配置如下，

<!--Context 加載監聽器 -->
<listener>
     <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<servlet>
     <servlet-name>dispatcherServlet</servlet-name>
     <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
     <init-param>
     	 <param-name>contextConfigLocation</param-name>
         <param-value>classpath:application.xml</param-value>
     </init-param>
     <!--Web服務器一旦啟動，Servlet就會實體化創建物件，然后初始化(預備創建物件)-->
     <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

在 resources 目錄中創建springmvc.xml檔案，并添加如下配置：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
                           http://www.springframework.org/schema/beans/spring-beans.xsd
                           http://www.springframework.org/schema/context
                           http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc https://www.springframework.org/schema/mvc/spring-mvc.xsd">
    <!--配置spring包掃描路徑，被@Component、@Controller、@Service、@Repository標注的類都會交由Spring托管一個Bean-->
    <context:component-scan base-package="com.ybe.*"/>
    <!--配置視圖決議器-->
    <bean >
        <property name="prefix" value="https://www.cnblogs.com/"/>
        <property name="suffix" value="https://www.cnblogs.com/yuanbeier/archive/2022/05/29/.jsp"></property>
    </bean>
</beans>

在 src/main/webapp/WEB-INF/下添加 applicationContext.xml檔案，配置如下：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
                           http://www.springframework.org/schema/beans/spring-beans.xsd
                           http://www.springframework.org/schema/context
                           http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc https://www.springframework.org/schema/mvc/spring-mvc.xsd">
</beans>

創建Controller類，代碼如下：

package com.ybe.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class HelloController {

    @RequestMapping("/hello")
    public String helloWorld(){
        System.out.println("hello world");
        return "index";
    }
}

2.工程配置

點擊Add Configurations或者Run->Add Configurations，
配置本地tomcat的目錄
配置瀏覽器地址，點擊上圖左上角的 + 號，選擇Tomcat Server選項后，點擊 Deployment 選項，點擊右邊的 + 號，
選擇Artifacts后，選擇springMvcTest:war，

3.啟動工程

二、SpringMVC啟動程序

? SpringMVC是依賴Java的Web容器技術，整個springmvc的啟動程序是建立在Servlet技識訓礎上的，SpringMVC借助Web容器和Servelt的生命周期進行了擴展，父容器的初始化在 ContextLoaderListener 類中initWebApplicationContext方法進行，子容器的初始化在 DispatcherServlet 中init方法中進行，

1.父容器啟動程序

? 如果web.xml中配置了ContextLoaderListener監聽器，則web容器啟動的時候先會呼叫監聽器ContextLoaderListener的initWebApplicationContext方法，整個程序如下圖：

? initWebApplicationContext中的整個程序就是創建了一個spring容器（父容器），并且根據springApplication.xml的配置內容往Spring容器中注入Bean物件，最后把spring容器（this.context物件）放入serveltContext 的屬性中，

2.子容器啟動程序（SpringMvc容器）

? DispatcherServlet 是在web.xml組態檔中配置的Servlet類,是SpringMVC的請求分發核心類，所有的請求都由DispatcherServlet去分發處理，

? DispatcherServlet 的繼承關系如下圖：

? 上圖可知DispatcherServlet 繼承了HttpServletBean，在HttpServletBean中重寫了init()，Web容器啟動的時候會根據組態檔中定義的Servlet進行創建，并且會根據配置項（load-on-startup）覺定在什么時候呼叫Servlet的init方法，init方法在整個Servlet的生命周期中只會呼叫一次，初始化init方法的主體實作程序如下：

1.WebApplicationContextUtils.getWebApplicationContext(getServletContext()) 從ServletContext中獲取屬性為WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE的物件，即Spring父容器物件，

2.wac.addApplicationListener(new SourceFilteringListener(wac, new ContextRefreshListener()))，給子容器添加應用監聽器，該監聽器在后面的finishRefresh()方法中進行觸發，方法里面封裝了初始化SpringMVC中九大組件的邏輯，

3.publishEvent(new ContextRefreshedEvent(this))發布Context重繪事件，會觸發SourceFilteringListener監聽器，最終進行initStrategies的呼叫，

3.九大組件的初始化

initStrategies是SpringMVC中九大組件的初始化方法其中9個方法對應9個組件的初始化，本文中只講映射器和配接器的創建程序，initStrategies代碼如下：

// 初始化 MultipartResolver:主要用來處理檔案上傳.如果定義過當前型別的bean物件，那么直接獲取，如果沒有的話，可以為null
initMultipartResolver(context);
// 初始化 LocaleResolver:主要用來處理國際化配置,基于URL引數的配置(AcceptHeaderLocaleResolver)，基于session的配置(SessionLocaleResolver)，基于cookie的配置(CookieLocaleResolver)
initLocaleResolver(context);
// 初始化 ThemeResolver:主要用來設定主題Theme
initThemeResolver(context);
// 初始化 HandlerMapping:映射器，用來將對應的request跟controller進行對應
initHandlerMappings(context);
// 初始化 HandlerAdapter:處理配接器，主要包含Http請求處理器配接器，簡單控制器處理器配接器，注解方法處理器配接器
initHandlerAdapters(context);
// 初始化 HandlerExceptionResolver:基于HandlerExceptionResolver介面的例外處理
initHandlerExceptionResolvers(context);
// 初始化 RequestToViewNameTranslator:當controller處理器方法沒有回傳一個View物件或邏輯視圖名稱，并且在該方法中沒有直接往response的輸出流里面寫資料的時候，spring將會采用約定好的方式提供一個邏輯視圖名稱
initRequestToViewNameTranslator(context);
// 初始化 ViewResolver: 將ModelAndView選擇合適的視圖進行渲染的處理器
initViewResolvers(context);
// 初始化 FlashMapManager: 提供請求存盤屬性，可供其他請求使用
initFlashMapManager(context);

1.處理器映射器的初始化

1.initHandlerMappings 初始化映射器，在此方法中第一步會獲取容器中實作了HandlerMapping的Bean物件，如果有則用自定義的HandlerMapping實作類作為this.handlerMappings的值；如果沒有自定義類，則獲取SpringMVC預先定義好的策略類，代碼流程如下：

2.ClassPathResource resource = new ClassPathResource(DEFAULT_STRATEGIES_PATH, DispatcherServlet.class);獲取DispatcherServlet.properties資源檔案，位置在spring-webmvc中，路徑resources/org/springframework/web/servlet/DispatcherServlet.properties，該資源檔案中定義了SpringMVC組件的默認實作策略類，具體內容如下：

# Default implementation classes for DispatcherServlet's strategy interfaces.
# Used as fallback when no matching beans are found in the DispatcherServlet context.
# Not meant to be customized by application developers.
org.springframework.web.servlet.LocaleResolver=org.springframework.web.servlet.i18n.AcceptHeaderLocaleResolver
org.springframework.web.servlet.ThemeResolver=org.springframework.web.servlet.theme.FixedThemeResolver

org.springframework.web.servlet.HandlerMapping=org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping,org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping,org.springframework.web.servlet.function.support.RouterFunctionMapping

org.springframework.web.servlet.HandlerAdapter=org.springframework.web.servlet.mvc.HttpRequestHandlerAdapter,org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter,org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter,org.springframework.web.servlet.function.support.HandlerFunctionAdapter
    org.springframework.web.servlet.HandlerExceptionResolver=org.springframework.web.servlet.mvc.method.annotation.ExceptionHandlerExceptionResolver,org.springframework.web.servlet.mvc.annotation.ResponseStatusExceptionResolver,org.springframework.web.servlet.mvc.support.DefaultHandlerExceptionResolver

org.springframework.web.servlet.RequestToViewNameTranslator=org.springframework.web.servlet.view.DefaultRequestToViewNameTranslator

org.springframework.web.servlet.ViewResolver=org.springframework.web.servlet.view.InternalResourceViewResolver

org.springframework.web.servlet.FlashMapManager=org.springframework.web.servlet.support.SessionFlashMapManager

? 由內容可知HandlerMapping 預制的策略類有 BeanNameUrlHandlerMapping、RequestMappingHandlerMapping、RouterFunctionMapping，其中 RequestMappingHandlerMapping 是我們常用的 HandlerMapping物件，

3.RequestMappingHandlerMapping 的初始化，因為RequestMappingHandlerMapping 實作了InitializingBean介面，所以在容器中初始化完之后會執行afterPropertiesSet方法，其中會呼叫super.afterPropertiesSet();父類為AbstractHandlerMethodMapping，此方法中會呼叫initHandlerMethods()，代碼如下：

protected void initHandlerMethods() {
    // 遍歷 Bean ，逐個處理
    for (String beanName : getCandidateBeanNames()) {
        // 排除目標代理類，AOP 相關，可查看注釋
        if (!beanName.startsWith(SCOPED_TARGET_NAME_PREFIX)) {
            // 處理 Bean
            processCandidateBean(beanName);
        }
    }
    // 初始化處理器的方法們，目前沒有特殊業務邏輯，只是列印日志
    handlerMethodsInitialized(getHandlerMethods());
}

4.processCandidateBean方法中會判斷BeanName的Bean是否有Controller.class或者RequestMapping.class注解來生成具體的HandlerMethod物件，

2.處理器配接器的初始化

1.initHandlerAdapters 配接器初始化,程序和映射器相似，從上面的內容可知HandlerAdapter與之的策略類有 HttpRequestHandlerAdapter、SimpleControllerHandlerAdapter、RequestMappingHandlerAdapter、HandlerFunctionAdapter，其中 RequestMappingHandlerAdapter 是我們常用的處理器配接器，

2.RequestMappingHandlerAdapter實作了InitializingBean介面，在容器中初始化完之后會呼叫afterPropertiesSet方法，在此方法中會初始化引數決議器、系結引數決議器、回傳值決議器，此方法代碼如下：

@Override
public void afterPropertiesSet() {
    // Do this first, it may add ResponseBody advice beans
    // 初始化注釋了@ControllerAdvice的類的相關屬性
    initControllerAdviceCache();

    // 初始化 argumentResolvers 屬性
    if (this.argumentResolvers == null) {
        List<HandlerMethodArgumentResolver> resolvers = getDefaultArgumentResolvers();
        this.argumentResolvers = new HandlerMethodArgumentResolverComposite().addResolvers(resolvers);
    }
    // 初始化 initBinderArgumentResolvers 屬性
    if (this.initBinderArgumentResolvers == null) {
        List<HandlerMethodArgumentResolver> resolvers = getDefaultInitBinderArgumentResolvers();
        this.initBinderArgumentResolvers = new HandlerMethodArgumentResolverComposite().addResolvers(resolvers);
    }
    // 初始化 returnValueHandlers 屬性
    if (this.returnValueHandlers == null) {
        List<HandlerMethodReturnValueHandler> handlers = getDefaultReturnValueHandlers();
        this.returnValueHandlers = new HandlerMethodReturnValueHandlerComposite().addHandlers(handlers);
    }
}

4.攔截器的初始化

因為所有的HandlerMapping預制的策略類都繼承了AbstractHandlerMapping ，而AbstractHandlerMapping 實作了ApplicationContextAware介面，所以在具體的HandlerMapping策略類初始化完之后會呼叫initApplicationContext方法，該方法中具體實作了攔截器的創建，代碼如下：

protected void initApplicationContext() throws BeansException {
    // 空實作，交給子類實作，用于注冊自定義的攔截器到interceptors中，目前暫無子類實作
    extendInterceptors(this.interceptors);
    // 掃描已注冊的MappedInterceptor的Bean們，添加到adaptedInterceptors中
    detectMappedInterceptors(this.adaptedInterceptors);
    // 將interceptors初始化成 HandlerInterceptor型別，添加到adaptedInterceptors中
    initInterceptors();
}

三、SpringMVC請求程序

1.請求流程圖

2.業務描述

1.請求進來后會呼叫FrameworkServlet的service()方法，該方法中會呼叫(HttpServlet) super.service 方法，其中會呼叫doXXX()方法，而doXXX()方法在FrameworkServlet重寫，每個doXXX()方法中又會呼叫processRequest(request, response)方法，processRequest中會呼叫doService()，doService()中又會呼叫doDispatch()，整個業務處理邏輯定義在doDispatch方法中，

2.回圈遍歷在啟動程序中創建的handlerMapping處理器映射器集合查找對應處理器，傳入引數為 request 請求物件，回傳的是HandlerExecutionChain型別的物件，代碼如下

protected HandlerExecutionChain getHandler(HttpServletRequest request) throws Exception {
    if (this.handlerMappings != null) {
        //遍歷
        for (HandlerMapping mapping : this.handlerMappings) {
            HandlerExecutionChain handler = mapping.getHandler(request);
            if (handler != null) {
                return handler;
            }
        }
    }
    return null;
}

在getHandler方法中如果找到具體的handler物件(HandlerMethod型別)，會繼續封裝handler物件為一個executionChain處理器鏈鏈物件(HandlerExecutionChain型別)，代碼如下：

Object handler = getHandlerInternal(request);
if (handler == null) {
	handler = getDefaultHandler();
}
// 如果handler為null 即回傳null，說明當前的處理器映射器不匹配，
if (handler == null) {
	return null;
}
// Bean name or resolved handler?
if (handler instanceof String) {
    String handlerName = (String) handler;
    handler = obtainApplicationContext().getBean(handlerName);
}

// Ensure presence of cached lookupPath for interceptors and others
if (!ServletRequestPathUtils.hasCachedPath(request)) {
	initLookupPath(request);
}
//創建處理器鏈
HandlerExecutionChain executionChain = getHandlerExecutionChain(handler, request);

getHandlerInternal是多型方法，具體的實作類中有不同的實作方式，查找具體的HandlerMethod邏輯比較復雜，請自行查看原始碼，

3.回圈遍歷在啟動程序中創建的handlerAdapters處理器配接器集合查找對應處理器配接器，傳入引數為handler處理器物件，回傳的是RequestMappingHandlerAdapter型別的處理器配接器，代碼如下：

protected HandlerAdapter getHandlerAdapter(Object handler) throws ServletException {
    if (this.handlerAdapters != null) {
        //回圈判斷哪個配接器能處理傳入的處理器
        for (HandlerAdapter adapter : this.handlerAdapters) {
            if (adapter.supports(handler)) {
                return adapter;
            }
        }
    }
    throw new ServletException("No adapter for handler [" + handler +
                               "]: The DispatcherServlet configuration needs to include a HandlerAdapter that supports this handler");
}

4.回圈執行mappedHandler(HandlerExecutionChain攔截器鏈)物件的攔截器preHandle方法，

5.處理器配接器呼叫處理方法，最侄訓執行ServletInvocableHandlerMethod.invokeAndHandle()方法，此方法中會呼叫invokeForRequest，invokeForRequest中會先拿到Controller中方法的具體引數值，再執行該方法，最后會回傳ModelAndView物件，

6.回圈執行mappedHandler(HandlerExecutionChain攔截器鏈)物件的攔截器postHandle方法，

7.processDispatchResult方法中會先查找找到具體的視圖引擎，代碼如下：

protected View resolveViewName(String viewName, @Nullable Map<String, Object> model,
                               Locale locale, HttpServletRequest request) throws Exception {
    if (this.viewResolvers != null) {
        for (ViewResolver viewResolver : this.viewResolvers) {
            View view = viewResolver.resolveViewName(viewName, locale);
            if (view != null) {
                return view;
            }
        }
    }
    return null;
}

? 然后渲染視圖內容，底層其實就是請求的轉發，代碼如下：

public void render(@Nullable Map<String, ?> model, HttpServletRequest request,
                   HttpServletResponse response) throws Exception {
    if (logger.isDebugEnabled()) {
        logger.debug("View " + formatViewName() +
                     ", model " + (model != null ? model : Collections.emptyMap()) +
                     (this.staticAttributes.isEmpty() ? "" : ", static attributes " + this.staticAttributes));
    }
    //合并回傳結果，將 Model 中的靜態資料和請求中的動態資料進行合并
    Map<String, Object> mergedModel = createMergedOutputModel(model, request, response);
    prepareResponse(request, response);
    //進行渲染
    renderMergedOutputModel(mergedModel, getRequestToExpose(request), response);
}

8.回圈執行mappedHandler(HandlerExecutionChain攔截器鏈)物件的攔截器afterCompletion方法，

轉載請註明出處，本文鏈接：https://www.uj5u.com/houduan/482179.html

標籤：其他

上一篇：利用python腳本自動登錄華農校園網（附程式）

下一篇：Invalid bound statement (not found)例外如何處理呢？