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