Spring MVC 基礎架構全解析：從請求流程到參數綁定、MyBatis 整合與事務控制

核心請求流程（11 步）

1. 用戶發起請求 → DispatcherServlet（前端控制器）
2. DispatcherServlet 委託 HandlerMapping 查找 Handler（Controller 方法）
3. HandlerMapping 返回 HandlerExecutionChain（含攔截器）
4. DispatcherServlet 委託 HandlerAdapter 執行 Handler
5. HandlerAdapter 調用 Controller 方法
6. Controller 返回 ModelAndView（模型數據 + 邏輯視圖名）
7. HandlerAdapter 返回 ModelAndView 給 DispatcherServlet
8. DispatcherServlet 委託 ViewResolver 解析邏輯視圖名 → View
9. ViewResolver 返回具體 View (JSP/FreeMarker/PDF...)
10. DispatcherServlet 渲染視圖：模型數據填入 Request 域
11. DispatcherServlet 響應用戶

九大組件職責

最小化配置啟動

web.xml 註冊 DispatcherServlet

<servlet>
    <servlet-name>springmvc</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:spring/springmvc.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>springmvc</servlet-name>
    <url-pattern>*.action</url-pattern>
</servlet-mapping>

springmvc.xml 核心三件套

<!-- 1. 註解驅動：自動註冊 HandlerMapping、HandlerAdapter、參數綁定、轉換器 -->
<mvc:annotation-driven />

<!-- 2. 視圖解析器：JSP 前綴/後綴 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <property name="prefix" value="/WEB-INF/jsp/"/>
    <property name="suffix" value=".jsp"/>
</bean>

<!-- 3. 掃描 Controller -->
<context:component-scan base-package="com.example.controller"/>

Controller 開發範例

參數綁定機制

1. POJO 自動綁定

表單 name="price" → 參數 ItemsCustom itemsCustom 中 price 屬性，名稱完全匹配即可。嵌套屬性 user.address.city 亦支援。

2. @RequestParam 精確控制

@RequestParam(value="id", required=true, defaultValue="1") Integer id

3. 自定義類型轉換器

// Converter
@Component
public class CustomDateConverter implements Converter<String, Date> {
    @Override public Date convert(String source) {
        return new SimpleDateFormat("yyyy-MM-dd").parse(source);
    }
}

// 註冊
<bean id="conversionService" class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
    <property name="converters">
        <set><bean class="com.example.converter.CustomDateConverter"/></set>
    </property>
</bean>

<mvc:annotation-driven conversion-service="conversionService" />

Spring MVC + MyBatis 整合三層配置

DAO 層：applicationContext-dao.xml

<context:property-placeholder location="classpath:db.properties"/>

<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">
    <property name="driverClassName" value="${jdbc.driver}"/>
    <property name="url" value="${jdbc.url}"/>
    <property name="username" value="${jdbc.username}"/>
    <property name="password" value="${jdbc.password}"/>
</bean>

<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
    <property name="dataSource" ref="dataSource"/>
    <property name="configLocation" value="classpath:mybatis/sqlMapConfig.xml"/>
</bean>

<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
    <property name="basePackage" value="com.example.mapper"/>
    <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
</bean>

Service 層：applicationContext-service.xml

<bean id="itemsService" class="com.example.service.impl.ItemsServiceImpl"/>

事務控制：applicationContext-transaction.xml

<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
    <property name="dataSource" ref="dataSource"/>
</bean>

<tx:advice id="txAdvice" transaction-manager="transactionManager">
    <tx:attributes>
        <tx:method name="save*" propagation="REQUIRED"/>
        <tx:method name="delete*" propagation="REQUIRED"/>
        <tx:method name="insert*" propagation="REQUIRED"/>
        <tx:method name="update*" propagation="REQUIRED"/>
        <tx:method name="find*" propagation="SUPPORTS" read-only="true"/>
        <tx:method name="get*" propagation="SUPPORTS" read-only="true"/>
    </tx:attributes>
</tx:advice>

<aop:config>
    <aop:advisor advice-ref="txAdvice" pointcut="execution(* com.example.service.impl.*.*(..))"/>
</aop:config>

web.xml 載入 Spring 容器

<context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>/WEB-INF/classes/spring/applicationContext-*.xml</param-value>
</context-param>
<listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

整合驗證清單

1. 啟動 Tomcat 無錯誤日誌
2. 訪問 /items/queryItems.action 正常渲染 JSP 列表
3. 新增/修改/刪除操作事務回滾測試（拋異常驗證）
4. SQL 日誌確認預期語句

進階優化方向

• HandlerMethodArgumentResolver 自定義參數解析（如 CurrentUser）
• HandlerInterceptor 實現登錄檢查、日誌、限流
• ResponseBodyAdvice 統一響應包裝
• 異步處理 Callable/DeferredResult 提升吞吐
• RESTful 風格：@RestController + @PathVariable + HTTP 動詞