Spring MVC 4.2 核心技術參考手冊：從 DispatcherServlet 到異步處理全景解析

Spring MVC 4.2 核心技術參考手冊：從 DispatcherServlet 到異步處理全景解析

聲明：本文匯總 Spring MVC 4.2 幾乎所有核心技術點，作為查閱手冊。篇幅較長，建議使用 Ctrl+F 搜尋關鍵字。歡迎加入 Java 編程交流群：574337670。

21.1 Spring Web MVC 框架簡介

核心架構圍繞 DispatcherServlet（前端控制器模式），負責請求分發、處理器映射、視圖渲染、本地化、主題、檔案上傳等。處理器為標註 @Controller、@RequestMapping 的類與方法，Spring 3.0+ 提供豐富註解支援 RESTful 開發。

設計原則：「對擴展開放，對修改關閉」。核心類多標註 final，不建議繼承覆寫。

核心優勢

• 職責清晰分離（Controller、Validator、ViewResolver 等各司其職）
• 強大的 Bean 配置與跨上下文引用
• 非侵入式、靈活的方法簽名與註解支援
• 可復用業務碼，無需繼承框架基類
• 可定制數據綁定、驗證、類型轉換
• 靈活的 HandlerMapping、ViewResolver 策略
• Map 模型解耦視圖技術（JSP、Velocity、FreeMarker、JSON、XML...）
• 完善的 JSP 標籤庫支援
• 請求/會話/全局會話 Scope Bean

21.2 DispatcherServlet 核心配置與處理流程

web.xml 傳統配置

<servlet>
    <servlet-name>example</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <load-on-startup>1</load-on-startup>
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/spring/example-servlet.xml</param-value>
    </init-param>
</servlet>
<servlet-mapping>
    <servlet-name>example</servlet-name>
    <url-pattern>/example/*</url-pattern>
</servlet-mapping>

Servlet 3.0+ 程式化配置

public class MyWebAppInitializer implements WebApplicationInitializer {
    @Override
    public void onStartup(ServletContext container) {
        ServletRegistration.Dynamic reg = container.addServlet("dispatcher", new DispatcherServlet());
        reg.setLoadOnStartup(1);
        reg.addMapping("/example/*");
    }
}

WebApplicationContext 層級關係

每個 DispatcherServlet 持有獨立的 WebApplicationContext，繼承自根 Context（共享 Service、DAO 等）。可在 web.xml 設定 contextConfigLocation 為空，僅使用根 Context。

DispatcherServlet 依賴的特殊 Bean 類型

請求處理流程 (doDispatch 簡化版)

1. 綁定 WebApplicationContext、LocaleResolver、ThemeResolver 到請求屬性。
2. 若為 Multipart 請求，包裝為 MultipartHttpServletRequest。
3. 遍歷 HandlerMapping 尋找匹配 Handler，獲取 HandlerExecutionChain。
4. 若無 Handler，返回 404。
5. 透過 HandlerAdapter 調用 Handler，獲取 ModelAndView。
6. 執行攔截器 preHandle → postHandle → afterCompletion。
7. 視圖渲染或直接寫響應流。

21.3 Controller 實現詳解（註解驅動）

@Controller 定義控制器

• 標識類為控制器角色，無需繼承基類或實現介面。
• 配合 <context:component-scan base-package="..."/> 自動掃描註冊。

@RequestMapping 映射請求

• 類級別：基礎路徑前綴（如 /appointments）。
• 方法級別：細化 HTTP 方法、參數條件、Header 條件、媒體類型 (consumes/produces)。
• 支援 URI 模板 ({var})、Ant 風格通配符 (*.do)、正則表達式 ({var:regex})、矩陣變量 (;k=v)。
• 路徑匹配優先序：變量/通配符少 → 路徑長 → 通配符少 → 非預設模式。

Handler 方法簽名完全指南

支援參數類型： Servlet API 對象、WebRequest、Locale/TimeZone、InputStream/Reader、OutputStream/Writer、HttpMethod、Principal、@PathVariable、@MatrixVariable、@RequestParam、@RequestHeader、@RequestBody、@RequestPart、HttpEntity、Map/Model/ModelMap、RedirectAttributes、命令/表單對象、Errors/BindingResult、SessionStatus、UriComponentsBuilder。
注意： BindingResult 必須緊跟其驗證對象之後。

支援返回類型： ModelAndView、Model/Map、View、String (視圖名)、void (自行寫響應)、@ResponseBody 任意類型 (經 HttpMessageConverter 轉換)、HttpEntity/ResponseEntity、HttpHeaders、異步類型 (Callable, DeferredResult, ListenableFuture, ResponseBodyEmitter, SseEmitter, StreamingResponseBody)。

關鍵註解深度解析

• @RequestParam：綁定查詢參數，required=false 可選，支援 Map/MultiValueMap 批量綁定。
• @RequestBody：綁定請求體，經 HttpMessageConverter 轉換 (JSON、XML、表單等)。可配合 @Valid 驗證。
• @ResponseBody：返回值直接寫響應體。@RestController = @Controller + @ResponseBody。
• HttpEntity：同時存取 Header 與 Body。
• @ModelAttribute (方法)：@RequestMapping 前執行，填充模型公共屬性 (下拉選單、表單預設值)。
• @ModelAttribute (參數)：從模型獲取/實例化命令對象 → 數據綁定 → 驗證 (配合 BindingResult、@Valid)。
• @SessionAttributes：跨請求保存模型屬性至 Session。
• @CookieValue、@RequestHeader：綁定 Cookie/Header，支援類型轉換與集合映射。
• @InitBinder：定制 WebDataBinder，註冊自定義 PropertyEditor 或 Formatter。
• @ControllerAdvice：全局/切面級 @ExceptionHandler、@InitBinder、@ModelAttribute，支援按註解、包、類型篩選目標 Controller。

異步請求處理 (Servlet 3.0+)

• Callable：Spring MVC 管理線程池執行，返回值異步產生。
• DeferredResult：任意線程 (JMS、定時任務) 設值，適合事件驅動。
• HTTP Streaming：ResponseBodyEmitter (多對象)、SseEmitter (Server-Sent Events)、StreamingResponseBody (直接寫 OutputStream)。
• 配置：web.xml <async-supported>true</async-supported>，過濾器需支援 ASYNC 分派。Spring MVC 配置 configureAsyncSupport 設定超時、任務執行器、攔截器。