Java Web 開發中 SSH 框架整合實戰筆記

SSH 框架整合概述

Struts 2、Spring、Hibernate（簡稱 SSH）曾是企業級 Java Web 開發的「標準」架構。雖然 Spring MVC 等新框架逐漸取代 Struts 2，但理解 SSH 的整合原理對維護舊專案、掌握框架協作機制仍有重要價值。本文記錄 SSH 整合的關鍵步驟、版本選擇、核心配置及常見坑點。

框架版本與角色定位

• Struts 2.3.4：負責請求分發、表單數據自動封裝、攔截器鏈處理。
• Spring 3.2.2：作為膠水層，管理 Bean 生命週期（IOC）、事務控制、AOP 切面，整合 Struts 2 與 Hibernate。
• Hibernate 4.1.9：提供 ORM 映射、一級/二級緩存、HQL 查詢，解決對象與關係表映射問題。

三者分工：Struts 2 處理 Web 層請求轉發；Spring 管理業務邏輯 Bean 及事務；Hibernate 負責持久層映射。

核心 Jar 包依賴（精簡原則）

建議按需引入，避免一次性導入所有 Jar 導致版本衝突。常用清單：

• Struts 2：struts2-core、xwork、ognl、struts2-spring-plugin、commons-fileupload、commons-logging 等。
• Spring：spring-core、spring-context、spring-orm、spring-tx、spring-web 等。
• Hibernate 4：hibernate-core 及 required 目錄下所有 Jar。

遇到 ClassNotFoundException 再補充對應 Jar，放入 WEB-INF/lib。

關鍵配置步驟

1. 配置 Struts 2 核心過濾器

<filter>
  <filter-name>struts2</filter-name>
  <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
</filter>
<filter-mapping>
  <filter-name>struts2</filter-name>
  <url-pattern>/*</url-pattern>
</filter-mapping>

2. 指定 Action 後綴與 Spring 管理 Action

<constant name="struts.objectFactory" value="spring" />
<constant name="struts.action.extension" value="action" />

第一行將 Action 實例交由 Spring 容器管理；第二行設定攔截 .action 後綴的請求。

3. 啟動 Spring 容器（ContextLoaderListener）

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

4. Spring 管理 Hibernate SessionFactory

<bean id="sessionFactory" class="org.springframework.orm.hibernate4.LocalSessionFactoryBean">
  <property name="dataSource" ref="dataSource" />
  <property name="mappingResources">
    <list></list>
  </property>
  <property name="hibernateProperties">
    <props></props>
  </property>
</bean>

5. 配置 OpenSessionInView 過濾器（可選）

<filter>
  <filter-name>openSessionInViewFilter</filter-name>
  <filter-class>org.springframework.orm.hibernate4.support.OpenSessionInViewFilter</filter-class>
</filter>
<filter-mapping>
  <filter-name>openSessionInViewFilter</filter-name>
  <url-pattern>/*</url-pattern>
</filter-mapping>

保證每個請求對應一個 Hibernate Session，避免懶加載異常；生產環境建議僅攔截 .action 請求以節省資源。

6. 註冊業務 Bean 並關聯 Struts Action

使用註解 @Component("userAction") 標識 Action，並在 struts.xml 中引用：

<package name="user" extends="struts-default" namespace="/user">
  <action name="login" class="userAction" method="login">
    <result name="ERROR">/pages/login.jsp</result>
  </action>
</package>

實踐建議

• 新手勿過度依賴框架，先理解 Servlet、JDBC 基礎，再學習框架解決的具體痛點。
• 團隊專案中，框架規範有助於代碼風格統一、後期維護；但需根據業務複雜度選型，避免過度設計。
• Spring MVC、MyBatis 等現代框架已成為主流，新專案建議優先考慮。