簡介面向百貨零售業(yè)的供應(yīng)鏈管理系統(tǒng)項目基于 Java SSM 整合 Vue/JSP 技術(shù)棧構(gòu)建覆蓋采購、庫存、銷售等核心業(yè)務(wù)環(huán)節(jié)適合用作畢業(yè)設(shè)計或 Java Web 綜合實戰(zhàn)參考。壓縮包共 924 個文件大小約 9.97MB主要包含 136 個 Java 后端源碼、72 個 JSP 頁面、224 個 JS 腳本與 102 個 CSS 樣式文件另有 2 個 SQL 數(shù)據(jù)庫腳本、項目功能說明文檔及 Eclipse 工程配置目錄結(jié)構(gòu)清晰便于導(dǎo)入與二次開發(fā)。系統(tǒng)技術(shù)棧涉及 Spring、SpringMVC、MyBatis、Vue 組件化開發(fā)可幫助學(xué)習(xí)者深入理解前后端交互、SSM 整合流程及供應(yīng)鏈模塊設(shè)計。資源經(jīng)過嚴格調(diào)試可直接部署運行并附數(shù)據(jù)庫腳本和功能文檔能快速搭建演示環(huán)境。已有 3522 人學(xué)習(xí)適合需要完整項目源碼的學(xué)生與開發(fā)者參考。1. 拿到壓縮包之后先看懂這套百貨供應(yīng)鏈的SSM骨架解壓ssm685百貨中心供應(yīng)鏈管理系統(tǒng)jsp-lw.zip之后大概率會看到一個標準的Maven工程src/main/java下面分層放著controller、service、mappersrc/main/webapp/WEB-INF/jsp里躺著所有頁面根目錄還有一份帶lw字樣的說明文檔。這套組合就是典型的SSM框架項目——Spring管對象、Spring MVC管請求分發(fā)、MyBatis管數(shù)據(jù)庫讀寫視圖層用JSP渲染是近十年Java畢業(yè)設(shè)計和中小型企業(yè)內(nèi)部系統(tǒng)最常見的結(jié)構(gòu)。百貨中心的供應(yīng)鏈管理業(yè)務(wù)上繞不開采購、入庫、庫存、銷售、供應(yīng)商這幾張核心表系統(tǒng)要做的事就是把它們串成閉環(huán)。這篇博文不評價項目的代碼質(zhì)量只講清楚一件事拿到這類SSMJSP項目后怎么快速建立數(shù)據(jù)模型和請求鏈路的認知然后改造成自己能跑、能講、能擴展的狀態(tài)。2. 數(shù)據(jù)先于代碼供應(yīng)鏈表結(jié)構(gòu)與MyBatis映射的設(shè)計邏輯2.1 百貨供應(yīng)鏈最少需要幾張表百貨中心做供應(yīng)鏈管理核心是把商品從供應(yīng)商送到消費者手里中間經(jīng)過倉庫。最少得有四類數(shù)據(jù)供應(yīng)商、商品、入庫/采購、出庫/銷售。常見做法是再加一張庫存表或者直接在商品表冗余庫存字段小系統(tǒng)為了減少join查詢通常會直接在goods表里放stock字段。CREATE TABLE supplier ( sid int(11) NOT NULL AUTO_INCREMENT, sname varchar(50) NOT NULL, contact varchar(20) DEFAULT NULL, phone varchar(20) DEFAULT NULL, address varchar(100) DEFAULT NULL, PRIMARY KEY (sid) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE goods ( gid int(11) NOT NULL AUTO_INCREMENT, gname varchar(50) NOT NULL, price decimal(10,2) NOT NULL, stock int(11) NOT NULL DEFAULT 0, sid int(11) DEFAULT NULL, category varchar(30) DEFAULT NULL, PRIMARY KEY (gid), KEY fk_supplier (sid), CONSTRAINT fk_supplier FOREIGN KEY (sid) REFERENCES supplier (sid) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;這兩張表是基礎(chǔ)采購單和銷售單需要單獨建表。采購單記錄每次從供應(yīng)商進貨的商品、數(shù)量和入庫時間銷售單記錄客戶買走的商品、數(shù)量和出庫時間。訂單表里的外鍵指向goods.gid不要直接存商品名稱字符串否則供應(yīng)商改價或者商品改名后歷史數(shù)據(jù)會出現(xiàn)不一致。CREATE TABLE purchase_order ( poid int(11) NOT NULL AUTO_INCREMENT, gid int(11) NOT NULL, quantity int(11) NOT NULL, unit_price decimal(10,2) NOT NULL, create_time datetime DEFAULT CURRENT_TIMESTAMP, status tinyint(1) DEFAULT 1, PRIMARY KEY (poid), KEY fk_goods (gid), CONSTRAINT fk_goods FOREIGN KEY (gid) REFERENCES goods (gid) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;MySQL 8.0以下版本推薦utf8mb4原因不復(fù)雜百貨商品的描述信息里可能帶上emoji或者生僻字utf8mb3也就是常說的utf8存不了四個字節(jié)的字符。設(shè)計表時要注意供應(yīng)商和商品是一對多關(guān)系這個關(guān)系在后續(xù)的JSP下拉框聯(lián)動中會用到。2.2 MyBatis Mapper如何對應(yīng)到JSON和頁面字段SSM項目里的MyBatis層通常一個GoodsMapper.xml對應(yīng)一張表的CRUD。核心是寫一個分頁查詢和庫存變更的SQL這兩段是供應(yīng)鏈系統(tǒng)的重頭戲。分頁查詢在MyBatis里用手寫LIMIT最直接PageHelper插件雖然方便但老項目里未必引了依賴。select idselectGoodsPage resultTypecom.demo.entity.Goods SELECT g.gid, g.gname, g.price, g.stock, g.category, s.sname AS supplierName FROM goods g LEFT JOIN supplier s ON g.sid s.sid where if testgname ! null and gname ! AND g.gname LIKE CONCAT(%, #{gname}, %) /if if testcategory ! null and category ! AND g.category #{category} /if /where ORDER BY g.gid DESC LIMIT #{offset}, #{pageSize} /select#{offset}和#{pageSize}分別代表跳過的行數(shù)和每頁條數(shù)前端傳頁碼過來時Controller里做一個簡單換算offset (currentPage - 1) * pageSize。這里容易踩的坑是LIMIT后面不能直接用#{}拼寫列名或關(guān)鍵字MyBatis的預(yù)編譯只處理參數(shù)值不處理表名和列名。resultType直接映射到Java實體類實體類里如果加了supplierName這個屬性注意left join出來的別名必須和屬性名嚴格一致否則數(shù)據(jù)返回null。Mapper接口和XML的綁定是另一個高頻故障點對應(yīng)關(guān)系的代碼長這樣public interface GoodsMapper { ListGoods selectGoodsPage(Param(gname) String gname, Param(category) String category, Param(offset) int offset, Param(pageSize) int pageSize); }XML里select的id必須與接口方法名完全一樣namespace指向接口的全限定名這兩個地方對不上啟動Tomcat時MyBatis綁定異常就會直接報錯。用Param注解傳多個參數(shù)是通用做法比用Map更安全因為XML里寫#{gname}時編譯器能校驗到類型。2.3 庫存扣減為什么不能先查再改供應(yīng)鏈系統(tǒng)的庫存邏輯是并發(fā)事故重災(zāi)區(qū)。商品表里如果只有stock字段記庫存的減法時不能用SELECT stock查出當前值然后在Java里算出新值再UPDATE這種思路在單人操作時沒問題兩個管理員同時賣同一件商品時就會超賣。正確做法是把扣減寫進一條SQL的條件里UPDATE goods SET stock stock - #{quantity} WHERE gid #{gid} AND stock #{quantity}這條SQL的返回值是受影響的行數(shù)等于1說明扣減成功等于0說明庫存不足或商品不存在。Service層判斷這個返回值失敗就拋業(yè)務(wù)異常JSP頁面捕獲后提示用戶。這個寫法在很多老項目里沒有改造時建議優(yōu)先補上。想要更強的保障就用SELECT ... FOR UPDATE鎖行但小系統(tǒng)里stock #{quantity}條件配合行鎖已經(jīng)夠用。3. JSP視圖層與Controller的參數(shù)流轉(zhuǎn)從表單到數(shù)據(jù)庫的完整鏈路3.1 請求從哪里來JSP表單的name與Controller的參數(shù)綁定百貨供應(yīng)鏈系統(tǒng)里最常見的操作是做一張采購單。JSP頁面用表單提交數(shù)據(jù)每個input標簽的name屬性值就是Controller方法參數(shù)的綁定依據(jù)這個對應(yīng)關(guān)系是SSM里最基礎(chǔ)也最容易忽略的規(guī)則。form action${pageContext.request.contextPath}/purchase/add methodpost input typehidden namegid value${goods.gid} / select namesupplierId c:forEach items${supplierList} varsup option value${sup.sid}${sup.sname}/option /c:forEach /select input typenumber namequantity min1 required / input typetext nameremark maxlength100 / button typesubmit提交采購單/button /form對應(yīng)的Controller接收參數(shù)常見寫法是用JavaBean直接接收也可以用RequestParam逐個接收。JavaBean方式更貼合這套項目的習(xí)慣因為頁面字段與實體屬性一一對應(yīng)時Spring MVC會自動完成類型轉(zhuǎn)換和注入。Controller RequestMapping(/purchase) public class PurchaseController { Autowired private PurchaseService purchaseService; PostMapping(/add) public String addPurchase(PurchaseOrder order, RedirectAttributes attr) { boolean success purchaseService.createPurchaseOrder(order); if (success) { attr.addFlashAttribute(msg, 采購單創(chuàng)建成功); } else { attr.addFlashAttribute(msg, 庫存扣減失敗請檢查庫存量); } return redirect:/purchase/list; } }方法簽名里PurchaseOrder order這個參數(shù)對象屬性名必須是gid、quantity、remark對應(yīng)JSP里的name。RedirectAttributes用來跨重定向傳遞提示消息防止刷新頁面時表單重復(fù)提交。這里的redirect:前綴非常重要——如果直接返回purchase/list地址欄還是/purchase/addF5一刷新就會重復(fù)插入一條采購單。3.2 JSP渲染數(shù)據(jù)時的El表達式與JSTL標簽范圍頁面端循環(huán)數(shù)據(jù)一般用c:forEach配合EL表達式取值。$符號的規(guī)則是取作用域里的屬性Controller返回的ModelAndView里放了什么頁面就能取到什么。table border1 cellpadding8 tr th商品名稱/thth采購數(shù)量/thth單價/thth創(chuàng)建時間/thth操作/th /tr c:forEach items${purchaseList} varpo c:if test${po.status 1} tr td${po.goodsName}/td td${po.quantity}/td td${po.unitPrice}/td tdfmt:formatDate value${po.createTime} patternyyyy-MM-dd HH:mm:ss//td tda href${pageContext.request.contextPath}/purchase/detail/${po.poid}詳情/a/td /tr /c:if /c:forEach /table注意c:if的test條件里po.status 1這個寫法EL表達式里數(shù)字會被當作Long類型處理JSP頁面不會自動把整形轉(zhuǎn)成Integer所以實體類里status字段要定義成Integer避免空指針或類型不匹配。fmt:formatDate用來格式化時間頁面顯示的createTime類型是java.util.Date時才能生效如果寫的是LocalDateTime需要額外處理或者改成String類型再顯示。JSP的搜索意圖里有個高頻問題修改完頁面后瀏覽器還在顯示舊內(nèi)容。這套老項目通常用Tomcat部署IDE里改JSP文件后有時需要重啟或清理work目錄——JSP會被Tomcat編譯成Java文件再編譯成Class存放在CATALINA_HOME/work/Catalina/localhost/應(yīng)用名/org/apache/jsp目錄下改完頁面不刷新時去這個目錄刪掉對應(yīng)的編譯產(chǎn)物即可這算是一個JSP改后不生效的排查手段。3.3 Controller返回JSON給頁面做異步刷新供應(yīng)鏈管理系統(tǒng)的供應(yīng)商下拉框在商品頁和采購頁都會用到。傳統(tǒng)做法是頁面加載時用EL直接渲染supplierList數(shù)據(jù)量幾百條沒問題但如果有二級聯(lián)動選供應(yīng)商后再加載該供應(yīng)商的商品就需要Controller返回JSONJSP用AJAX異步獲取。Spring MVC對JSON的原生支持來自ResponseBody注解GetMapping(/supplier/goods) ResponseBody public ListGoods getGoodsBySupplier(RequestParam(sid) Integer sid) { return goodsService.getGoodsBySupplierId(sid); }只要pom.xml里引入了jackson-databind依賴返回值就會被自動序列化成JSON數(shù)組。頁面端配合jQuery發(fā)起請求數(shù)據(jù)渲染到select里即可。有不少SSM項目用fastjson代替jackson但期間鬧出過反序列化漏洞現(xiàn)階段的建議是用jackson或者gson。JSON處理在JSP頁面里還有一個高頻搜索點是jsp jsonarray import這個通常指在JSP里導(dǎo)入Java的JSON工具類老項目里會直接% page importnet.sf.json.JSONArray %但這寫法不推薦——邏輯應(yīng)該寫到Controller或者Service里JSP只做顯示。4. 部署運行時必踩的坑Tomcat版本、JDK編譯與數(shù)據(jù)一致性4.1 從zip到能訪問war包能跑起來的三要素解壓ssm685百貨中心供應(yīng)鏈管理系統(tǒng)jsp-lw.zip之后先把目錄結(jié)構(gòu)弄成Maven標準布局確認pom.xml里JDK版本然后二選一用IDEA打開直接跑或者用命令行Maven打包成war放進Tomcat。比較穩(wěn)妥的方式是在IDEA里配置Tomcat運行這套SSM項目能跑起來的組合通常鎖定JDK 8 Tomcat 8.5/9 MySQL 5.7原因在于老項目里的依賴版本大多基于JDK 8編譯比如CGLIB代理和JSP編譯器在新JDK上偶發(fā)不兼容。pom.xml里關(guān)鍵的坐標配置長這樣properties maven.compiler.source1.8/maven.compiler.source maven.compiler.target1.8/maven.compiler.target project.build.sourceEncodingUTF-8/project.build.sourceEncoding /properties dependencies dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version5.1.20.RELEASE/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version5.1.20.RELEASE/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version3.5.5/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version2.0.5/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version5.1.49/version /dependency /dependenciesSpring 5.x版本要求JDK 8以上Tomcat 9對應(yīng)Servlet 4.0規(guī)范而Spring MVC的DispatcherServlet在這個容器里不需要額外引javax.servlet-api的依賴容器自帶。MySQL驅(qū)動選5.1.49配合MySQL 5.7最穩(wěn)如果用的是MySQL 8.0驅(qū)動需要升到com.mysql.cj.jdbc.Driver并把URL改造成jdbc:mysql://localhost:3306/ssm_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai——少了serverTimezone參數(shù)會直接拋時區(qū)錯誤這是老項目遷移MySQL 8.0時最容易卡住的位置。4.2 啟動報錯看哪幾行驅(qū)動類、端口、JDBC驅(qū)動版本運行過程中有四個高頻報錯按頻率排每個對應(yīng)的原因和處理手段都不同。第一個是ClassNotFoundException: com.mysql.jdbc.Driver字面意思是沒有這個驅(qū)動類實際是mysql-connector-java依賴沒打進war包或者版本太高導(dǎo)致類路徑變化解決辦法是檢查WEB-INF/lib下是否有jar包。第二個是Port 8080 already in use這是端口占用。Windows下用netstat -ano | findstr 8080查出PID然后taskkill /PID 進程號 /F結(jié)束進程。Linux下用lsof -i:8080定位kill -9處理。換端口就改Tomcat的server.xml里的Connector port8080注意同時核對項目代碼里有沒有寫死端口號比如數(shù)據(jù)庫連接URL里誤寫端口。第三個是Public Key Retrieval is not allowed這是MySQL 8.0的驅(qū)動與數(shù)據(jù)庫握手時要求獲取RSA公鑰但連接URL沒開啟對應(yīng)開關(guān)。解決辦法是URL末尾加allowPublicKeyRetrievaltrue。第四個是JSP編譯錯誤頁面報Unable to compile class for JSP這種一般是JDK版本太高Tomcat 9以下的容器無法用JDK 11編譯JSP或者是JSP文件里用了JDK 8之后移除的類比如StringUtils的舊包路徑。所以最省力的組合就是JDK 8能避開八成的兼容問題。4.3 數(shù)據(jù)一致性一個采購事務(wù)里的兩張表供應(yīng)鏈系統(tǒng)里一次采購操作要同時影響purchase_order和goods兩張表這就涉及事務(wù)。老項目里常見的是寫只更新訂單不扣庫存或者扣了庫存但訂單失敗了庫存改不回來。SSM的事務(wù)控制要在Service方法上加Transactional注解Service public class PurchaseServiceImpl implements PurchaseService { Autowired private PurchaseOrderMapper purchaseOrderMapper; Autowired private GoodsMapper goodsMapper; Override Transactional(rollbackFor Exception.class) public boolean createPurchaseOrder(PurchaseOrder order) { int updated goodsMapper.reduceStock(order.getGid(), order.getQuantity()); if (updated 0) { throw new BusinessException(庫存不足); } return purchaseOrderMapper.insert(order) 0; } }Transactional(rollbackFor Exception.class)的語義是運行時異常和檢查異常都能觸發(fā)回滾。小坑在于Spring聲明式事務(wù)默認只對RuntimeException回滾加異常時如果不把rollbackFor配上業(yè)務(wù)拋出的Exception子類根本不會回滾數(shù)據(jù)庫里就出現(xiàn)訂單有了、庫存沒減的一致性問題。另一個驗證方法是看控制臺有沒有Creating new transaction日志沒有說明事務(wù)管理器沒生效檢查Spring配置文件里tx:annotation-driven transaction-managertransactionManager/是否配置。事務(wù)在并發(fā)量不高的管理系統(tǒng)里性能損耗可控不要為了省事去掉事務(wù)。Transactional加在private方法上是無效的這點是很多JSP老項目改造時的隱含bug——注解只有加在public方法上且通過代理調(diào)用才會被攔截同類內(nèi)部調(diào)用不會走代理。5. 壓軸的優(yōu)化手法庫存扣減與頁面緩存的工程化寫法5.1 用樂觀鎖改造扣庫存的最優(yōu)解在2.3節(jié)的stock #{quantity}寫法基礎(chǔ)上再疊加一個樂觀鎖版本號字段。供應(yīng)鏈系統(tǒng)的庫存扣減在高并發(fā)下需要更嚴謹?shù)姆谰€version字段每次更新加1更新條件里帶AND version #{version}影響行數(shù)為0則重試標準的CAS操作。ALTER TABLE goods ADD COLUMN version INT NOT NULL DEFAULT 0; UPDATE goods SET stock stock - #{quantity}, version version 1 WHERE gid #{gid} AND stock #{quantity} AND version #{version}Service層拿到更新行數(shù)為0就拋異常讓用戶重新提交。版本號不必暴露給前端從商品詳情查出來放在表單的隱藏字段里即可。這么做能防止ABA問題——庫存被兩個請求讀出相同的值又寫回導(dǎo)致丟失一次扣減。反映到JSP頁面商品詳情按鈕跳轉(zhuǎn)時帶上version參數(shù)采購表單把這個字段作為隱藏輸入項提交這條鏈路就完整了。5.2 JSP頁面響應(yīng)速度的三個手段百貨系統(tǒng)的商品列表頁往往會隨著數(shù)據(jù)量增大變得越來越卡第一個手段是JSP片段緩存商品分類導(dǎo)航、供應(yīng)商信息這類不常變的內(nèi)容用c:import或JSTL的c:cache做片段緩存注意c:cache需要引入jstl的cache標簽庫很多老項目沒有用Apache Commons JSP Tags替代來給頁面加時間緩存。第二個手段是SQL層面及時分頁前端LIMIT只查當前頁數(shù)據(jù)禁止查出全部List再在內(nèi)存里截取。第三個手段是把商品圖片、靜態(tài)CSS和JS從JSP目錄移到獨立的靜態(tài)資源路徑用Nginx這類Web服務(wù)器做靜態(tài)文件響應(yīng)Tomcat只處理動態(tài)請求壓力會下降明顯。5.3 改完之后的驗證清單部署優(yōu)化完成后至少要驗證三條主鏈路。先驗證一條商品瀏覽路徑點開首頁搜索商品進詳情看庫存量是否與數(shù)據(jù)庫一致。再驗證一條采購鏈路提交采購單庫存減少采購列表出現(xiàn)新記錄供應(yīng)商名稱正確顯示。最后驗證并發(fā)扣減用JMeter或Postman并發(fā)發(fā)5個相同的采購請求庫存只會扣減成功一次訂單表里只有一條記錄其余請求提示庫存不足。驗證時把日志級別調(diào)整到DEBUG重點觀察MyBatis輸出的SQL中UPDATE goods SET stock stock - ?的affected rows返回值結(jié)合事務(wù)日志看是否有提交回滾記錄。一套SSMJSP的供應(yīng)鏈系統(tǒng)掌握了請求從JSP到Controller再到Mapper再回到頁面的完整回路理解了庫存扣減的數(shù)據(jù)一致性問題剩下的就是在這個骨架上繼續(xù)加報表、加登錄權(quán)限、加供應(yīng)商結(jié)算模塊。每個版本迭代都從最小可運行狀態(tài)開始改改一步驗證一步比推翻重來更能積累可復(fù)用的技術(shù)資產(chǎn)。本文還有配套的精品資源點擊獲取