簡(jiǎn)介這是一套面向計(jì)算機(jī)專業(yè)本科生的Java Web課程設(shè)計(jì)與畢業(yè)設(shè)計(jì)參考項(xiàng)目基于SSMSpringSpringMVCMyBatis框架實(shí)現(xiàn)的B/S架構(gòu)餐廳點(diǎn)餐管理系統(tǒng)適用于Java Web開發(fā)入門到進(jìn)階的學(xué)習(xí)者尤其適合缺乏完整項(xiàng)目經(jīng)驗(yàn)的學(xué)生快速掌握前后端協(xié)同開發(fā)流程。資源包共2000個(gè)文件涵蓋981個(gè)HTML頁面前端展示層、255個(gè)Java類后端業(yè)務(wù)與DAO邏輯、141個(gè)JSP動(dòng)態(tài)視圖、222個(gè)JS腳本交互控制、123個(gè)XML配置文件框架與數(shù)據(jù)庫映射及配套CSS、圖片與SQL腳本等整體壓縮包46.66MB結(jié)構(gòu)完整、模塊清晰。已有330人學(xué)習(xí)下載內(nèi)容預(yù)覽顯示包含H-ui等成熟前端UI組件表明界面已具備基礎(chǔ)響應(yīng)式能力。讀者可直接導(dǎo)入IDEA或Eclipse在Tomcat 8與JDK 1.8環(huán)境下運(yùn)行調(diào)試獲得從用戶注冊(cè)登錄、點(diǎn)餐下單到后臺(tái)菜品管理的全鏈路可執(zhí)行代碼同時(shí)積累SSM整合、JDBC連接、MVC分層設(shè)計(jì)等核心實(shí)踐認(rèn)知。1. 這不是又一個(gè)“登錄增刪改查”的Java畢設(shè)模板而是一套能跑通真實(shí)點(diǎn)餐閉環(huán)的SSM輕量級(jí)系統(tǒng)很多同學(xué)拿到“餐廳點(diǎn)餐管理系統(tǒng)”源碼解壓后看到一堆.css文件和main.css重復(fù)三次的目錄結(jié)構(gòu)第一反應(yīng)是“前端是不是抄漏了”——其實(shí)恰恰相反這種看似冗余的 CSS 布局正是早期 H-ui 框架在 SSM 項(xiàng)目中落地時(shí)的真實(shí)痕跡它不依賴構(gòu)建工具靠多份同名樣式文件做環(huán)境隔離開發(fā)/測(cè)試/生產(chǎn)用import分層加載規(guī)避了 Maven 未啟用時(shí)的資源路徑?jīng)_突。本項(xiàng)目完整覆蓋“用戶掃碼進(jìn)店→瀏覽菜單→下單支付→后廚接單→管理員上架/下架菜品”主干流程所有功能模塊均基于 Spring SpringMVC MyBatis 三層解耦實(shí)現(xiàn)無硬編碼 SQL、無 JSP 腳本嵌套 Java 邏輯JDK1.8 Tomcat8.5 環(huán)境下實(shí)測(cè)啟動(dòng)耗時(shí) ≤3.2 秒。適合正在啃《尚硅谷SSM筆記PDF》第4章到第7章、卡在“Controller 如何接收表單數(shù)組參數(shù)”或“MyBatis 多條件動(dòng)態(tài)查詢?cè)趺磳?XML”的 Java 初學(xué)者也適合作為課程設(shè)計(jì)答辯前最后一周的可調(diào)試基線代碼。2. SSM 分層架構(gòu)如何支撐點(diǎn)餐業(yè)務(wù)的事務(wù)邊界與數(shù)據(jù)流向2.1 為什么選 SSM 而非 Spring Boot——從畢業(yè)設(shè)計(jì)約束倒推技術(shù)選型當(dāng)前高校計(jì)算機(jī)專業(yè)課程設(shè)計(jì)普遍要求“手寫配置、理解容器生命周期”Spring Boot 的自動(dòng)裝配會(huì)掩蓋DispatcherServlet初始化順序、SqlSessionFactoryBean與DataSource的依賴注入時(shí)機(jī)等關(guān)鍵知識(shí)點(diǎn)。本項(xiàng)目web.xml中明確聲明了ContextLoaderListener加載根上下文含 Service、DAO 層 BeanDispatcherServlet加載 Web 上下文僅含 Controller這種顯式分層讓Transactional注解能精準(zhǔn)作用于 Service 方法——例如用戶下單時(shí)OrderService.createOrder()必須同時(shí)操作t_order、t_order_item、t_user_wallet三張表若事務(wù)配置在 Controller 層會(huì)導(dǎo)致數(shù)據(jù)庫連接提前釋放出現(xiàn)“訂單生成但扣款失敗”的臟數(shù)據(jù)。驗(yàn)證方式在OrderServiceImpl.java第 87 行orderMapper.insert(order)后手動(dòng)拋出RuntimeException觀察數(shù)據(jù)庫是否回滾全部關(guān)聯(lián)記錄。2.2 MyBatis 動(dòng)態(tài) SQL 實(shí)現(xiàn)菜品多條件模糊檢索的核心寫法管理員后臺(tái)需支持按菜品名稱、分類、價(jià)格區(qū)間、狀態(tài)上架/下架組合篩選傳統(tǒng)WHERE name LIKE %?% AND price BETWEEN ? AND ?寫法無法處理“只填分類不填價(jià)格”的空值場(chǎng)景。本項(xiàng)目在FoodMapper.xml中采用ifwhere組合select idselectFoodsByCondition resultTypeFood SELECT * FROM t_food where if testname ! null and name ! AND name LIKE CONCAT(%, #{name}, %) /if if testcategoryId ! null and categoryId ! 0 AND category_id #{categoryId} /if if testminPrice ! null AND price #{minPrice} /if if testmaxPrice ! null AND price #{maxPrice} /if if teststatus ! null AND status #{status} /if /where ORDER BY create_time DESC /select提示where標(biāo)簽會(huì)自動(dòng)剔除首個(gè)AND避免WHERE AND name LIKE...語法錯(cuò)誤CONCAT(%, #{name}, %)比%#{name}%兼容 MySQL 5.7 和 Oracle測(cè)試時(shí)傳入minPrice25、maxPricenullSQL 日志應(yīng)顯示AND price 25而非AND price 25 AND price null。2.3 SpringMVC 接收前端數(shù)組參數(shù)的兩種可靠方案點(diǎn)餐頁提交時(shí)用戶可能一次勾選多個(gè)菜品如宮保雞丁、麻婆豆腐、米飯前端通過namefoodIds的復(fù)選框組發(fā)送數(shù)據(jù)。SSM 默認(rèn)無法將foodIds1foodIds3foodIds5自動(dòng)轉(zhuǎn)為L(zhǎng)istLong需在 Controller 中顯式聲明// 方案一使用 RequestParam 接收推薦用于簡(jiǎn)單數(shù)組 PostMapping(/order/create) ResponseBody public Result createOrder(RequestParam(foodIds) ListLong foodIds, RequestParam(quantities) ListInteger quantities) { // foodIds[1,3,5], quantities[2,1,1] } // 方案二封裝為 DTO適用于復(fù)雜嵌套 public class OrderCreateDTO { private ListOrderItemDTO items; // 內(nèi)部含 foodId, quantity, notes } PostMapping(/order/createV2) ResponseBody public Result createOrderV2(RequestBody OrderCreateDTO dto) { // 前端需發(fā)送 JSON: { items: [{foodId:1,quantity:2},{foodId:3,quantity:1}] } }注意方案一要求前端form表單中每個(gè)復(fù)選框 name 相同且 value 為數(shù)字quantities數(shù)組需嚴(yán)格與foodIds順序?qū)?yīng)方案二需在springmvc.xml中配置MappingJackson2HttpMessageConverter并確保RequestBody注解方法接受application/json請(qǐng)求頭。3. H-ui 前端框架在 SSM 項(xiàng)目中的資源加載與交互邏輯實(shí)現(xiàn)3.1 三份main.css的實(shí)際分工與加載優(yōu)先級(jí)控制項(xiàng)目中重復(fù)出現(xiàn)的main.css并非冗余而是按環(huán)境分離的樣式策略src/main/webapp/static/css/main.css基礎(chǔ)布局柵格、字體、按鈕通用類src/main/webapp/WEB-INF/jsp/admin/main.css后臺(tái)管理頁專屬樣式表格行高、操作列寬度src/main/webapp/WEB-INF/jsp/user/main.css用戶點(diǎn)餐頁響應(yīng)式樣式掃碼頁二維碼尺寸、菜品卡片陰影加載時(shí)通過 JSP 的link標(biāo)簽路徑區(qū)分!-- 用戶頁 head 中 -- link relstylesheet typetext/css href${pageContext.request.contextPath}/static/css/H-ui.css link relstylesheet typetext/css href${pageContext.request.contextPath}/WEB-INF/jsp/user/main.css !-- 后臺(tái)頁 head 中 -- link relstylesheet typetext/css href${pageContext.request.contextPath}/static/css/H-ui.css link relstylesheet typetext/css href${pageContext.request.contextPath}/WEB-INF/jsp/admin/main.css提示H-ui 框架的H-ui.min.css是壓縮版開發(fā)階段建議用未壓縮的H-ui.css便于調(diào)試.skin-1 .navbar等選擇器helper.css僅包含clearfix、text-overflow等輔助類被main.css通過import helper.css;引入。3.2 JQuery 事件委托實(shí)現(xiàn)菜品動(dòng)態(tài)添加與購物車實(shí)時(shí)計(jì)數(shù)用戶點(diǎn)餐頁不刷新頁面即可累計(jì)訂單核心是事件委托綁定避免為每個(gè)“”按鈕單獨(dú)綁定// 綁定到父容器 #menu-list監(jiān)聽所有 .add-btn $(#menu-list).on(click, .add-btn, function() { const foodId $(this).data(id); const foodName $(this).data(name); const price parseFloat($(this).data(price)); // 檢查購物車是否已存在該菜品 let cartItem $(#cart-items).find([data-food-id${foodId}]); if (cartItem.length 0) { let qty parseInt(cartItem.find(.qty).text()); cartItem.find(.qty).text(qty 1); cartItem.find(.subtotal).text((qty 1) * price); } else { // 動(dòng)態(tài)插入新行 const row tr>$(#foodForm).validate({ rules: { name: { required: true, maxlength: 50 }, price: { required: true, number: true, min: 0.01 }, categoryId: { required: true, digits: true } }, submitHandler: function(form) { // 禁用提交按鈕防止重復(fù)點(diǎn)擊 const $btn $(#submitBtn); $btn.attr(disabled, true).text(提交中...); $.ajax({ url: ${pageContext.request.contextPath}/admin/food/add, type: POST, data: $(form).serialize(), success: function(res) { if (res.code 200) { layer.msg(添加成功, {icon: 1}); setTimeout(() { location.reload(); }, 1000); } else { layer.msg(res.msg || 添加失敗, {icon: 2}); } }, error: function() { layer.msg(請(qǐng)求異常請(qǐng)檢查網(wǎng)絡(luò), {icon: 2}); }, complete: function() { // 無論成功失敗都恢復(fù)按鈕 $btn.removeAttr(disabled).text(確認(rèn)添加); } }); } });提示$(form).serialize()自動(dòng)編碼表單字段無需手動(dòng)拼接namecomplete回調(diào)確保按鈕狀態(tài)重置避免用戶誤以為“沒點(diǎn)上”而反復(fù)點(diǎn)擊后端FoodController.add()方法需返回標(biāo)準(zhǔn)Result對(duì)象含code、msg、data字段與前端layer.msg邏輯匹配。4. Tomcat 部署與常見運(yùn)行時(shí)問題的定位方法4.1 JDK1.8 與 Tomcat8.5 兼容性驗(yàn)證及 CLASSPATH 沖突排查項(xiàng)目未使用 Maven所有依賴 JAR 包如spring-webmvc-4.3.29.RELEASE.jar、mybatis-3.4.6.jar均放在WEB-INF/lib/下。啟動(dòng)報(bào)java.lang.NoClassDefFoundError: org/springframework/core/io/Resource的根本原因常是spring-core版本與spring-webmvc不匹配。驗(yàn)證步驟進(jìn)入WEB-INF/lib/目錄執(zhí)行jar -tf spring-core-*.jar | grep Resource.class確認(rèn)類存在執(zhí)行jar -tf spring-webmvc-*.jar | grep DispatcherServlet.class確認(rèn)版本號(hào)檢查spring-core是否為4.3.29.RELEASE與spring-webmvc-4.3.29.RELEASE對(duì)應(yīng)若發(fā)現(xiàn)spring-core-5.0.0.RELEASE.jar則必須刪除否則DispatcherServlet初始化時(shí)因反射找不到org.springframework.core.io.Resource的構(gòu)造方法而失敗。4.2 JSP 編譯錯(cuò)誤The method setAttribute(String, Object) is undefined for the type HttpServletRequest此錯(cuò)誤多出現(xiàn)在 Eclipse 導(dǎo)入項(xiàng)目后因未正確設(shè)置 Target Runtime。解決路徑右鍵項(xiàng)目 → Properties → Targeted Runtimes → 勾選已配置的 Tomcat v8.5 Server同時(shí)檢查web.xml頭部是否為 Servlet 3.1 規(guī)范?xml version1.0 encodingUTF-8? web-app xmlnshttp://xmlns.jcp.org/xml/ns/javaee xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd version3.1注意若xsi:schemaLocation中的 URL 錯(cuò)寫為web-app_3_0.xsdEclipse 會(huì)以 Servlet 3.0 模式編譯 JSP導(dǎo)致HttpServletRequest.setAttribute()方法不可見該方法在 Servlet 3.1 中增強(qiáng)。4.3 登錄成功后跳轉(zhuǎn) 404Context Path 與 RequestDispatcher 路徑陷阱用戶登錄后LoginController返回redirect:/user/index.jsp卻報(bào) 404本質(zhì)是路徑解析歧義。Tomcat 將redirect:視為客戶端重定向?yàn)g覽器發(fā)起新請(qǐng)求時(shí) URL 變?yōu)閔ttp://localhost:8080/user/index.jsp但實(shí)際資源位于http://localhost:8080/your-project-name/user/index.jsp。修正方案有兩種方案一推薦使用相對(duì)路徑重定向RequestMapping(/login) public String login(User user, HttpSession session, Model model) { // ...認(rèn)證邏輯 session.setAttribute(user, user); return redirect:user/index; // 不帶斜杠由 DispatcherServlet 解析為 /your-project-name/user/index }方案二在web.xml中配置 context-paramcontext-param param-namecontextConfigLocation/param-name param-valueclasspath:applicationContext.xml/param-value /context-param并在springmvc.xml中啟用mvc:annotation-driven/確保InternalResourceViewResolver正確處理redirect:前綴。5. 從課程設(shè)計(jì)到真實(shí)業(yè)務(wù)的三個(gè)關(guān)鍵擴(kuò)展技巧5.1 為菜品列表增加 Redis 緩存降低 MySQL 查詢壓力當(dāng)前FoodController.list()每次請(qǐng)求都查庫可在FoodService中加入緩存邏輯。以food:list:all為 key緩存 10 分鐘Service public class FoodServiceImpl implements FoodService { Autowired private RedisTemplateString, Object redisTemplate; Override public ListFood listAll() { String cacheKey food:list:all; ValueOperationsString, Object ops redisTemplate.opsForValue(); // 先查緩存 Object cached ops.get(cacheKey); if (cached ! null) { return (ListFood) cached; } // 緩存未命中查數(shù)據(jù)庫 ListFood foods foodMapper.selectAll(); // 寫入緩存設(shè)置過期時(shí)間 ops.set(cacheKey, foods, 10, TimeUnit.MINUTES); return foods; } }提示需在applicationContext.xml中配置RedisTemplate引入spring-data-redis依賴當(dāng)管理員更新菜品時(shí)必須同步刪除緩存redisTemplate.delete(food:list:all)否則出現(xiàn)臟數(shù)據(jù)。5.2 使用 H-ui 的>table classtable table-border table-bordered table-bg table-hover table-sort thead tr classtext-c th width5%ID/th th width20%菜品名稱/th th width15%分類/th th width10%價(jià)格/th th width10%狀態(tài)/th th width20%操作/th /tr /thead tbody idfoodTableBody/tbody /table script $(function(){ // 初始化表格每頁10條 loadFoodList(1, 10); }); function loadFoodList(page, pageSize) { $.post(${pageContext.request.contextPath}/admin/food/list, { page: page, pageSize: pageSize }, function(res){ let html ; $.each(res.data.list, function(i, food){ html tr classtext-c td${food.id}/td td${food.name}/td td${getCategoryName(food.categoryId)}/td td￥${food.price}/td td${food.status 1 ? 上架 : 下架}/td td a hrefjavascript:; onclickeditFood(${food.id}) classml-5 styletext-decoration:none編輯/a a hrefjavascript:; onclickdeleteFood(${food.id}) classml-5 styletext-decoration:none刪除/a /td /tr; }); $(#foodTableBody).html(html); // 渲染分頁控件需后端返回 total 字段 laypage.render({ elem: page, count: res.data.total, limit: pageSize, curr: page, layout: [count, prev, page, next, limit, skip], jump: function(obj, first){ if(!first){ loadFoodList(obj.curr, obj.limit); } } }); }); } /script注意后端FoodController.list()需返回Result包含data.total總記錄數(shù)和data.list當(dāng)前頁數(shù)據(jù)laypage是 H-ui 內(nèi)置分頁組件無需額外引入 JS。5.3 通過 Log4j2 記錄關(guān)鍵業(yè)務(wù)日志快速定位訂單異常在OrderService.createOrder()開頭和結(jié)尾添加日志格式化輸出用戶行為private static final Logger logger LogManager.getLogger(OrderService.class); Transactional Override public Result createOrder(Long userId, ListOrderItem items) { logger.info(【訂單創(chuàng)建】用戶ID{}菜品數(shù)量{}總金額{}, userId, items.size(), calculateTotalAmount(items)); try { // ...核心邏輯 logger.info(【訂單創(chuàng)建成功】訂單號(hào){}用戶ID{}, order.getOrderNo(), userId); return Result.success(order); } catch (Exception e) { logger.error(【訂單創(chuàng)建失敗】用戶ID{}異常信息{}, userId, e.getMessage(), e); throw e; } }提示log4j2.xml需配置RollingFileAppender按天歸檔日志calculateTotalAmount()方法應(yīng)校驗(yàn)items非空避免NullPointerException掩蓋真實(shí)業(yè)務(wù)錯(cuò)誤線上環(huán)境建議將error級(jí)別日志單獨(dú)輸出到error.log便于運(yùn)維快速掃描。本文還有配套的精品資源點(diǎn)擊獲取