實(shí)戰(zhàn)：SSH解耦原理與職責(zé)隔離)
簡介本資源是一份面向Java Web初學(xué)者與中級(jí)開發(fā)者的三層架構(gòu)系統(tǒng)性學(xué)習(xí)文檔聚焦企業(yè)級(jí)Web應(yīng)用的結(jié)構(gòu)設(shè)計(jì)與SSH框架整合實(shí)踐。內(nèi)容深入剖析表示層Struts實(shí)現(xiàn)MVC解耦、業(yè)務(wù)邏輯層Spring IoC/DI與AOP管理及數(shù)據(jù)訪問層Hibernate ORM映射與HQL查詢并結(jié)合Spring 2.5Struts 2.0Hibernate 3.2典型版本組合提供輕量級(jí)、高可維護(hù)的J2EE開發(fā)方案。資源為單個(gè)Word文檔.doc格式全文約102KB涵蓋框架原理、組件職責(zé)劃分、集成機(jī)制圖解及實(shí)際項(xiàng)目落地案例結(jié)構(gòu)清晰、術(shù)語規(guī)范便于對(duì)照理解與課后復(fù)盤。目前已有2376人學(xué)習(xí)下載適合希望夯實(shí)分層思想、掌握SSH協(xié)同開發(fā)流程、提升代碼解耦能力的開發(fā)者系統(tǒng)研讀。1. Java Web 三層架構(gòu)不是分包目錄而是職責(zé)隔離的生存法則你有沒有遇到過這樣的項(xiàng)目改一個(gè)用戶登錄邏輯結(jié)果要?jiǎng)?JSP、Action、Service、DAO、Hibernate 映射文件、SQL 腳本最后連事務(wù)配置都得重測(cè)上線前一小時(shí)發(fā)現(xiàn)UserAction里硬編碼了數(shù)據(jù)庫連接池參數(shù)而UserService又直接 new 了一個(gè)UserDaoImpl——這不是代碼是雷區(qū)地圖。Java Web 三層架構(gòu)表示層 / 業(yè)務(wù)邏輯層 / 數(shù)據(jù)訪問層從來就不是教科書里“把類扔進(jìn) controller、service、dao 三個(gè)包”這么簡單。它是一套經(jīng)過十年以上企業(yè)級(jí)項(xiàng)目血洗驗(yàn)證的職責(zé)契約視圖不碰 SQLService 不寫 HTMLDAO 不管事務(wù)邊界Spring 容器才是唯一能說“誰該依賴誰”的仲裁者。本文講的 SSHStruts 2.0 Spring 2.5 Hibernate 3.2組合不是過時(shí)的古董堆砌而是把 MVC 解耦、IoC 控制流、ORM 映射這三根鋼索擰成一股繩的實(shí)戰(zhàn)范式。它解決的不是“能不能跑”而是“改需求時(shí)敢不敢刪代碼”——當(dāng)你在struts-config.xml里刪掉一個(gè)action卻不用動(dòng)applicationContext.xml里的 bean 定義當(dāng)你把UserDAO接口換成 MyBatis 實(shí)現(xiàn)UserService一行代碼都不用改這才是三層架構(gòu)真正落地的信號(hào)。適合正在維護(hù)老系統(tǒng)、被耦合代碼拖垮的中級(jí) Java 工程師也適合剛從 Spring Boot 轉(zhuǎn)回傳統(tǒng)架構(gòu)、搞不清ActionServlet和DispatcherServlet根本區(qū)別的新人。別急著建 Maven 模塊先搞懂這三層之間誰向誰發(fā)號(hào)施令、誰對(duì)誰負(fù)最終責(zé)任。2. 表示層Struts 2.0 的 Controller 不是轉(zhuǎn)發(fā)器而是請(qǐng)求生命周期的守門人Struts 2.0 的核心不是Action類而是FilterDispatcher或StrutsPrepareAndExecuteFilter攔截的整個(gè) HTTP 請(qǐng)求生命周期。它強(qiáng)制你在struts.xml里聲明“這個(gè) URL 由誰處理、處理完跳哪、出錯(cuò)去哪”把流程控制權(quán)從 Java 代碼里徹底剝離。這不是偷懶是防止UserAction.execute()里突然冒出new UserService().updatePassword(...)這種反模式。2.1 Struts 配置的本質(zhì)用 XML 描述請(qǐng)求路由與結(jié)果映射struts.xml不是配置文件是請(qǐng)求契約說明書。以下是一個(gè)用戶列表功能的標(biāo)準(zhǔn)配置package nameuser extendsstruts-default namespace/admin action namelistUser classcom.simon.oa.user.controller.UserAction methodlist result namesuccess/WEB-INF/jsp/user/list.jsp/result result nameerror/WEB-INF/jsp/error.jsp/result result nameinput/WEB-INF/jsp/user/input.jsp/result /action /package邏輯說明namespace/admin將所有 action 統(tǒng)一掛載到/admin/*路徑下避免 URL 沖突class指向具體 Action 類但注意——這個(gè)類必須由 Spring 容器管理后文詳述否則無法注入 Servicemethodlist表明調(diào)用UserAction.list()方法而非默認(rèn)execute()三個(gè)result分別對(duì)應(yīng)不同返回值success是正常流程error是業(yè)務(wù)異常如權(quán)限不足input是表單校驗(yàn)失敗后回顯頁面。參數(shù)說明namelistUser是 action 的邏輯名客戶端訪問路徑為/admin/listUser.action.action后綴由struts.action.extension配置默認(rèn)啟用result的name必須與 Action 方法return success;中的字符串嚴(yán)格匹配大小寫敏感。2.2 Action 類的設(shè)計(jì)鐵律零業(yè)務(wù)邏輯、零數(shù)據(jù)訪問、只做三件事UserAction的唯一職責(zé)是接收請(qǐng)求參數(shù) → 調(diào)用 Service → 返回結(jié)果字符串。它不該有Autowired注解Spring 2.5 不支持注解驅(qū)動(dòng)靠 XML 注入也不該有sessionFactory字段。標(biāo)準(zhǔn)寫法如下// com.simon.oa.user.controller.UserAction.java public class UserAction extends ActionSupport { private UserService userService; // 僅聲明引用不實(shí)例化 private ListUser userList; // 用于頁面展示的 VO 對(duì)象列表 private String userId; // 接收 URL 參數(shù) ?userId123 // 必須提供 setter 方法供 Struts 框架通過反射注入?yún)?shù) public void setUserId(String userId) { this.userId userId; } // 必須提供 getter 方法供 JSP 頁面通過 ${userList} 訪問 public ListUser getUserList() { return userList; } // 業(yè)務(wù)方法只調(diào)用 Service不處理任何業(yè)務(wù)規(guī)則 public String list() { try { this.userList userService.findAllUsers(); return SUCCESS; // 對(duì)應(yīng) struts.xml 中的 namesuccess } catch (Exception e) { addActionError(獲取用戶列表失敗 e.getMessage()); return ERROR; // 對(duì)應(yīng) nameerror } } }邏輯說明extends ActionSupport提供了addActionError()、getText()等基礎(chǔ)能力setUserId()是 Struts 自動(dòng)調(diào)用的參數(shù)綁定入口URL 中?userId123會(huì)自動(dòng)賦值給userId字段getUserList()是 JSP EL 表達(dá)式${userList}的訪問入口Struts 會(huì)通過反射調(diào)用此方法獲取數(shù)據(jù)list()方法內(nèi)只做userService.findAllUsers()調(diào)用所有分頁、權(quán)限校驗(yàn)、緩存邏輯必須下沉到 Service 層。參數(shù)說明SUCCESS和ERROR是ActionSupport中定義的靜態(tài)常量值為success和error必須與struts.xml中result name...的 name 一致addActionError()的錯(cuò)誤信息會(huì)自動(dòng)傳遞給error.jsp頁面無需手動(dòng)request.setAttribute()。2.3 視圖層JSP 不是模板引擎而是純數(shù)據(jù)渲染器JSP 頁面里禁止出現(xiàn)if (user.getRole().equals(ADMIN))這類業(yè)務(wù)判斷。所有邏輯必須前置到 Action 或 Service。標(biāo)準(zhǔn)list.jsp應(yīng)只做三件事引入 Struts 標(biāo)簽庫、遍歷userList、輸出 HTML 表格。% taglib prefixs uri/struts-tags % html headtitle用戶列表/title/head body h2用戶管理/h2 s:if testuserList ! null userList.size() 0 table border1 trthID/thth姓名/thth郵箱/th/tr s:iterator valueuserList varuser tr tds:property value#user.id//td tds:property value#user.name//td tds:property value#user.email//td /tr /s:iterator /table /s:if s:else p暫無用戶數(shù)據(jù)/p /s:else /body /html邏輯說明s:if和s:iterator是 Struts 2 的標(biāo)簽庫test屬性執(zhí)行 OGNL 表達(dá)式#user.id中的#表示當(dāng)前迭代對(duì)象s:property輸出對(duì)象屬性自動(dòng)處理 null 安全整個(gè)頁面沒有 Java 腳本% %沒有 SQL沒有 if-else 業(yè)務(wù)分支。參數(shù)說明valueuserList中的userList是 Action 中g(shù)etUserList()返回的 ListStruts 會(huì)將其放入 ValueStackvaruser將每次迭代的對(duì)象綁定到#user供后續(xù)標(biāo)簽使用s:else是s:if的配套標(biāo)簽不可省略。3. 業(yè)務(wù)邏輯層Spring 2.5 的 IoC 容器不是工廠而是對(duì)象關(guān)系的憲法Spring 2.5 的核心價(jià)值不在“簡化開發(fā)”而在用 XML 配置強(qiáng)行規(guī)定對(duì)象之間的依賴契約。它讓UserAction不能直接new UserServiceImpl()必須通過容器注入讓UserService不能直接new UserDaoImpl()必須聲明接口依賴。這種“不許你自由戀愛必須由組織介紹”的設(shè)計(jì)才是解耦的根基。3.1 applicationContext.xml用bean定義對(duì)象的出生證與婚姻證applicationContext.xml是 Spring 容器的憲法每個(gè)bean標(biāo)簽定義一個(gè)對(duì)象的創(chuàng)建方式、生命周期和依賴關(guān)系。以下是用戶模塊的核心配置!-- 1. 數(shù)據(jù)源DBCP 連接池 -- bean iddataSource classorg.apache.commons.dbcp.BasicDataSource destroy-methodclose property namedriverClassName valuecom.mysql.jdbc.Driver/ property nameurl valuejdbc:mysql://localhost:3306/oa_db?useUnicodetrueamp;characterEncodingUTF-8/ property nameusername valueroot/ property namepassword value123456/ property namemaxActive value20/ /bean !-- 2. SessionFactoryHibernate 的核心工廠 -- bean idsessionFactory classorg.springframework.orm.hibernate3.LocalSessionFactoryBean property namedataSource refdataSource/ property namemappingResources list valuecom/simon/oa/user/model/User.hbm.xml/value /list /property property namehibernateProperties props prop keyhibernate.dialectorg.hibernate.dialect.MySQLDialect/prop prop keyhibernate.hbm2ddl.autoupdate/prop prop keyhibernate.show_sqltrue/prop /props /property /bean !-- 3. DAO 實(shí)現(xiàn)類繼承 HibernateDaoSupport -- bean iduserDao classcom.simon.oa.user.dao.hibernate.UserDaoImpl property namesessionFactory refsessionFactory/ /bean !-- 4. Service 接口實(shí)現(xiàn)類 -- bean iduserService classcom.simon.oa.user.service.impl.UserServiceImpl property nameuserDao refuserDao/ /bean !-- 5. Struts Action必須由 Spring 管理才能注入 Service -- bean iduserAction classcom.simon.oa.user.controller.UserAction scopeprototype property nameuserService refuserService/ /bean邏輯說明iddataSource定義數(shù)據(jù)源 Beandestroy-methodclose確保容器關(guān)閉時(shí)釋放連接LocalSessionFactoryBean是 Spring 封裝的 Hibernate 工廠mappingResources指定.hbm.xml映射文件路徑注意斜杠方向userDaoBean 的sessionFactory屬性通過refsessionFactory注入形成依賴鏈userService依賴userDaouserAction依賴userService最終形成Action → Service → DAO → SessionFactory → DataSource的完整鏈條scopeprototype是關(guān)鍵——Struts 每次請(qǐng)求都會(huì)創(chuàng)建新 Action 實(shí)例必須設(shè)為 prototype否則多線程下會(huì)共享狀態(tài)。參數(shù)說明property namexxx中的name必須與目標(biāo)類的 setter 方法名一致如setUserService(UserService userService)refxxx引用其他 Bean 的id非class名list和props是 Spring 的集合注入語法prop key...對(duì)應(yīng) Properties 文件的鍵值對(duì)。3.2 Service 接口與實(shí)現(xiàn)用接口隔離變化用實(shí)現(xiàn)專注邏輯UserService接口定義契約UserServiceImpl實(shí)現(xiàn)細(xì)節(jié)。這是 Spring IoC 能生效的前提——依賴必須面向接口而非實(shí)現(xiàn)類。// com.simon.oa.user.service.UserService.java public interface UserService { ListUser findAllUsers(); User findUserById(String id); void updateUser(User user); } // com.simon.oa.user.service.impl.UserServiceImpl.java public class UserServiceImpl implements UserService { private UserDao userDao; // 依賴 DAO 接口非實(shí)現(xiàn)類 public void setUserDao(UserDao userDao) { this.userDao userDao; } Override public ListUser findAllUsers() { // 業(yè)務(wù)邏輯可加日志、權(quán)限檢查、緩存等橫切關(guān)注點(diǎn) System.out.println(【Service】開始查詢所有用戶); ListUser users userDao.findAll(); // 調(diào)用 DAO 接口方法 System.out.println(【Service】查詢到 users.size() 個(gè)用戶); return users; } Override public User findUserById(String id) { // 業(yè)務(wù)邏輯ID 校驗(yàn)、空值處理 if (id null || id.trim().length() 0) { throw new IllegalArgumentException(用戶ID不能為空); } return userDao.findById(id); } }邏輯說明UserServiceImpl中setUserDao()是 Spring 注入入口userDao字段類型是接口UserDao而非UserDaoImplfindAllUsers()方法內(nèi)只做日志和調(diào)用所有數(shù)據(jù)庫操作委托給userDao.findAll()findUserById()做了 ID 校驗(yàn)這是 Service 層該承擔(dān)的職責(zé)Action 只做參數(shù)接收DAO 只做數(shù)據(jù)存取。參數(shù)說明Override注解確保實(shí)現(xiàn)類方法與接口簽名一致throw new IllegalArgumentException()是業(yè)務(wù)異常會(huì)被 Struts 捕獲并跳轉(zhuǎn)到error.jspSystem.out.println()是調(diào)試日志實(shí)際項(xiàng)目應(yīng)替換為 Log4j。3.3 事務(wù)管理不是加個(gè)Transactional而是用 AOP 切面織入Spring 2.5 不支持注解式事務(wù)Transactional是 2.5 之后版本才引入必須用 AOP 配置。事務(wù)邊界必須圈定在 Service 方法上DAO 層絕不開啟事務(wù)。!-- 在 applicationContext.xml 中追加事務(wù)配置 -- bean idtransactionManager classorg.springframework.orm.hibernate3.HibernateTransactionManager property namesessionFactory refsessionFactory/ /bean aop:config aop:pointcut idserviceMethods expressionexecution(* com.simon.oa.user.service.impl.*.*(..))/ aop:advisor advice-reftxAdvice pointcut-refserviceMethods/ /aop:config tx:advice idtxAdvice transaction-managertransactionManager tx:attributes tx:method namefind* read-onlytrue/ tx:method nameget* read-onlytrue/ tx:method name* propagationREQUIRED/ /tx:attributes /tx:advice邏輯說明aop:pointcut定義切點(diǎn)匹配com.simon.oa.user.service.impl包下所有類的所有方法aop:advisor將事務(wù)通知txAdvice織入切點(diǎn)tx:method指定事務(wù)規(guī)則find*和get*方法設(shè)為只讀read-onlytrue提升性能其他方法*使用REQUIRED傳播行為如果已有事務(wù)則加入否則新建。參數(shù)說明propagationREQUIRED是最常用行為確保updateUser()方法在事務(wù)中執(zhí)行read-onlytrue會(huì)禁用 Hibernate 的臟檢查減少數(shù)據(jù)庫壓力transaction-managertransactionManager引用上面定義的事務(wù)管理器 Bean。4. 數(shù)據(jù)訪問層Hibernate 3.2 的 .hbm.xml 不是配置而是對(duì)象與表的婚書Hibernate 3.2 的核心是.hbm.xml映射文件它用 XML 聲明 Java 類與數(shù)據(jù)庫表的字段對(duì)應(yīng)關(guān)系。這不是可選配置而是 ORM 的法律依據(jù)。一旦映射出錯(cuò)save()會(huì)靜默失敗load()會(huì)返回 null——沒有報(bào)錯(cuò)只有沉默的崩潰。4.1 User.hbm.xml用class定義類與表的綁定用id定義主鍵策略User.hbm.xml必須與User.java同包且文件名嚴(yán)格匹配類名 .hbm.xml。以下是標(biāo)準(zhǔn)模板?xml version1.0 encodingUTF-8? !DOCTYPE hibernate-mapping PUBLIC -//Hibernate/Hibernate Mapping DTD 3.0//EN http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd hibernate-mapping packagecom.simon.oa.user.model class nameUser tablet_user catalogoa_db !-- 主鍵映射 -- id nameid columnuser_id typestring generator classassigned/ /id !-- 屬性映射 -- property namename columnuser_name typestring length50 not-nulltrue/ property nameemail columnuser_email typestring length100 not-nullfalse/ property namecreateTime columncreate_time typetimestamp not-nulltrue/ /class /hibernate-mapping邏輯說明hibernate-mapping package...指定默認(rèn)包c(diǎn)lass nameUser中的name是類名非全限定名tablet_user指定數(shù)據(jù)庫表名catalogoa_db指定數(shù)據(jù)庫名MySQL 中可省略id定義主鍵columnuser_id是數(shù)據(jù)庫字段名typestring對(duì)應(yīng) Java 的String類型generator classassigned/表示主鍵由程序賦值如 UUID非數(shù)據(jù)庫自增property映射普通字段length50對(duì)應(yīng)數(shù)據(jù)庫VARCHAR(50)not-nulltrue對(duì)應(yīng)NOT NULL約束。參數(shù)說明nameid必須與User.java中的字段名private String id;嚴(yán)格一致columnuser_id必須與數(shù)據(jù)庫字段名完全相同區(qū)分大小寫typestring是 Hibernate 內(nèi)置類型非 Java 類型常見值有string、integer、timestamp、booleannot-nulltrue會(huì)在save()時(shí)校驗(yàn)若為 null 則拋PropertyValueException。4.2 User.javaPOJO 必須滿足 JavaBean 規(guī)范且無業(yè)務(wù)邏輯User.java是純粹的數(shù)據(jù)載體必須有無參構(gòu)造器、getter/setter 方法且字段類型與.hbm.xml中type一致。// com.simon.oa.user.model.User.java public class User implements Serializable { private static final long serialVersionUID 1L; private String id; private String name; private String email; private Date createTime; // 必須有無參構(gòu)造器Hibernate 反射創(chuàng)建對(duì)象時(shí)調(diào)用 public User() {} // getter/setter 方法IDE 可自動(dòng)生成 public String getId() { return id; } public void setId(String id) { this.id id; } public String getName() { return name; } public void setName(String name) { this.name name; } public String getEmail() { return email; } public void setEmail(String email) { this.email email; } public Date getCreateTime() { return createTime; } public void setCreateTime(Date createTime) { this.createTime createTime; } }邏輯說明implements Serializable是必須的Hibernate 會(huì)序列化對(duì)象serialVersionUID防止類版本不兼容無參構(gòu)造器public User() {}是 Hibernate 創(chuàng)建對(duì)象的入口所有字段必須有 public getter/setter且命名符合 JavaBean 規(guī)范如getId()對(duì)應(yīng)id字段Date類型對(duì)應(yīng).hbm.xml中typetimestamp。參數(shù)說明private String id;的類型String必須與id中typestring匹配private Date createTime;的類型Date必須與property中typetimestamp匹配Hibernate 會(huì)自動(dòng)轉(zhuǎn)換serialVersionUID值可任意但建議固定以避免反序列化問題。4.3 DAO 接口與實(shí)現(xiàn)用 HibernateDaoSupport 封裝模板用 getHibernateTemplate() 執(zhí)行操作DAO 層的接口定義數(shù)據(jù)操作契約實(shí)現(xiàn)類繼承HibernateDaoSupport復(fù)用 Hibernate 模板。// com.simon.oa.user.dao.UserDao.java public interface UserDao { ListUser findAll(); User findById(String id); void save(User user); void update(User user); void delete(User user); } // com.simon.oa.user.dao.hibernate.UserDaoImpl.java public class UserDaoImpl extends HibernateDaoSupport implements UserDao { Override public ListUser findAll() { // 使用 HibernateTemplate 查詢所有 User return (ListUser) getHibernateTemplate().find(from User); } Override public User findById(String id) { // 根據(jù)主鍵查詢HQL 中的 User 是類名非表名 return (User) getHibernateTemplate().get(User.class, id); } Override public void save(User user) { // 保存對(duì)象返回主鍵若 generator 為 assigned則返回 null getHibernateTemplate().save(user); } Override public void update(User user) { getHibernateTemplate().update(user); } Override public void delete(User user) { getHibernateTemplate().delete(user); } }邏輯說明HibernateDaoSupport提供getHibernateTemplate()方法封裝了Session獲取、事務(wù)管理、異常轉(zhuǎn)換等模板邏輯find(from User)是 HQL 查詢User是 Java 類名非數(shù)據(jù)庫表名get(User.class, id)根據(jù)主鍵查詢id是主鍵值save()和update()方法不返回主鍵generatorassigned時(shí)若需返回應(yīng)改用saveOrUpdate()并配合GeneratedValue。參數(shù)說明find(from User)中的User必須與.hbm.xml中class nameUser一致get(User.class, id)的User.class是 Java 類id是主鍵值類型必須與id中type匹配getHibernateTemplate().save(user)會(huì)觸發(fā) INSERT SQLupdate(user)觸發(fā) UPDATE。5. 避坑指南SSH 項(xiàng)目啟動(dòng)失敗的五個(gè)高頻現(xiàn)場(chǎng)與搶救方案SSH 組合框架的調(diào)試不是看日志是讀日志里的異常棧頂?shù)谝恍小?0% 的啟動(dòng)失敗源于 XML 配置的拼寫錯(cuò)誤、路徑錯(cuò)誤或依賴缺失。以下是我在線上環(huán)境反復(fù)踩過的五個(gè)坑按發(fā)生頻率排序每條都附帶真實(shí)現(xiàn)象、根本原因和秒級(jí)修復(fù)法。5.1 現(xiàn)象Tomcat 啟動(dòng)卡死在Initializing Spring root WebApplicationContext無后續(xù)日志原因applicationContext.xml中sessionFactory的mappingResources路徑錯(cuò)誤導(dǎo)致 Hibernate 加載.hbm.xml時(shí)拋出FileNotFoundException但 Spring 默認(rèn)吞掉該異常只打印初始化開始日志。解決打開applicationContext.xml檢查property namemappingResources下的value路徑是否與實(shí)際文件位置一致。例如若User.hbm.xml放在src/com/simon/oa/user/model/目錄則value必須寫為com/simon/oa/user/model/User.hbm.xml注意斜杠方向Windows 下也用/。血淚經(jīng)驗(yàn)用 IDE 的 “Go to Declaration” 功能CtrlClick點(diǎn)擊value內(nèi)容看能否跳轉(zhuǎn)到文件跳不到就是路徑錯(cuò)。5.2 現(xiàn)象訪問/admin/listUser.action報(bào) 404Tomcat 日志顯示No result defined for action com.simon.oa.user.controller.UserAction and result input原因struts.xml中action的class屬性指向的類名與實(shí)際類不匹配或該類未被 Spring 容器管理即applicationContext.xml中缺少對(duì)應(yīng)bean定義。Struts 找不到 Action 實(shí)例便默認(rèn)返回input結(jié)果而input結(jié)果未在result中定義。解決第一步確認(rèn)struts.xml中classcom.simon.oa.user.controller.UserAction的全限定名與 Java 文件路徑完全一致包括大小寫第二步檢查applicationContext.xml是否存在bean iduserAction classcom.simon.oa.user.controller.UserAction且scopeprototype。玄學(xué)排查在UserAction構(gòu)造器里加System.out.println(UserAction created!);啟動(dòng)時(shí)看控制臺(tái)是否打印不打印說明 Spring 根本沒創(chuàng)建它。5.3 現(xiàn)象UserAction.list()執(zhí)行時(shí)報(bào)NullPointerException堆棧指向this.userService.findAllUsers()原因UserAction類中的userService字段未被 Spring 注入因?yàn)閍pplicationContext.xml中userActionBean 的property nameuserService的ref值寫錯(cuò)或userServiceBean 的id與ref不匹配。解決檢查applicationContext.xml中兩處idbean iduserService ...的id必須與bean iduserAction內(nèi)property nameuserService refuserService/的ref值完全一致。翻車現(xiàn)場(chǎng)曾把refuserService寫成refuserservice小寫 sXML 不區(qū)分大小寫但 Spring 區(qū)分導(dǎo)致注入失敗。5.4 現(xiàn)象userDao.findAll()返回空 List但數(shù)據(jù)庫明明有數(shù)據(jù)開啟show_sqltrue后發(fā)現(xiàn) SQL 是select * from User表名大寫原因.hbm.xml中class tablet_user的table屬性寫錯(cuò)或User.java的類名與class nameUser不一致導(dǎo)致 Hibernate 生成錯(cuò)誤的 SQL 表名。MySQL 默認(rèn)表名小寫select * from User會(huì)找不到表。解決打開User.hbm.xml確認(rèn)class tablet_user的table值與數(shù)據(jù)庫實(shí)際表名show tables;查看完全一致同時(shí)確認(rèn)class nameUser的name與User.java的類名一致。后悔藥在hibernateProperties中添加prop keyhibernate.default_schemaoa_db/prop強(qiáng)制指定 schema。5.5 現(xiàn)象userService.updateUser(user)執(zhí)行后數(shù)據(jù)庫無變化show_sqltrue顯示無 UPDATE 語句原因事務(wù)未生效。常見于applicationContext.xml中aop:config的expression切點(diǎn)未匹配到 Service 方法或tx:advice的tx:method未覆蓋updateUser方法名。解決第一步確認(rèn)UserServiceImpl類是否在com.simon.oa.user.service.impl包下切點(diǎn)表達(dá)式execution(* com.simon.oa.user.service.impl.*.*(..))嚴(yán)格匹配包路徑第二步檢查tx:method name*是否在updateUser方法名匹配范圍內(nèi)*匹配所有沒問題第三步在updateUser方法開頭加System.out.println(updateUser called);看是否執(zhí)行不執(zhí)行說明 AOP 未織入。終極排查在UserServiceImpl上加Transactional需升級(jí) Spring 版本臨時(shí)驗(yàn)證若此時(shí)事務(wù)生效證明原 AOP 配置有誤。6. 進(jìn)階技巧用 Hibernate 的merge()替代update()解決 detached object 異常在 SSH 架構(gòu)中最常見的運(yùn)行時(shí)異常是org.hibernate.NonUniqueObjectException: a different object with the same identifier value was already associated with the session。這通常發(fā)生在用戶修改表單后提交UserAction接收到一個(gè)User對(duì)象來自 JSP 表單綁定然后調(diào)用userService.updateUser(user)而UserServiceImpl內(nèi)部又調(diào)用userDao.update(user)。問題在于這個(gè)user對(duì)象是游離態(tài)detached的它曾被某個(gè) Session 加載過但當(dāng)前 Session 并不認(rèn)識(shí)它。update()方法要求對(duì)象必須是游離態(tài)但 Hibernate 發(fā)現(xiàn)當(dāng)前 Session 已加載了同 ID 的另一個(gè)User實(shí)例比如之前查過一次于是拒絕更新。6.1 為什么update()會(huì)失敗而merge()能成功update()的語義是“把這個(gè)游離對(duì)象的狀態(tài)同步到數(shù)據(jù)庫并讓它重新變?yōu)槌志脩B(tài)”。但它有個(gè)隱藏前提當(dāng)前 Session 不能已存在同 ID 的持久化對(duì)象。而merge()的語義是“不管當(dāng)前 Session 有沒有同 ID 對(duì)象都把傳入對(duì)象的狀態(tài)復(fù)制到 Session 中的對(duì)應(yīng)持久化對(duì)象上然后返回那個(gè)持久化對(duì)象”。它不關(guān)心傳入對(duì)象的狀態(tài)只關(guān)心如何把數(shù)據(jù)刷進(jìn)數(shù)據(jù)庫。// UserDaoImpl.java 中的錯(cuò)誤寫法導(dǎo)致 NonUniqueObjectException Override public void update(User user) { getHibernateTemplate().update(user); // 危險(xiǎn) } // 正確寫法用 merge() 替代 update() Override public User merge(User user) { return (User) getHibernateTemplate().merge(user); // 安全 }邏輯說明merge(user)會(huì)先檢查當(dāng)前 Session 是否已存在 ID 相同的User實(shí)例。如果存在就把user的屬性值復(fù)制過去如果不存在就先load()一個(gè)新實(shí)例再復(fù)制。最終返回的是 Session 中的那個(gè)持久化對(duì)象而不是傳入的游離對(duì)象。這樣既保證了數(shù)據(jù)更新又避免了 Session 沖突。參數(shù)說明merge()返回值是Object需強(qiáng)轉(zhuǎn)為User傳入的user對(duì)象在調(diào)用后仍是游離態(tài)不應(yīng)再使用merge()會(huì)觸發(fā) UPDATE SQL效果與update()相同但更健壯。6.2 在 Service 層統(tǒng)一處理將update()封裝為merge()的安全代理為了不讓每個(gè) DAO 都暴露merge()應(yīng)在 Service 層做一層封裝把業(yè)務(wù)方法的語義從“更新對(duì)象”明確為“合并狀態(tài)”。// UserServiceImpl.java Override public void updateUser(User user) { // 業(yè)務(wù)邏輯校驗(yàn)、日志等 if (user.getId() null) { throw new IllegalArgumentException(用戶ID不能為空); } System.out.println(【Service】準(zhǔn)備合并用戶 user.getName()); // 調(diào)用 DAO 的 merge()而非 update() User mergedUser userDao.merge(user); System.out.println(【Service】合并完成ID mergedUser.getId()); }邏輯說明updateUser()方法名保持不變對(duì)外契約但內(nèi)部實(shí)現(xiàn)改為調(diào)用userDao.merge()mergedUser是 Session 中的持久化對(duì)象可用于后續(xù)操作如發(fā)消息、記日志user對(duì)象在merge()后不再有效不應(yīng)再調(diào)用其 getter。參數(shù)說明user.getId()校驗(yàn)放在merge()前因?yàn)閙erge(null)會(huì)拋NullPointerExceptionSystem.out.println()中的mergedUser.getId()能正確打印證明合并成功。6.3 驗(yàn)證 merge() 是否生效三步斷言法要確認(rèn)merge()真正解決了問題不能只看日志要用三步斷言步驟操作預(yù)期結(jié)果說明1. 斷言數(shù)據(jù)庫更新修改用戶姓名后提交查數(shù)據(jù)庫SELECT * FROM t_user WHERE user_id123;user_name字段值已變更證明 SQL 執(zhí)行成功2. 斷言 Session 狀態(tài)在UserServiceImpl.updateUser()中merge()后加System.out.println(isPersistent: getHibernateTemplate().getSessionFactory().getCurrentSession().contains(mergedUser));輸出isPersistent: true證明mergedUser已是當(dāng)前 Session 的持久化對(duì)象3. 斷言無異常拋出連續(xù)兩次提交同一用戶模擬并發(fā)編輯觀察 Tomcat 日志無NonUniqueObjectException只有正常日志證明merge()徹底規(guī)避了游離對(duì)象沖突提示getHibernateTemplate().getSessionFactory().getCurrentSession()獲取當(dāng)前線程綁定的 Sessioncontains(obj)返回true表示obj是該 Session 的持久化對(duì)象。這是驗(yàn)證merge()效果的黃金標(biāo)準(zhǔn)。從那以后我每次寫 DAO 的更新方法都強(qiáng)制本文還有配套的精品資源點(diǎn)擊獲取 Java Web三層架構(gòu)實(shí)戰(zhàn)：SSH解耦原理與職責(zé)隔離
簡介本資源是一份面向Java Web初學(xué)者與中級(jí)開發(fā)者的三層架構(gòu)系統(tǒng)性學(xué)習(xí)文檔聚焦企業(yè)級(jí)Web應(yīng)用的結(jié)構(gòu)設(shè)計(jì)與SSH框架整合實(shí)踐。內(nèi)容深入剖析表示層Struts實(shí)現(xiàn)MVC解耦、業(yè)務(wù)邏輯層Spring IoC/DI與AOP管理及數(shù)據(jù)訪問層Hibernate ORM映射與HQL查詢并結(jié)合Spring 2.5Struts 2.0Hibernate 3.2典型版本組合提供輕量級(jí)、高可維護(hù)的J2EE開發(fā)方案。資源為單個(gè)Word文檔.doc格式全文約102KB涵蓋框架原理、組件職責(zé)劃分、集成機(jī)制圖解及實(shí)際項(xiàng)目落地案例結(jié)構(gòu)清晰、術(shù)語規(guī)范便于對(duì)照理解與課后復(fù)盤。目前已有2376人學(xué)習(xí)下載適合希望夯實(shí)分層思想、掌握SSH協(xié)同開發(fā)流程、提升代碼解耦能力的開發(fā)者系統(tǒng)研讀。1. Java Web 三層架構(gòu)不是分包目錄而是職責(zé)隔離的生存法則你有沒有遇到過這樣的項(xiàng)目改一個(gè)用戶登錄邏輯結(jié)果要?jiǎng)?JSP、Action、Service、DAO、Hibernate 映射文件、SQL 腳本最后連事務(wù)配置都得重測(cè)上線前一小時(shí)發(fā)現(xiàn)UserAction里硬編碼了數(shù)據(jù)庫連接池參數(shù)而UserService又直接 new 了一個(gè)UserDaoImpl——這不是代碼是雷區(qū)地圖。Java Web 三層架構(gòu)表示層 / 業(yè)務(wù)邏輯層 / 數(shù)據(jù)訪問層從來就不是教科書里“把類扔進(jìn) controller、service、dao 三個(gè)包”這么簡單。它是一套經(jīng)過十年以上企業(yè)級(jí)項(xiàng)目血洗驗(yàn)證的職責(zé)契約視圖不碰 SQLService 不寫 HTMLDAO 不管事務(wù)邊界Spring 容器才是唯一能說“誰該依賴誰”的仲裁者。本文講的 SSHStruts 2.0 Spring 2.5 Hibernate 3.2組合不是過時(shí)的古董堆砌而是把 MVC 解耦、IoC 控制流、ORM 映射這三根鋼索擰成一股繩的實(shí)戰(zhàn)范式。它解決的不是“能不能跑”而是“改需求時(shí)敢不敢刪代碼”——當(dāng)你在struts-config.xml里刪掉一個(gè)action卻不用動(dòng)applicationContext.xml里的 bean 定義當(dāng)你把UserDAO接口換成 MyBatis 實(shí)現(xiàn)UserService一行代碼都不用改這才是三層架構(gòu)真正落地的信號(hào)。適合正在維護(hù)老系統(tǒng)、被耦合代碼拖垮的中級(jí) Java 工程師也適合剛從 Spring Boot 轉(zhuǎn)回傳統(tǒng)架構(gòu)、搞不清ActionServlet和DispatcherServlet根本區(qū)別的新人。別急著建 Maven 模塊先搞懂這三層之間誰向誰發(fā)號(hào)施令、誰對(duì)誰負(fù)最終責(zé)任。2. 表示層Struts 2.0 的 Controller 不是轉(zhuǎn)發(fā)器而是請(qǐng)求生命周期的守門人Struts 2.0 的核心不是Action類而是FilterDispatcher或StrutsPrepareAndExecuteFilter攔截的整個(gè) HTTP 請(qǐng)求生命周期。它強(qiáng)制你在struts.xml里聲明“這個(gè) URL 由誰處理、處理完跳哪、出錯(cuò)去哪”把流程控制權(quán)從 Java 代碼里徹底剝離。這不是偷懶是防止UserAction.execute()里突然冒出new UserService().updatePassword(...)這種反模式。2.1 Struts 配置的本質(zhì)用 XML 描述請(qǐng)求路由與結(jié)果映射struts.xml不是配置文件是請(qǐng)求契約說明書。以下是一個(gè)用戶列表功能的標(biāo)準(zhǔn)配置package nameuser extendsstruts-default namespace/admin action namelistUser classcom.simon.oa.user.controller.UserAction methodlist result namesuccess/WEB-INF/jsp/user/list.jsp/result result nameerror/WEB-INF/jsp/error.jsp/result result nameinput/WEB-INF/jsp/user/input.jsp/result /action /package邏輯說明namespace/admin將所有 action 統(tǒng)一掛載到/admin/*路徑下避免 URL 沖突class指向具體 Action 類但注意——這個(gè)類必須由 Spring 容器管理后文詳述否則無法注入 Servicemethodlist表明調(diào)用UserAction.list()方法而非默認(rèn)execute()三個(gè)result分別對(duì)應(yīng)不同返回值success是正常流程error是業(yè)務(wù)異常如權(quán)限不足input是表單校驗(yàn)失敗后回顯頁面。參數(shù)說明namelistUser是 action 的邏輯名客戶端訪問路徑為/admin/listUser.action.action后綴由struts.action.extension配置默認(rèn)啟用result的name必須與 Action 方法return success;中的字符串嚴(yán)格匹配大小寫敏感。2.2 Action 類的設(shè)計(jì)鐵律零業(yè)務(wù)邏輯、零數(shù)據(jù)訪問、只做三件事UserAction的唯一職責(zé)是接收請(qǐng)求參數(shù) → 調(diào)用 Service → 返回結(jié)果字符串。它不該有Autowired注解Spring 2.5 不支持注解驅(qū)動(dòng)靠 XML 注入也不該有sessionFactory字段。標(biāo)準(zhǔn)寫法如下// com.simon.oa.user.controller.UserAction.java public class UserAction extends ActionSupport { private UserService userService; // 僅聲明引用不實(shí)例化 private ListUser userList; // 用于頁面展示的 VO 對(duì)象列表 private String userId; // 接收 URL 參數(shù) ?userId123 // 必須提供 setter 方法供 Struts 框架通過反射注入?yún)?shù) public void setUserId(String userId) { this.userId userId; } // 必須提供 getter 方法供 JSP 頁面通過 ${userList} 訪問 public ListUser getUserList() { return userList; } // 業(yè)務(wù)方法只調(diào)用 Service不處理任何業(yè)務(wù)規(guī)則 public String list() { try { this.userList userService.findAllUsers(); return SUCCESS; // 對(duì)應(yīng) struts.xml 中的 namesuccess } catch (Exception e) { addActionError(獲取用戶列表失敗 e.getMessage()); return ERROR; // 對(duì)應(yīng) nameerror } } }邏輯說明extends ActionSupport提供了addActionError()、getText()等基礎(chǔ)能力setUserId()是 Struts 自動(dòng)調(diào)用的參數(shù)綁定入口URL 中?userId123會(huì)自動(dòng)賦值給userId字段getUserList()是 JSP EL 表達(dá)式${userList}的訪問入口Struts 會(huì)通過反射調(diào)用此方法獲取數(shù)據(jù)list()方法內(nèi)只做userService.findAllUsers()調(diào)用所有分頁、權(quán)限校驗(yàn)、緩存邏輯必須下沉到 Service 層。參數(shù)說明SUCCESS和ERROR是ActionSupport中定義的靜態(tài)常量值為success和error必須與struts.xml中result name...的 name 一致addActionError()的錯(cuò)誤信息會(huì)自動(dòng)傳遞給error.jsp頁面無需手動(dòng)request.setAttribute()。2.3 視圖層JSP 不是模板引擎而是純數(shù)據(jù)渲染器JSP 頁面里禁止出現(xiàn)if (user.getRole().equals(ADMIN))這類業(yè)務(wù)判斷。所有邏輯必須前置到 Action 或 Service。標(biāo)準(zhǔn)list.jsp應(yīng)只做三件事引入 Struts 標(biāo)簽庫、遍歷userList、輸出 HTML 表格。% taglib prefixs uri/struts-tags % html headtitle用戶列表/title/head body h2用戶管理/h2 s:if testuserList ! null userList.size() 0 table border1 trthID/thth姓名/thth郵箱/th/tr s:iterator valueuserList varuser tr tds:property value#user.id//td tds:property value#user.name//td tds:property value#user.email//td /tr /s:iterator /table /s:if s:else p暫無用戶數(shù)據(jù)/p /s:else /body /html邏輯說明s:if和s:iterator是 Struts 2 的標(biāo)簽庫test屬性執(zhí)行 OGNL 表達(dá)式#user.id中的#表示當(dāng)前迭代對(duì)象s:property輸出對(duì)象屬性自動(dòng)處理 null 安全整個(gè)頁面沒有 Java 腳本% %沒有 SQL沒有 if-else 業(yè)務(wù)分支。參數(shù)說明valueuserList中的userList是 Action 中g(shù)etUserList()返回的 ListStruts 會(huì)將其放入 ValueStackvaruser將每次迭代的對(duì)象綁定到#user供后續(xù)標(biāo)簽使用s:else是s:if的配套標(biāo)簽不可省略。3. 業(yè)務(wù)邏輯層Spring 2.5 的 IoC 容器不是工廠而是對(duì)象關(guān)系的憲法Spring 2.5 的核心價(jià)值不在“簡化開發(fā)”而在用 XML 配置強(qiáng)行規(guī)定對(duì)象之間的依賴契約。它讓UserAction不能直接new UserServiceImpl()必須通過容器注入讓UserService不能直接new UserDaoImpl()必須聲明接口依賴。這種“不許你自由戀愛必須由組織介紹”的設(shè)計(jì)才是解耦的根基。3.1 applicationContext.xml用bean定義對(duì)象的出生證與婚姻證applicationContext.xml是 Spring 容器的憲法每個(gè)bean標(biāo)簽定義一個(gè)對(duì)象的創(chuàng)建方式、生命周期和依賴關(guān)系。以下是用戶模塊的核心配置!-- 1. 數(shù)據(jù)源DBCP 連接池 -- bean iddataSource classorg.apache.commons.dbcp.BasicDataSource destroy-methodclose property namedriverClassName valuecom.mysql.jdbc.Driver/ property nameurl valuejdbc:mysql://localhost:3306/oa_db?useUnicodetrueamp;characterEncodingUTF-8/ property nameusername valueroot/ property namepassword value123456/ property namemaxActive value20/ /bean !-- 2. SessionFactoryHibernate 的核心工廠 -- bean idsessionFactory classorg.springframework.orm.hibernate3.LocalSessionFactoryBean property namedataSource refdataSource/ property namemappingResources list valuecom/simon/oa/user/model/User.hbm.xml/value /list /property property namehibernateProperties props prop keyhibernate.dialectorg.hibernate.dialect.MySQLDialect/prop prop keyhibernate.hbm2ddl.autoupdate/prop prop keyhibernate.show_sqltrue/prop /props /property /bean !-- 3. DAO 實(shí)現(xiàn)類繼承 HibernateDaoSupport -- bean iduserDao classcom.simon.oa.user.dao.hibernate.UserDaoImpl property namesessionFactory refsessionFactory/ /bean !-- 4. Service 接口實(shí)現(xiàn)類 -- bean iduserService classcom.simon.oa.user.service.impl.UserServiceImpl property nameuserDao refuserDao/ /bean !-- 5. Struts Action必須由 Spring 管理才能注入 Service -- bean iduserAction classcom.simon.oa.user.controller.UserAction scopeprototype property nameuserService refuserService/ /bean邏輯說明iddataSource定義數(shù)據(jù)源 Beandestroy-methodclose確保容器關(guān)閉時(shí)釋放連接LocalSessionFactoryBean是 Spring 封裝的 Hibernate 工廠mappingResources指定.hbm.xml映射文件路徑注意斜杠方向userDaoBean 的sessionFactory屬性通過refsessionFactory注入形成依賴鏈userService依賴userDaouserAction依賴userService最終形成Action → Service → DAO → SessionFactory → DataSource的完整鏈條scopeprototype是關(guān)鍵——Struts 每次請(qǐng)求都會(huì)創(chuàng)建新 Action 實(shí)例必須設(shè)為 prototype否則多線程下會(huì)共享狀態(tài)。參數(shù)說明property namexxx中的name必須與目標(biāo)類的 setter 方法名一致如setUserService(UserService userService)refxxx引用其他 Bean 的id非class名list和props是 Spring 的集合注入語法prop key...對(duì)應(yīng) Properties 文件的鍵值對(duì)。3.2 Service 接口與實(shí)現(xiàn)用接口隔離變化用實(shí)現(xiàn)專注邏輯UserService接口定義契約UserServiceImpl實(shí)現(xiàn)細(xì)節(jié)。這是 Spring IoC 能生效的前提——依賴必須面向接口而非實(shí)現(xiàn)類。// com.simon.oa.user.service.UserService.java public interface UserService { ListUser findAllUsers(); User findUserById(String id); void updateUser(User user); } // com.simon.oa.user.service.impl.UserServiceImpl.java public class UserServiceImpl implements UserService { private UserDao userDao; // 依賴 DAO 接口非實(shí)現(xiàn)類 public void setUserDao(UserDao userDao) { this.userDao userDao; } Override public ListUser findAllUsers() { // 業(yè)務(wù)邏輯可加日志、權(quán)限檢查、緩存等橫切關(guān)注點(diǎn) System.out.println(【Service】開始查詢所有用戶); ListUser users userDao.findAll(); // 調(diào)用 DAO 接口方法 System.out.println(【Service】查詢到 users.size() 個(gè)用戶); return users; } Override public User findUserById(String id) { // 業(yè)務(wù)邏輯ID 校驗(yàn)、空值處理 if (id null || id.trim().length() 0) { throw new IllegalArgumentException(用戶ID不能為空); } return userDao.findById(id); } }邏輯說明UserServiceImpl中setUserDao()是 Spring 注入入口userDao字段類型是接口UserDao而非UserDaoImplfindAllUsers()方法內(nèi)只做日志和調(diào)用所有數(shù)據(jù)庫操作委托給userDao.findAll()findUserById()做了 ID 校驗(yàn)這是 Service 層該承擔(dān)的職責(zé)Action 只做參數(shù)接收DAO 只做數(shù)據(jù)存取。參數(shù)說明Override注解確保實(shí)現(xiàn)類方法與接口簽名一致throw new IllegalArgumentException()是業(yè)務(wù)異常會(huì)被 Struts 捕獲并跳轉(zhuǎn)到error.jspSystem.out.println()是調(diào)試日志實(shí)際項(xiàng)目應(yīng)替換為 Log4j。3.3 事務(wù)管理不是加個(gè)Transactional而是用 AOP 切面織入Spring 2.5 不支持注解式事務(wù)Transactional是 2.5 之后版本才引入必須用 AOP 配置。事務(wù)邊界必須圈定在 Service 方法上DAO 層絕不開啟事務(wù)。!-- 在 applicationContext.xml 中追加事務(wù)配置 -- bean idtransactionManager classorg.springframework.orm.hibernate3.HibernateTransactionManager property namesessionFactory refsessionFactory/ /bean aop:config aop:pointcut idserviceMethods expressionexecution(* com.simon.oa.user.service.impl.*.*(..))/ aop:advisor advice-reftxAdvice pointcut-refserviceMethods/ /aop:config tx:advice idtxAdvice transaction-managertransactionManager tx:attributes tx:method namefind* read-onlytrue/ tx:method nameget* read-onlytrue/ tx:method name* propagationREQUIRED/ /tx:attributes /tx:advice邏輯說明aop:pointcut定義切點(diǎn)匹配com.simon.oa.user.service.impl包下所有類的所有方法aop:advisor將事務(wù)通知txAdvice織入切點(diǎn)tx:method指定事務(wù)規(guī)則find*和get*方法設(shè)為只讀read-onlytrue提升性能其他方法*使用REQUIRED傳播行為如果已有事務(wù)則加入否則新建。參數(shù)說明propagationREQUIRED是最常用行為確保updateUser()方法在事務(wù)中執(zhí)行read-onlytrue會(huì)禁用 Hibernate 的臟檢查減少數(shù)據(jù)庫壓力transaction-managertransactionManager引用上面定義的事務(wù)管理器 Bean。4. 數(shù)據(jù)訪問層Hibernate 3.2 的 .hbm.xml 不是配置而是對(duì)象與表的婚書Hibernate 3.2 的核心是.hbm.xml映射文件它用 XML 聲明 Java 類與數(shù)據(jù)庫表的字段對(duì)應(yīng)關(guān)系。這不是可選配置而是 ORM 的法律依據(jù)。一旦映射出錯(cuò)save()會(huì)靜默失敗load()會(huì)返回 null——沒有報(bào)錯(cuò)只有沉默的崩潰。4.1 User.hbm.xml用class定義類與表的綁定用id定義主鍵策略User.hbm.xml必須與User.java同包且文件名嚴(yán)格匹配類名 .hbm.xml。以下是標(biāo)準(zhǔn)模板?xml version1.0 encodingUTF-8? !DOCTYPE hibernate-mapping PUBLIC -//Hibernate/Hibernate Mapping DTD 3.0//EN http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd hibernate-mapping packagecom.simon.oa.user.model class nameUser tablet_user catalogoa_db !-- 主鍵映射 -- id nameid columnuser_id typestring generator classassigned/ /id !-- 屬性映射 -- property namename columnuser_name typestring length50 not-nulltrue/ property nameemail columnuser_email typestring length100 not-nullfalse/ property namecreateTime columncreate_time typetimestamp not-nulltrue/ /class /hibernate-mapping邏輯說明hibernate-mapping package...指定默認(rèn)包c(diǎn)lass nameUser中的name是類名非全限定名tablet_user指定數(shù)據(jù)庫表名catalogoa_db指定數(shù)據(jù)庫名MySQL 中可省略id定義主鍵columnuser_id是數(shù)據(jù)庫字段名typestring對(duì)應(yīng) Java 的String類型generator classassigned/表示主鍵由程序賦值如 UUID非數(shù)據(jù)庫自增property映射普通字段length50對(duì)應(yīng)數(shù)據(jù)庫VARCHAR(50)not-nulltrue對(duì)應(yīng)NOT NULL約束。參數(shù)說明nameid必須與User.java中的字段名private String id;嚴(yán)格一致columnuser_id必須與數(shù)據(jù)庫字段名完全相同區(qū)分大小寫typestring是 Hibernate 內(nèi)置類型非 Java 類型常見值有string、integer、timestamp、booleannot-nulltrue會(huì)在save()時(shí)校驗(yàn)若為 null 則拋PropertyValueException。4.2 User.javaPOJO 必須滿足 JavaBean 規(guī)范且無業(yè)務(wù)邏輯User.java是純粹的數(shù)據(jù)載體必須有無參構(gòu)造器、getter/setter 方法且字段類型與.hbm.xml中type一致。// com.simon.oa.user.model.User.java public class User implements Serializable { private static final long serialVersionUID 1L; private String id; private String name; private String email; private Date createTime; // 必須有無參構(gòu)造器Hibernate 反射創(chuàng)建對(duì)象時(shí)調(diào)用 public User() {} // getter/setter 方法IDE 可自動(dòng)生成 public String getId() { return id; } public void setId(String id) { this.id id; } public String getName() { return name; } public void setName(String name) { this.name name; } public String getEmail() { return email; } public void setEmail(String email) { this.email email; } public Date getCreateTime() { return createTime; } public void setCreateTime(Date createTime) { this.createTime createTime; } }邏輯說明implements Serializable是必須的Hibernate 會(huì)序列化對(duì)象serialVersionUID防止類版本不兼容無參構(gòu)造器public User() {}是 Hibernate 創(chuàng)建對(duì)象的入口所有字段必須有 public getter/setter且命名符合 JavaBean 規(guī)范如getId()對(duì)應(yīng)id字段Date類型對(duì)應(yīng).hbm.xml中typetimestamp。參數(shù)說明private String id;的類型String必須與id中typestring匹配private Date createTime;的類型Date必須與property中typetimestamp匹配Hibernate 會(huì)自動(dòng)轉(zhuǎn)換serialVersionUID值可任意但建議固定以避免反序列化問題。4.3 DAO 接口與實(shí)現(xiàn)用 HibernateDaoSupport 封裝模板用 getHibernateTemplate() 執(zhí)行操作DAO 層的接口定義數(shù)據(jù)操作契約實(shí)現(xiàn)類繼承HibernateDaoSupport復(fù)用 Hibernate 模板。// com.simon.oa.user.dao.UserDao.java public interface UserDao { ListUser findAll(); User findById(String id); void save(User user); void update(User user); void delete(User user); } // com.simon.oa.user.dao.hibernate.UserDaoImpl.java public class UserDaoImpl extends HibernateDaoSupport implements UserDao { Override public ListUser findAll() { // 使用 HibernateTemplate 查詢所有 User return (ListUser) getHibernateTemplate().find(from User); } Override public User findById(String id) { // 根據(jù)主鍵查詢HQL 中的 User 是類名非表名 return (User) getHibernateTemplate().get(User.class, id); } Override public void save(User user) { // 保存對(duì)象返回主鍵若 generator 為 assigned則返回 null getHibernateTemplate().save(user); } Override public void update(User user) { getHibernateTemplate().update(user); } Override public void delete(User user) { getHibernateTemplate().delete(user); } }邏輯說明HibernateDaoSupport提供getHibernateTemplate()方法封裝了Session獲取、事務(wù)管理、異常轉(zhuǎn)換等模板邏輯find(from User)是 HQL 查詢User是 Java 類名非數(shù)據(jù)庫表名get(User.class, id)根據(jù)主鍵查詢id是主鍵值save()和update()方法不返回主鍵generatorassigned時(shí)若需返回應(yīng)改用saveOrUpdate()并配合GeneratedValue。參數(shù)說明find(from User)中的User必須與.hbm.xml中class nameUser一致get(User.class, id)的User.class是 Java 類id是主鍵值類型必須與id中type匹配getHibernateTemplate().save(user)會(huì)觸發(fā) INSERT SQLupdate(user)觸發(fā) UPDATE。5. 避坑指南SSH 項(xiàng)目啟動(dòng)失敗的五個(gè)高頻現(xiàn)場(chǎng)與搶救方案SSH 組合框架的調(diào)試不是看日志是讀日志里的異常棧頂?shù)谝恍小?0% 的啟動(dòng)失敗源于 XML 配置的拼寫錯(cuò)誤、路徑錯(cuò)誤或依賴缺失。以下是我在線上環(huán)境反復(fù)踩過的五個(gè)坑按發(fā)生頻率排序每條都附帶真實(shí)現(xiàn)象、根本原因和秒級(jí)修復(fù)法。5.1 現(xiàn)象Tomcat 啟動(dòng)卡死在Initializing Spring root WebApplicationContext無后續(xù)日志原因applicationContext.xml中sessionFactory的mappingResources路徑錯(cuò)誤導(dǎo)致 Hibernate 加載.hbm.xml時(shí)拋出FileNotFoundException但 Spring 默認(rèn)吞掉該異常只打印初始化開始日志。解決打開applicationContext.xml檢查property namemappingResources下的value路徑是否與實(shí)際文件位置一致。例如若User.hbm.xml放在src/com/simon/oa/user/model/目錄則value必須寫為com/simon/oa/user/model/User.hbm.xml注意斜杠方向Windows 下也用/。血淚經(jīng)驗(yàn)用 IDE 的 “Go to Declaration” 功能CtrlClick點(diǎn)擊value內(nèi)容看能否跳轉(zhuǎn)到文件跳不到就是路徑錯(cuò)。5.2 現(xiàn)象訪問/admin/listUser.action報(bào) 404Tomcat 日志顯示No result defined for action com.simon.oa.user.controller.UserAction and result input原因struts.xml中action的class屬性指向的類名與實(shí)際類不匹配或該類未被 Spring 容器管理即applicationContext.xml中缺少對(duì)應(yīng)bean定義。Struts 找不到 Action 實(shí)例便默認(rèn)返回input結(jié)果而input結(jié)果未在result中定義。解決第一步確認(rèn)struts.xml中classcom.simon.oa.user.controller.UserAction的全限定名與 Java 文件路徑完全一致包括大小寫第二步檢查applicationContext.xml是否存在bean iduserAction classcom.simon.oa.user.controller.UserAction且scopeprototype。玄學(xué)排查在UserAction構(gòu)造器里加System.out.println(UserAction created!);啟動(dòng)時(shí)看控制臺(tái)是否打印不打印說明 Spring 根本沒創(chuàng)建它。5.3 現(xiàn)象UserAction.list()執(zhí)行時(shí)報(bào)NullPointerException堆棧指向this.userService.findAllUsers()原因UserAction類中的userService字段未被 Spring 注入因?yàn)閍pplicationContext.xml中userActionBean 的property nameuserService的ref值寫錯(cuò)或userServiceBean 的id與ref不匹配。解決檢查applicationContext.xml中兩處idbean iduserService ...的id必須與bean iduserAction內(nèi)property nameuserService refuserService/的ref值完全一致。翻車現(xiàn)場(chǎng)曾把refuserService寫成refuserservice小寫 sXML 不區(qū)分大小寫但 Spring 區(qū)分導(dǎo)致注入失敗。5.4 現(xiàn)象userDao.findAll()返回空 List但數(shù)據(jù)庫明明有數(shù)據(jù)開啟show_sqltrue后發(fā)現(xiàn) SQL 是select * from User表名大寫原因.hbm.xml中class tablet_user的table屬性寫錯(cuò)或User.java的類名與class nameUser不一致導(dǎo)致 Hibernate 生成錯(cuò)誤的 SQL 表名。MySQL 默認(rèn)表名小寫select * from User會(huì)找不到表。解決打開User.hbm.xml確認(rèn)class tablet_user的table值與數(shù)據(jù)庫實(shí)際表名show tables;查看完全一致同時(shí)確認(rèn)class nameUser的name與User.java的類名一致。后悔藥在hibernateProperties中添加prop keyhibernate.default_schemaoa_db/prop強(qiáng)制指定 schema。5.5 現(xiàn)象userService.updateUser(user)執(zhí)行后數(shù)據(jù)庫無變化show_sqltrue顯示無 UPDATE 語句原因事務(wù)未生效。常見于applicationContext.xml中aop:config的expression切點(diǎn)未匹配到 Service 方法或tx:advice的tx:method未覆蓋updateUser方法名。解決第一步確認(rèn)UserServiceImpl類是否在com.simon.oa.user.service.impl包下切點(diǎn)表達(dá)式execution(* com.simon.oa.user.service.impl.*.*(..))嚴(yán)格匹配包路徑第二步檢查tx:method name*是否在updateUser方法名匹配范圍內(nèi)*匹配所有沒問題第三步在updateUser方法開頭加System.out.println(updateUser called);看是否執(zhí)行不執(zhí)行說明 AOP 未織入。終極排查在UserServiceImpl上加Transactional需升級(jí) Spring 版本臨時(shí)驗(yàn)證若此時(shí)事務(wù)生效證明原 AOP 配置有誤。6. 進(jìn)階技巧用 Hibernate 的merge()替代update()解決 detached object 異常在 SSH 架構(gòu)中最常見的運(yùn)行時(shí)異常是org.hibernate.NonUniqueObjectException: a different object with the same identifier value was already associated with the session。這通常發(fā)生在用戶修改表單后提交UserAction接收到一個(gè)User對(duì)象來自 JSP 表單綁定然后調(diào)用userService.updateUser(user)而UserServiceImpl內(nèi)部又調(diào)用userDao.update(user)。問題在于這個(gè)user對(duì)象是游離態(tài)detached的它曾被某個(gè) Session 加載過但當(dāng)前 Session 并不認(rèn)識(shí)它。update()方法要求對(duì)象必須是游離態(tài)但 Hibernate 發(fā)現(xiàn)當(dāng)前 Session 已加載了同 ID 的另一個(gè)User實(shí)例比如之前查過一次于是拒絕更新。6.1 為什么update()會(huì)失敗而merge()能成功update()的語義是“把這個(gè)游離對(duì)象的狀態(tài)同步到數(shù)據(jù)庫并讓它重新變?yōu)槌志脩B(tài)”。但它有個(gè)隱藏前提當(dāng)前 Session 不能已存在同 ID 的持久化對(duì)象。而merge()的語義是“不管當(dāng)前 Session 有沒有同 ID 對(duì)象都把傳入對(duì)象的狀態(tài)復(fù)制到 Session 中的對(duì)應(yīng)持久化對(duì)象上然后返回那個(gè)持久化對(duì)象”。它不關(guān)心傳入對(duì)象的狀態(tài)只關(guān)心如何把數(shù)據(jù)刷進(jìn)數(shù)據(jù)庫。// UserDaoImpl.java 中的錯(cuò)誤寫法導(dǎo)致 NonUniqueObjectException Override public void update(User user) { getHibernateTemplate().update(user); // 危險(xiǎn) } // 正確寫法用 merge() 替代 update() Override public User merge(User user) { return (User) getHibernateTemplate().merge(user); // 安全 }邏輯說明merge(user)會(huì)先檢查當(dāng)前 Session 是否已存在 ID 相同的User實(shí)例。如果存在就把user的屬性值復(fù)制過去如果不存在就先load()一個(gè)新實(shí)例再復(fù)制。最終返回的是 Session 中的那個(gè)持久化對(duì)象而不是傳入的游離對(duì)象。這樣既保證了數(shù)據(jù)更新又避免了 Session 沖突。參數(shù)說明merge()返回值是Object需強(qiáng)轉(zhuǎn)為User傳入的user對(duì)象在調(diào)用后仍是游離態(tài)不應(yīng)再使用merge()會(huì)觸發(fā) UPDATE SQL效果與update()相同但更健壯。6.2 在 Service 層統(tǒng)一處理將update()封裝為merge()的安全代理為了不讓每個(gè) DAO 都暴露merge()應(yīng)在 Service 層做一層封裝把業(yè)務(wù)方法的語義從“更新對(duì)象”明確為“合并狀態(tài)”。// UserServiceImpl.java Override public void updateUser(User user) { // 業(yè)務(wù)邏輯校驗(yàn)、日志等 if (user.getId() null) { throw new IllegalArgumentException(用戶ID不能為空); } System.out.println(【Service】準(zhǔn)備合并用戶 user.getName()); // 調(diào)用 DAO 的 merge()而非 update() User mergedUser userDao.merge(user); System.out.println(【Service】合并完成ID mergedUser.getId()); }邏輯說明updateUser()方法名保持不變對(duì)外契約但內(nèi)部實(shí)現(xiàn)改為調(diào)用userDao.merge()mergedUser是 Session 中的持久化對(duì)象可用于后續(xù)操作如發(fā)消息、記日志user對(duì)象在merge()后不再有效不應(yīng)再調(diào)用其 getter。參數(shù)說明user.getId()校驗(yàn)放在merge()前因?yàn)閙erge(null)會(huì)拋NullPointerExceptionSystem.out.println()中的mergedUser.getId()能正確打印證明合并成功。6.3 驗(yàn)證 merge() 是否生效三步斷言法要確認(rèn)merge()真正解決了問題不能只看日志要用三步斷言步驟操作預(yù)期結(jié)果說明1. 斷言數(shù)據(jù)庫更新修改用戶姓名后提交查數(shù)據(jù)庫SELECT * FROM t_user WHERE user_id123;user_name字段值已變更證明 SQL 執(zhí)行成功2. 斷言 Session 狀態(tài)在UserServiceImpl.updateUser()中merge()后加System.out.println(isPersistent: getHibernateTemplate().getSessionFactory().getCurrentSession().contains(mergedUser));輸出isPersistent: true證明mergedUser已是當(dāng)前 Session 的持久化對(duì)象3. 斷言無異常拋出連續(xù)兩次提交同一用戶模擬并發(fā)編輯觀察 Tomcat 日志無NonUniqueObjectException只有正常日志證明merge()徹底規(guī)避了游離對(duì)象沖突提示getHibernateTemplate().getSessionFactory().getCurrentSession()獲取當(dāng)前線程綁定的 Sessioncontains(obj)返回true表示obj是該 Session 的持久化對(duì)象。這是驗(yàn)證merge()效果的黃金標(biāo)準(zhǔn)。從那以后我每次寫 DAO 的更新方法都強(qiáng)制本文還有配套的精品資源點(diǎn)擊獲取