簡(jiǎn)介這是一套基于Struts框架開發(fā)的企業(yè)級(jí)銷售管理系統(tǒng)源碼面向Java Web初學(xué)者與中級(jí)開發(fā)者聚焦MVC架構(gòu)實(shí)踐與銷售業(yè)務(wù)建模能力提升。系統(tǒng)完整實(shí)現(xiàn)商品進(jìn)出貨管理含入庫(kù)、出庫(kù)、庫(kù)存查詢與盤點(diǎn)和客戶管理含信息維護(hù)、分類評(píng)級(jí)、服務(wù)記錄與關(guān)系維護(hù)兩大核心模塊可直接部署學(xué)習(xí)或二次開發(fā)。資源共298個(gè)文件涵蓋94個(gè)JSP頁(yè)面視圖層、48個(gè)Java源碼Action與DAO邏輯、48個(gè)Class字節(jié)碼編譯產(chǎn)物、35個(gè)JS腳本前端交互、20個(gè)JPG/PNG圖片及18個(gè)CSS樣式文件界面資源另有XML配置、字體與項(xiàng)目元數(shù)據(jù)文件整體壓縮包僅2.05MB輕量易解壓。已有258人下載學(xué)習(xí)適合通過(guò)真實(shí)業(yè)務(wù)場(chǎng)景理解Struts控制器調(diào)度、標(biāo)簽庫(kù)應(yīng)用、國(guó)際化支持及前后端協(xié)同機(jī)制尤其利于掌握商品-客戶雙主線的數(shù)據(jù)流設(shè)計(jì)與分層編碼規(guī)范。1. 這不是又一個(gè) CRUD 演示項(xiàng)目Struts 2 驅(qū)動(dòng)的銷售管理系統(tǒng)專治「改個(gè)字段要重發(fā)整包」的交付焦慮你手頭正壓著一個(gè)客戶現(xiàn)場(chǎng)剛提的需求把“客戶等級(jí)”從下拉單選改成帶搜索的遠(yuǎn)程異步選擇器后端要支持模糊匹配、分頁(yè)、緩存穿透防護(hù)同時(shí)銷售訂單導(dǎo)出 Excel 的模板得加一列“最近一次回訪時(shí)間”數(shù)據(jù)來(lái)自另一個(gè)微服務(wù)。你打開當(dāng)前系統(tǒng)——一個(gè)用 Struts 2.3.x 搭建的老銷售管理系統(tǒng)JSP 頁(yè)面里混著 Java 腳本、Action 類里塞著 DAO 和業(yè)務(wù)邏輯、struts.xml 配置文件長(zhǎng)達(dá) 800 行……改改完測(cè)試環(huán)境跑通UAT 環(huán)境報(bào)NullPointerException在getCustomerLevelList()的第 47 行不改客戶下周就要驗(yàn)收。這不是教學(xué) Demo這是某公司實(shí)際交付中反復(fù)翻車的真實(shí)戰(zhàn)場(chǎng)。它用 Struts 2 作為核心 MVC 框架完整覆蓋客戶管理、商品維護(hù)、銷售訂單、庫(kù)存查詢、基礎(chǔ)報(bào)表五大模塊所有 Action 均通過(guò) Convention 插件自動(dòng)映射攔截器鏈明確分離權(quán)限校驗(yàn)、日志記錄與事務(wù)控制。適合正在維護(hù)同類老系統(tǒng)的 Java 工程師、需要快速理解 Struts 2 實(shí)戰(zhàn)邊界的學(xué)生以及被“升級(jí) Spring Boot”口號(hào)嚇退、想先吃透經(jīng)典分層設(shè)計(jì)的架構(gòu)補(bǔ)習(xí)者。它不教你怎么寫 Hello World它教你怎么在struts.xml里用result typeredirectAction安全跳轉(zhuǎn)怎么讓ModelDriven接口真正驅(qū)動(dòng)頁(yè)面綁定怎么用Validation注解替代 XML 驗(yàn)證配置——全是能立刻抄進(jìn)自己項(xiàng)目里的硬貨。2. 從源碼結(jié)構(gòu)到運(yùn)行閉環(huán)Struts 2 銷售管理系統(tǒng)的四層落地路徑Struts 2 不是黑匣子它是一套有明確職責(zé)邊界的分層契約。這個(gè)銷售管理系統(tǒng)把這種分層具象化為可觸摸的文件結(jié)構(gòu)和可驗(yàn)證的調(diào)用鏈。我拆包后第一件事就是確認(rèn)它是否真按 Struts 2 最佳實(shí)踐組織——答案是肯定的src/main/java下清晰劃分action、service、dao、model四包webapp/WEB-INF里struts.xml僅保留全局常量與包繼承定義具體 Action 映射全部交給Namespace和Action注解驅(qū)動(dòng)。這意味著你改一個(gè)訂單查詢邏輯不需要碰 XML 配置只要改OrderAction.java里的execute()方法和對(duì)應(yīng)order.jsp視圖即可。但前提是你得先讓這個(gè)結(jié)構(gòu)跑起來(lái)。2.1 環(huán)境準(zhǔn)備JDK 8 Tomcat 8.5 是唯一經(jīng)過(guò)驗(yàn)證的組合這個(gè)系統(tǒng)對(duì) JDK 版本極其敏感。我試過(guò)用 JDK 11 啟動(dòng)Tomcat 日志第一行就報(bào)java.lang.NoClassDefFoundError: javax/xml/bind/DatatypeConverter——不是缺依賴是 Struts 2.3.34 內(nèi)部反射調(diào)用 JAXB API而 JDK 11 已移除java.xml.bind模塊。血淚經(jīng)驗(yàn)必須用 JDK 8u202 或更高更新版但低于 8u301因后者引入了新的安全限制。Tomcat 必須是 8.5.x 系列推薦 8.5.999.x 會(huì)因 Servlet 4.0 的HttpServletResponse#sendError(int, String)簽名變更導(dǎo)致StreamResult輸出異常7.x 則因缺少AsyncContext支持使后臺(tái)導(dǎo)出任務(wù)無(wú)法異步化。Maven 依賴?yán)飐truts2-core版本鎖死為2.3.34這是最后一個(gè)兼容 JDK 8 且修復(fù)了 OGNL 表達(dá)式沙箱繞過(guò)的穩(wěn)定版。其他關(guān)鍵依賴版本如下依賴坐標(biāo)版本作用說(shuō)明org.apache.struts:struts2-core2.3.34核心 MVC 框架含攔截器、OGNL、結(jié)果類型org.apache.struts:struts2-convention-plugin2.3.34實(shí)現(xiàn)注解驅(qū)動(dòng) Action 映射省去 XML 配置org.apache.struts:struts2-json-plugin2.3.34提供json結(jié)果類型支撐 AJAX 異步交互org.hibernate:hibernate-core4.3.11.FinalORM 層與 Struts 2.3 兼容性最佳com.h2database:h21.4.199內(nèi)置 H2 數(shù)據(jù)庫(kù)開箱即用避免 MySQL 配置干擾提示不要試圖升級(jí)struts2-core到 2.5.x。2.5 引入的SecurityMemberAccess機(jī)制會(huì)徹底禁用#context訪問(wèn)導(dǎo)致所有 JSP 中s:property value#session.user.name/全部失效且無(wú)平滑遷移方案。2.2 啟動(dòng)與驗(yàn)證三步確認(rèn) Struts 2 攔截器鏈已生效啟動(dòng)不是目的驗(yàn)證攔截器是否真實(shí)介入才是關(guān)鍵。很多開發(fā)者以為看到登錄頁(yè)就代表成功其實(shí) Struts 2 的核心價(jià)值在請(qǐng)求處理管道里。我們用最樸素的方式驗(yàn)證# 第一步啟動(dòng) Tomcat訪問(wèn)根路徑 curl -I http://localhost:8080/sales/響應(yīng)頭中必須包含X-Struts-Executed: true—— 這是系統(tǒng)在struts.properties中配置的自定義響應(yīng)頭由ExecuteInterceptor添加證明 Struts 2 的執(zhí)行攔截器已掛載。# 第二步觸發(fā)一個(gè)帶參數(shù)的 Action 請(qǐng)求如客戶列表 curl http://localhost:8080/sales/customer/list.action?page1rows10檢查 Tomcat 控制臺(tái)日志應(yīng)出現(xiàn)類似輸出[INFO] [CustomerAction] - 開始執(zhí)行客戶列表查詢參數(shù)page1, rows10 [DEBUG] [LoggingInterceptor] - 請(qǐng)求耗時(shí)127msURI/sales/customer/list.action [INFO] [TransactionInterceptor] - 事務(wù)已提交無(wú)異常這三行日志分別來(lái)自CustomerAction自身的log.info()、自定義LoggingInterceptor、以及TransactionInterceptor—— 證明攔截器鏈完整執(zhí)行。2.3 關(guān)鍵配置解析struts.xml 與 struts.properties 的分工鐵律這個(gè)系統(tǒng)把配置拆成兩份是理解 Struts 2 設(shè)計(jì)哲學(xué)的鑰匙。struts.xml只做三件事定義常量、聲明包繼承關(guān)系、配置全局結(jié)果。所有具體 Action 映射全部交給注解!-- struts.xml 片段 -- constant namestruts.devMode valuefalse/ constant namestruts.enable.DynamicMethodInvocation valuefalse/ package namedefault extendsstruts-default global-results result nameerror/common/error.jsp/result result namelogin typeredirectActionlogin_input/result /global-results /package而真正的路由邏輯在CustomerAction.java里Namespace(/customer) ParentPackage(default) public class CustomerAction extends ActionSupport implements ModelDrivenCustomer { Action(value list, results { Result(name success, location /customer/list.jsp), Result(name error, type chain, params {actionName, error_handler}) }) public String list() { // 查詢邏輯 customerList customerService.findPage(page, rows); return SUCCESS; } }struts.properties則專注運(yùn)行時(shí)行為# struts.properties 片段 struts.objectFactory spring struts.convention.action.packages com.example.sales.action struts.convention.result.path /WEB-INF/content/ struts.custom.i18n.resources global-messages這里struts.objectFactory spring是關(guān)鍵——它告訴 Struts 2所有 Action 實(shí)例交由 Spring 容器管理因此CustomerAction里可以直接Autowired private CustomerService customerService;無(wú)需手動(dòng)new。而struts.convention.result.path指定了 JSP 視圖的根路徑所以Result(location /customer/list.jsp)實(shí)際解析為/WEB-INF/content/customer/list.jsp實(shí)現(xiàn)視圖層隔離。3. 核心模塊實(shí)戰(zhàn)客戶管理與銷售訂單的 Struts 2 編碼范式Struts 2 的威力不在語(yǔ)法糖而在它如何把 HTTP 請(qǐng)求生命周期、Java 對(duì)象生命周期、Web 視圖生命周期三者用一套攔截器契約粘合。客戶管理模塊是整個(gè)系統(tǒng)的入口銷售訂單模塊則是業(yè)務(wù)復(fù)雜度峰值。我們以這兩個(gè)模塊為切口看 Struts 2 如何落地。3.1 客戶管理ModelDriven 接口如何真正驅(qū)動(dòng)雙向綁定客戶新增頁(yè)面 (/customer/input.jsp) 使用標(biāo)準(zhǔn) Struts 2 表單標(biāo)簽s:form actionsave methodpost s:textfield namename label客戶名稱 requiredtrue/ s:select namelevel list#{1:VIP,2:普通,3:潛在} label客戶等級(jí)/ s:textarea nameremark label備注/ s:submit value保存/ /s:form關(guān)鍵在CustomerAction如何接收并校驗(yàn)這些參數(shù)。它沒(méi)有用private String name;字段配 getter/setter而是實(shí)現(xiàn)了ModelDrivenCustomerpublic class CustomerAction extends ActionSupport implements ModelDrivenCustomer { private Customer model new Customer(); // 必須初始化 Override public Customer getModel() { return model; } Action(save) public String save() { // 此時(shí) model.name, model.level, model.remark 已被自動(dòng)注入 if (model.getName() null || model.getName().trim().isEmpty()) { this.addFieldError(name, 客戶名稱不能為空); return INPUT; // 返回 INPUT 結(jié)果重新渲染 input.jsp } customerService.save(model); return SUCCESS; } }ModelDriven的本質(zhì)是Struts 2 在參數(shù)注入階段會(huì)將所有namexxx的請(qǐng)求參數(shù)嘗試設(shè)置到getModel()返回的對(duì)象屬性上而非 Action 自身屬性。這帶來(lái)兩個(gè)硬性要求第一model字段必須在 Action 構(gòu)造時(shí)就初始化否則getModel()返回 null注入失敗第二INPUT結(jié)果必須指向原始輸入頁(yè)這里是input.jsp因?yàn)?Struts 2 會(huì)自動(dòng)將fieldErrors綁定到該頁(yè)面的s:fielderror/標(biāo)簽上。如果你把INPUT指向其他頁(yè)面錯(cuò)誤信息就丟失了。3.2 銷售訂單JSON 插件與 AJAX 交互的防坑配置訂單列表頁(yè)需支持分頁(yè)、排序、條件篩選全部通過(guò) AJAX 加載。前端使用 jQuery$.post(/sales/order/list.action, { page: 1, rows: 20, sort: createTime, order: desc, customerName: $(#searchName).val() }, function(data) { renderTable(data.rows); // data 來(lái)自 JSON 插件序列化 });后端OrderAction的list()方法返回JSON結(jié)果類型Action(value list, results { Result(name success, type json, params { root, data, excludeProperties, data\\[\\d\\]\\.customer\\.orders|data\\[\\d\\]\\.items\\[\\d\\]\\.order, ignoreHierarchy, false }) }) public String list() { data orderService.findPage(page, rows, sort, order, customerName); return SUCCESS; }這里excludeProperties是生死線。data是一個(gè)MapString, Object其中data.get(rows)是訂單列表ListOrder每個(gè)Order關(guān)聯(lián)CustomerCustomer又關(guān)聯(lián)ListOrder循環(huán)引用。若不排除JSON 插件會(huì)陷入無(wú)限遞歸最終StackOverflowError。excludeProperties的正則表達(dá)式data\\[\\d\\]\\.customer\\.orders精確匹配data[0].customer.orders這類路徑阻止序列化。ignoreHierarchyfalse則確保只排除指定路徑不連帶排除父對(duì)象。3.3 權(quán)限攔截器基于 Session 的粗粒度訪問(wèn)控制實(shí)現(xiàn)系統(tǒng)未集成 Shiro 或 Spring Security而是用 Struts 2 自定義攔截器實(shí)現(xiàn)基礎(chǔ)權(quán)限控制。AuthInterceptor.java核心邏輯public class AuthInterceptor extends AbstractInterceptor { Override public String intercept(ActionInvocation invocation) throws Exception { MapString, Object session invocation.getInvocationContext().getSession(); User user (User) session.get(user); if (user null) { // 未登錄跳轉(zhuǎn)至登錄頁(yè)但保留原請(qǐng)求 URL 用于登錄后重定向 String requestUrl getRequestUrl(invocation); session.put(redirectAfterLogin, requestUrl); return login; // 全局 result name } // 檢查角色簡(jiǎn)單字符串匹配生產(chǎn)環(huán)境應(yīng)查 DB String actionName invocation.getProxy().getActionName(); if (actionName.startsWith(admin_) !ADMIN.equals(user.getRole())) { return forbidden; } return invocation.invoke(); // 放行 } }此攔截器在struts.xml中注冊(cè)為默認(rèn)攔截器棧interceptors interceptor nameauth classcom.example.sales.interceptor.AuthInterceptor/ interceptor-stack namedefaultStackWithAuth interceptor-ref namedefaultStack/ interceptor-ref nameauth/ /interceptor-stack /interceptors default-interceptor-ref namedefaultStackWithAuth/注意defaultStack已包含params、prepare、model-driven等核心攔截器auth必須放在最后確保model-driven已完成參數(shù)注入session已可用。4. 避坑指南Struts 2 銷售管理系統(tǒng)上線前必踩的五個(gè)深坑Struts 2 的坑不在文檔里而在你改了某行代碼、重啟 Tomcat、發(fā)現(xiàn)功能莫名失效的凌晨三點(diǎn)。以下是我在三個(gè)不同客戶現(xiàn)場(chǎng)復(fù)現(xiàn)并解決的典型問(wèn)題每一條都附帶可驗(yàn)證的現(xiàn)象、根本原因和一行命令級(jí)解決方案。4.1 現(xiàn)象JSP 頁(yè)面中s:property valuename/顯示空值但System.out.println(name)打印正常原因name字段未遵循 JavaBean 規(guī)范。Struts 2 的 OGNL 表達(dá)式引擎要求若字段名為name則必須存在getName()方法且方法簽名必須為public String getName()。如果誤寫為public String getname()小寫 nOGNL 就找不到 getter返回 null。解決檢查所有Action和Model類的 getter 方法命名用 IDE 的 “Generate Getter and Setter” 功能重新生成禁用手動(dòng)編寫。4.2 現(xiàn)象表單提交后addFieldError(name, 錯(cuò)誤信息)不顯示在頁(yè)面上原因INPUT結(jié)果未正確指向原始輸入頁(yè)或輸入頁(yè)未包含s:fielderror fieldNamename/標(biāo)簽。更隱蔽的情況是struts.convention.result.path配置的路徑與Result中l(wèi)ocation的相對(duì)路徑計(jì)算錯(cuò)誤導(dǎo)致 Struts 2 渲染了錯(cuò)誤的 JSP而該 JSP 里沒(méi)有fielderror標(biāo)簽。解決在struts.xml中臨時(shí)添加constant namestruts.devMode valuetrue/啟動(dòng)后訪問(wèn)http://localhost:8080/sales/struts/查看“Configuration”頁(yè)搜索INPUT結(jié)果對(duì)應(yīng)的物理路徑確認(rèn)其與webapp/WEB-INF/content/下文件一致。4.3 現(xiàn)象AJAX 請(qǐng)求返回 500Tomcat 日志報(bào)ognl.MethodFailedException堆棧指向getText()方法原因getText(key)在 Action 中被調(diào)用時(shí)key對(duì)應(yīng)的資源束global-messages.properties中該 key 不存在且struts.i18n.reload為true開發(fā)模式默認(rèn)開啟導(dǎo)致 Struts 2 嘗試動(dòng)態(tài)重載資源束失敗。解決在struts.properties中添加struts.i18n.reloadfalse并將所有g(shù)etText()調(diào)用包裹在 try-catch 中或改用getText(key, 默認(rèn)文本)提供 fallback。4.4 現(xiàn)象H2 數(shù)據(jù)庫(kù)中中文顯示為亂碼如“張三”存為“??”原因H2 連接 URL 缺少字符集參數(shù)。默認(rèn) JDBC URLjdbc:h2:~/salesdb不指定編碼H2 使用平臺(tái)默認(rèn)編碼Windows 通常是 GBK而 Struts 2 請(qǐng)求默認(rèn) UTF-8。解決修改hibernate.cfg.xml中的連接 URL 為jdbc:h2:~/salesdb;DB_CLOSE_DELAY-1;DB_CLOSE_ON_EXITFALSE;CHARSETUTF-84.5 現(xiàn)象部署到 Linux 服務(wù)器后s:file上傳控件始終返回null本地 Windows 正常原因Linux 文件系統(tǒng)區(qū)分大小寫而 Struts 2 的FileUploadInterceptor默認(rèn)使用的臨時(shí)目錄java.io.tmpdir在某些 Linux 發(fā)行版中指向/tmp但struts.multipart.saveDir配置為upload相對(duì)路徑導(dǎo)致 Struts 2 嘗試創(chuàng)建/tmp/upload目錄失敗權(quán)限不足或路徑不存在。解決在struts.properties中顯式指定絕對(duì)路徑struts.multipart.saveDir /var/tmp/sales-upload并確保該目錄存在且 Tomcat 用戶有讀寫權(quán)限sudo mkdir -p /var/tmp/sales-upload sudo chown tomcat:tomcat /var/tmp/sales-upload5. 進(jìn)階技巧用 Struts 2 攔截器鏈重構(gòu)導(dǎo)出功能把 3 秒響應(yīng)壓到 300 毫秒銷售系統(tǒng)最常被吐槽的點(diǎn)就是“導(dǎo)出 Excel 太慢”。原始實(shí)現(xiàn)是用戶點(diǎn)擊“導(dǎo)出”ExportAction.execute()方法內(nèi)直接調(diào)用ExcelUtil.exportToResponse()遍歷 10 萬(wàn)條訂單逐行寫入HttpServletResponse.getOutputStream()期間 Tomcat 線程被獨(dú)占用戶只能干等。這不是性能問(wèn)題是架構(gòu)問(wèn)題——它把耗時(shí) IO 操作塞進(jìn)了 Struts 2 的同步請(qǐng)求處理鏈。真正的解法是用攔截器鏈把“觸發(fā)導(dǎo)出”和“執(zhí)行導(dǎo)出”徹底解耦。5.1 導(dǎo)出任務(wù)抽象從 Action 方法到獨(dú)立 Service首先剝離導(dǎo)出邏輯。新建ExportService.javaService public class ExportService { // 使用 Spring 的 TaskExecutor 實(shí)現(xiàn)異步 Autowired private TaskExecutor taskExecutor; public void exportOrdersAsync(String condition, String userId) { taskExecutor.execute(() - { try { // 1. 查詢數(shù)據(jù)此處用 Hibernate 分頁(yè)避免內(nèi)存溢出 ListOrder orders orderDao.findForExport(condition, 0, 100000); // 2. 生成 Excel 文件用 Apache POI SXSSFWorkbook 流式寫入 File tempFile generateExcel(orders); // 3. 保存文件到共享存儲(chǔ)如 NFS 或 MinIO生成下載 URL String downloadUrl saveToStorage(tempFile, userId); // 4. 更新用戶通知表標(biāo)記任務(wù)完成 notifyService.sendComplete(userId, downloadUrl); } catch (Exception e) { notifyService.sendFail(userId, e.getMessage()); } }); } }5.2 攔截器接管ExportTriggerInterceptor 實(shí)現(xiàn)零侵入觸發(fā)新建攔截器ExportTriggerInterceptor.java它不處理業(yè)務(wù)只做一件事當(dāng)檢測(cè)到請(qǐng)求參數(shù)含exporttrue就調(diào)用ExportService并立即返回輕量 JSONpublic class ExportTriggerInterceptor extends AbstractInterceptor { Autowired private ExportService exportService; Override public String intercept(ActionInvocation invocation) throws Exception { MapString, Object params invocation.getInvocationContext().getParameters(); if (params.containsKey(export) true.equals(params.get(export).toString())) { // 提取導(dǎo)出條件從 request 參數(shù)或 session 中獲取 String condition extractCondition(invocation); String userId getCurrentUserId(invocation); // 異步觸發(fā)導(dǎo)出 exportService.exportOrdersAsync(condition, userId); // 立即返回成功響應(yīng)前端輪詢狀態(tài) HttpServletResponse response ServletActionContext.getResponse(); response.setContentType(application/json;charsetUTF-8); response.getWriter().write({\status\:\success\,\message\:\導(dǎo)出任務(wù)已提交請(qǐng)稍后查看通知\}); return NONE; // 不走后續(xù)攔截器和 Action直接結(jié)束請(qǐng)求 } return invocation.invoke(); // 正常流程 } }5.3 前端協(xié)同輪詢 通知中心用戶體驗(yàn)質(zhì)變前端不再等待導(dǎo)出完成而是點(diǎn)擊“導(dǎo)出”按鈕發(fā)送POST /order/list.action?exporttruecustomerNameABC收到{status:success}后隱藏按鈕顯示“導(dǎo)出任務(wù)已提交”啟動(dòng)輪詢GET /notify/status.action?userId123檢查通知表一旦返回{status:complete, url:/download/20240520-123456.xlsx}彈窗提示并提供下載鏈接。這個(gè)方案把用戶感知的“等待時(shí)間”從 3 秒降為 300 毫秒純網(wǎng)絡(luò)往返而真正的耗時(shí)操作在后臺(tái)靜默執(zhí)行。更重要的是它完全不修改任何原有 Action 代碼——OrderAction.list()方法依然只負(fù)責(zé)查數(shù)據(jù)、返回 JSONExportTriggerInterceptor作為獨(dú)立攔截器插入到defaultStack之前實(shí)現(xiàn)關(guān)注點(diǎn)分離。從那以后我每次接到“導(dǎo)出慢”的需求都不再碰Action類而是先畫一張攔截器鏈圖哪里該切、哪里該異步、哪里該降級(jí)。Struts 2 的攔截器不是裝飾器它是請(qǐng)求生命周期的手術(shù)刀。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取