smbms 這套項(xiàng)目全稱 Super Market Billing Management System也就是超市訂單管理系統(tǒng)網(wǎng)上傳得很廣的那套 JavaWeb 視頻系列的配套項(xiàng)目就是它。很多人學(xué)完 Servlet、JSP、Filter、JDBC 之后面對(duì)的完整體項(xiàng)目就是這套。我當(dāng)年也是一集一集跟著敲敲完發(fā)現(xiàn)一個(gè)很現(xiàn)實(shí)的問(wèn)題跟著視頻能在本地跑起來(lái)合上視頻讓我自己從零寫一遍連包結(jié)構(gòu)都理不清。后來(lái)我把視頻丟到一邊只留題目和功能要求完整地復(fù)現(xiàn)了一遍。這篇文章就是那次復(fù)現(xiàn)的完整記錄環(huán)境、數(shù)據(jù)庫(kù)、分層代碼、登錄權(quán)限、分頁(yè)查詢、增刪改查、部署驗(yàn)證每一步我都盡量把背后的原因說(shuō)清楚。1. 項(xiàng)目定位與拆解這個(gè)經(jīng)典項(xiàng)目到底在訓(xùn)練什么1.1 業(yè)務(wù)模型超市、供應(yīng)商和訂單先理解業(yè)務(wù)。這個(gè)系統(tǒng)模擬的是一家超市的采購(gòu)訂單管理流程超市會(huì)從多家供應(yīng)商進(jìn)貨每筆進(jìn)貨對(duì)應(yīng)一張訂單訂單上記錄商品名、規(guī)格、數(shù)量、金額、是否已付款同時(shí)還要記錄這張訂單對(duì)應(yīng)哪家供應(yīng)商。管理人員打開(kāi)系統(tǒng)能看到所有訂單也能按商品名、供應(yīng)商、付款狀態(tài)篩選還要能新增、修改、刪除訂單。供應(yīng)商和用戶則是輔助管理模塊供應(yīng)商要維護(hù)聯(lián)系人、電話、地址、傳真用戶要區(qū)分角色普通員工和管理員看到的界面、能做的操作不一樣。業(yè)務(wù)不復(fù)雜但剛好能把一套入門級(jí)管理系統(tǒng)的完整鏈路覆蓋到從數(shù)據(jù)庫(kù)表設(shè)計(jì)到后臺(tái)接口再到前端頁(yè)面展示和交互每一環(huán)都不缺。對(duì)于剛學(xué)完 JavaWeb 基礎(chǔ)的人來(lái)說(shuō)它不像電商系統(tǒng)那樣龐大也不像課后作業(yè)那樣單薄是那種跳一跳正好夠得著的項(xiàng)目。1.2 功能清單與學(xué)習(xí)目標(biāo)登錄、退出登錄登錄后根據(jù)角色顯示對(duì)應(yīng)菜單用戶管理新增、修改、刪除、模糊查詢、角色篩選、分頁(yè)供應(yīng)商管理新增、修改、刪除、查看訂單管理新增、修改、刪除、組合條件查詢、分頁(yè)密碼修改校驗(yàn)舊密碼更新新密碼對(duì)應(yīng)到技術(shù)點(diǎn)清單就是下面這張表技術(shù)點(diǎn)在項(xiàng)目里的落點(diǎn)Maven依賴管理、war 打包、目錄規(guī)范Servlet所有請(qǐng)求入口處理參數(shù)、轉(zhuǎn)發(fā)/重定向JSP EL JSTL頁(yè)面展示、列表循環(huán)、分頁(yè)條Filter登錄攔截、字符編碼統(tǒng)一處理JDBC 封裝BaseDao、數(shù)據(jù)庫(kù)連接、增刪改查MySQL四張核心表、多表聯(lián)查這套項(xiàng)目最有價(jià)值的地方就在這里它沒(méi)有引入任何框架你能看到 Servlet 最原始的工作狀態(tài)也能自己動(dòng)手寫出一個(gè)能用的 JDBC 封裝層。之后再學(xué) Spring Boot 或 MyBatis你會(huì)更容易理解框架到底幫你省掉了什么。2. 環(huán)境與開(kāi)局版本組合選對(duì)了后面少踩一半坑我復(fù)現(xiàn)時(shí)用的環(huán)境組合是這批項(xiàng)目最常見(jiàn)的一檔JDK 8、Maven 3.6.3、Tomcat 8.5、MySQL 8.0。說(shuō)實(shí)話現(xiàn)在裝 JDK 17 的人很多但老項(xiàng)目代碼大多是給 JDK 8 設(shè)計(jì)的如果直接上 JDK 17Tomcat 的版本、編譯級(jí)別、依賴的舊 jar 都可能出兼容問(wèn)題第一輪排查就能耗掉半天。所以第一次復(fù)現(xiàn)建議直接按 JDK 8 來(lái)跑通以后再考慮升級(jí)。2.1 我用的那套穩(wěn)定組合JDK 1.8和主流的 Web 容器、視頻教程里的配置完全對(duì)得上Maven 3.6.xIDEA 自帶版本通常也能用注意配好本地倉(cāng)庫(kù)和鏡像源Tomcat 8.5支持 Servlet 3.1對(duì)老項(xiàng)目兼容性好MySQL 8.0需要注意驅(qū)動(dòng)類和時(shí)區(qū)參數(shù)下文會(huì)細(xì)說(shuō)IDEA社區(qū)版就能跑 Web 項(xiàng)目專業(yè)版只是多了框架支持有個(gè)細(xì)節(jié)我想提一下如果本機(jī)已經(jīng)裝了更高版本的 Tomcat比如 Tomcat 10那要特別注意它默認(rèn)使用的是 jakarta.servlet 命名空間老項(xiàng)目里的 javax.servlet 全部要改包名。對(duì)初學(xué)者來(lái)說(shuō)這是個(gè)大坑不建議在第一步就挑戰(zhàn)它。2.2 pom.xml 依賴與兩個(gè)容易出錯(cuò)的點(diǎn)先看依賴。Maven 工程的第一步是創(chuàng)建 war 包結(jié)構(gòu)的 Web 項(xiàng)目然后在 pom.xml 里加上核心依賴dependencies !-- Servlet APITomcat 已提供所以用 provided -- dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId version4.0.1/version scopeprovided/scope /dependency dependency groupIdjavax.servlet.jsp/groupId artifactIdjavax.servlet.jsp-api/artifactId version2.3.3/version scopeprovided/scope /dependency !-- JSTLJSP 頁(yè)面里做列表循環(huán)和條件判斷 -- dependency groupIdjstl/groupId artifactIdjstl/artifactId version1.2/version /dependency !-- MySQL 驅(qū)動(dòng) -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version /dependency /dependencies依賴?yán)镒钊菀壮鰡?wèn)題的就是 MySQL 驅(qū)動(dòng)。MySQL 5.x 用 com.mysql.jdbc.Driver而 MySQL 8.x 必須改成 com.mysql.cj.jdbc.Driver否則啟動(dòng)時(shí)會(huì)報(bào) ClassNotFoundException。第二個(gè)坑是連接串MySQL 8 默認(rèn)要求帶上時(shí)區(qū)參數(shù)所以連接地址通常寫成這樣jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/smbms?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8 jdbc.usernameroot jdbc.password123456characterEncodingutf8 這個(gè)參數(shù)也不能漏否則后面插入的中文數(shù)據(jù)到數(shù)據(jù)庫(kù)里全是問(wèn)號(hào)。2.3 IDEA 建 Web 工程時(shí)的 Artifact 問(wèn)題這一步是新手最容易卡住的地方而且卡得很莫名其妙工程建好了代碼寫完了一點(diǎn)運(yùn)行瀏覽器直接 404控制臺(tái)沒(méi)報(bào)錯(cuò)。原因多半是 IDEA 里沒(méi)有配置好 Web Artifact。正確流程是這樣的用 Maven 創(chuàng)建工程時(shí)選 webapp 骨架沒(méi)有骨架也可以后面手動(dòng)加 Web 模塊然后在 Project Structure 里把模塊的 Web Facet 關(guān)聯(lián)上再在 Artifacts 里新增一個(gè) war exploded 類型的啟動(dòng)產(chǎn)物最后在 Tomcat Run Configuration 的 Deployment 頁(yè)面把這個(gè) Artifact 添加進(jìn)去設(shè)置 Application context 為 /smbms。只要這幾步對(duì)齊Tomcat 啟動(dòng)后能直接訪問(wèn) http://localhost:8080/smbms/。實(shí)測(cè)下來(lái)社區(qū)版和新版 IDEA 的界面長(zhǎng)得不太一樣但核心套路沒(méi)變。如果啟動(dòng)后 index.jsp 都訪問(wèn)不了優(yōu)先檢查Artifacts 是否為空、context 路徑是否寫對(duì)、Tomcat 的 application server 是否已經(jīng)配置。3. 數(shù)據(jù)先行四張表的字段設(shè)計(jì)和容易忽略的小細(xì)節(jié)代碼還沒(méi)寫先把數(shù)據(jù)表建好。smbms 的核心是四張表角色表、用戶表、供應(yīng)商表和訂單表。我復(fù)現(xiàn)時(shí)按項(xiàng)目常見(jiàn)的字段結(jié)構(gòu)來(lái)建這也是整個(gè)系統(tǒng)最底層的部分。3.1 四張表的字段設(shè)計(jì)用戶表是最復(fù)雜的字段也比較多字段類型說(shuō)明idint主鍵自增userCodevarchar用戶編碼登錄時(shí)用userNamevarchar真實(shí)姓名userPasswordvarchar密碼建議存 MD5genderint性別1 男 0 女birthdaydate出生日期phonevarchar電話addressvarchar地址userRoleint角色 id對(duì)應(yīng) smbms_role 表createdByint創(chuàng)建人 idcreationDatedatetime創(chuàng)建時(shí)間modifyByint最后修改人 idmodifyDatedatetime最后修改時(shí)間角色表很簡(jiǎn)單id、roleCode、roleName一般就是管理員和普通員工。供應(yīng)商表 smbms_provider 包含供應(yīng)商編碼、名稱、描述、聯(lián)系人、電話、地址、傳真以及創(chuàng)建人、創(chuàng)建時(shí)間。訂單表 smbms_bill 是核心業(yè)務(wù)表包含訂單編碼、商品名、商品描述、計(jì)量單位、數(shù)量、總價(jià)、是否付款、供應(yīng)商 id以及創(chuàng)建和修改相關(guān)字段。字段命名看起來(lái)瑣碎但很有必要。createdBy、modifyBy 這些字段在后面的修改記錄功能里要用很多網(wǎng)上代碼為了省事刪掉了它們結(jié)果后來(lái)要追蹤數(shù)據(jù)變更就只能干瞪眼。3.2 外鍵不建物理外鍵的原因四張表之間有明顯的關(guān)聯(lián)關(guān)系用戶表 userRole 指向角色表 id訂單表 providerId 指向供應(yīng)商表 id。很多新手會(huì)想既然有關(guān)聯(lián)那就加上外鍵約束吧。實(shí)際項(xiàng)目里這套項(xiàng)目的常見(jiàn)做法是不建物理外鍵只做邏輯外鍵也就是字段值存在對(duì)應(yīng)關(guān)系但數(shù)據(jù)庫(kù)層面不強(qiáng)制約束。原因有二第一物理外鍵在刪除和更新時(shí)會(huì)帶來(lái)額外的約束判斷項(xiàng)目里我們刪除供應(yīng)商前要先檢查有沒(méi)有關(guān)聯(lián)訂單這個(gè)邏輯放在 Service 層控制更好提示也更友好第二邏輯外鍵讓拆庫(kù)、遷移、分表都更容易教學(xué)中也能更自然地引出 left join 聯(lián)查。如果你是在自己練手想加物理外鍵學(xué)習(xí)約束概念也沒(méi)問(wèn)題但在 smbms 這個(gè)項(xiàng)目里跟著主流做法走邏輯外鍵更省事。3.3 初始化數(shù)據(jù)與密碼存儲(chǔ)建完表一定要準(zhǔn)備初始化數(shù)據(jù)不然后面聯(lián)調(diào)全是空列表分頁(yè)、篩選都看不出效果。我放了 3 個(gè)用戶、2 家供應(yīng)商和 8 條訂單數(shù)據(jù)量剛好覆蓋兩頁(yè)方便測(cè)分頁(yè)邊界。密碼存儲(chǔ)這里要單獨(dú)說(shuō)一句。網(wǎng)上很多版本的 smbms 代碼里密碼是明文存的演示而已。但你自己做項(xiàng)目時(shí)建議至少封裝一個(gè) MD5Util把密碼加密后入庫(kù)登錄時(shí)先把用戶輸入的密碼 MD5 化再比對(duì)。這不是 smbms 要求的功能但這是一道安全底線練手項(xiàng)目也不能把明文密碼寫死在數(shù)據(jù)庫(kù)里。4. 骨架落地分層目錄、BaseDao 和基礎(chǔ)件先搭好環(huán)境就緒、表也建好了接下來(lái)是最重要的一步把代碼骨架搭起來(lái)。很多新手寫項(xiàng)目不講究包結(jié)構(gòu)所有類全堆在一起前期沒(méi)問(wèn)題寫到訂單模塊自己都找不到 Service 在哪。我建議從一開(kāi)始就按分層結(jié)構(gòu)來(lái)后面每個(gè)模塊的代碼都能精確落到對(duì)應(yīng)位置。4.1 包結(jié)構(gòu)與請(qǐng)求走向我用的包結(jié)構(gòu)是這樣的com.xxx.smbms ├── pojo // 實(shí)體類User、Role、Provider、Bill、PageSupport ├── dao // 數(shù)據(jù)訪問(wèn)接口 impl 實(shí)現(xiàn) ├── service // 業(yè)務(wù)接口 impl 實(shí)現(xiàn) ├── servlet // 控制層LoginServlet、UserServlet、ProviderServlet、BillServlet ├── filter // 過(guò)濾器UniversalFilter、LoginFilter └── util // 工具類JDBCUtil、MD5Util、常量類請(qǐng)求走向也很直白瀏覽器請(qǐng)求某個(gè) Servlet → Servlet 接收參數(shù)、調(diào) Service → Service 調(diào) DAO → DAO 操作 MySQL → 結(jié)果一層層返回 → Servlet 把數(shù)據(jù)塞進(jìn) request 或 session → 轉(zhuǎn)發(fā)到 JSP 頁(yè)面渲染。一開(kāi)始可能覺(jué)得分這么多層太繞但你要理解每一層的職責(zé)Servlet 不寫 SQLDAO 不寫業(yè)務(wù)判斷Service 不直接處理參數(shù)。好處是以后換數(shù)據(jù)庫(kù)、換前端、加緩存只需要?jiǎng)訉?duì)應(yīng)的一層。這套結(jié)構(gòu)其實(shí)就是后面 Spring 分層思想的雛形。4.2 數(shù)據(jù)庫(kù)工具類和 BaseDao 的作用JDBC 最麻煩的就是重復(fù)的加載驅(qū)動(dòng)、建連接、釋放資源。我參考網(wǎng)上常見(jiàn)寫法先寫一個(gè) BaseDao把通用邏輯收斂起來(lái)public class BaseDao { // 加載驅(qū)動(dòng) 獲取連接 public static Connection getConnection() throws Exception { return JDBCUtil.getConnection(); } // 通用增刪改支持可變參數(shù) public static int executeUpdate(Connection conn, String sql, Object... params) throws Exception { PreparedStatement ps conn.prepareStatement(sql); for (int i 0; i params.length; i) { ps.setObject(i 1, params[i]); } int result ps.executeUpdate(); closeAll(conn, ps, null); return result; } // 通用查詢返回 ResultSet 由 DAO 層自行封裝 public static ResultSet executeQuery(Connection conn, String sql, Object... params) throws Exception { PreparedStatement ps conn.prepareStatement(sql); for (int i 0; i params.length; i) { ps.setObject(i 1, params[i]); } return ps.executeQuery(); } // 釋放資源 public static void closeAll(Connection conn, PreparedStatement ps, ResultSet rs) throws Exception { if (rs ! null) rs.close(); if (ps ! null) ps.close(); if (conn ! null) conn.close(); } }這里有一個(gè)容易被忽略的點(diǎn)查詢返回的 ResultSet 不能立刻關(guān)閉連接和 PreparedStatement因?yàn)榉庋b ResultSet 還需要時(shí)間。所以我一般不在 executeQuery 方法里直接 closeAll而是讓 DAO 層在拿到結(jié)果、封裝成對(duì)象之后再調(diào)用 closeAll 關(guān)閉。很多新手在 BaseDao 里統(tǒng)一關(guān)閉資源結(jié)果一跑就報(bào)ResultSet already closed這個(gè)坑我踩過(guò)。4.3 接口加實(shí)現(xiàn)這個(gè)習(xí)慣值得堅(jiān)持雖然項(xiàng)目很小但我建議 DAO 和 Service 都寫成接口 實(shí)現(xiàn)類的形式比如 UserDao 接口下有 UserDaoImpl。理由不是規(guī)范這種空話而是等你想把 JDBC 換成 MyBatis 的時(shí)候只需要重新寫一套 DAO 實(shí)現(xiàn)類Servlet 和 Service 層完全不用動(dòng)。我后面把 smbms 遷移到 MyBatis 時(shí)深刻體會(huì)到這個(gè)設(shè)計(jì)有多省事。前端 JSP 頁(yè)面里取值依賴實(shí)體類的 getter/setter 規(guī)范pojo 類里字段名和頁(yè)面調(diào)用名要保持一致這里踩過(guò)坑的人不少。5. 登錄主鏈路Session、Filter 和角色控制登錄模塊是整個(gè)系統(tǒng)最先要跑的鏈路也是后面所有模塊的入口。只要登錄和攔截做好整個(gè)系統(tǒng)的骨架就穩(wěn)了。5.1 登錄流程與密碼比對(duì)登錄頁(yè)收集 userCode 和 userPassword提交到 UserServlet 的 login 方法。Servlet 先做簡(jiǎn)單的空值校驗(yàn)然后調(diào)用 Service 層按 userCode 查詢用戶拿回 user 對(duì)象后比對(duì)密碼。這里要注意如果數(shù)據(jù)庫(kù)里存的是 MD5那么比對(duì)前要把用戶輸入密碼也 MD5 化一次不能拿明文直接和密文比較。登錄成功的處理也有講究。我把 user 對(duì)象放進(jìn) session而不是只放一個(gè) userId這樣 JSP 頁(yè)面里可以直接用 ${sessionScope.user.userName} 顯示當(dāng)前登錄人也能隨時(shí)通過(guò) user.userRole 判斷角色。登錄失敗時(shí)向前端返回錯(cuò)誤信息轉(zhuǎn)發(fā)回 login.jsp在頁(yè)面用 EL 表達(dá)式回顯錯(cuò)誤內(nèi)容。5.2 Filter 攔截和靜態(tài)資源放行如果登錄流程寫完了但沒(méi)有加 Filter那么只要知道接口地址不登錄也能直接訪問(wèn)所有頁(yè)面。smbms 里最常見(jiàn)的寫法是建一個(gè) LoginFilter作用于所有請(qǐng)求在 doFilter 里判斷public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request (HttpServletRequest) req; HttpServletResponse response (HttpServletResponse) resp; String uri request.getRequestURI(); if (uri.endsWith(.css) || uri.endsWith(.js) || uri.endsWith(.jpg) || uri.endsWith(.png) || uri.endsWith(login.jsp) || uri.endsWith(login)) { chain.doFilter(request, response); return; } HttpSession session request.getSession(false); if (session ! null session.getAttribute(user) ! null) { chain.doFilter(request, response); } else { response.sendRedirect(request.getContextPath() /login.jsp); } }靜態(tài)資源放行這個(gè)細(xì)節(jié)特別容易漏如果你直接攔所有請(qǐng)求登錄頁(yè)的 css、js 全部加載不出來(lái)頁(yè)面會(huì)變成光禿禿的 HTML。判斷關(guān)鍵詞可以再完整一點(diǎn)比如還要放行登錄時(shí)的驗(yàn)證碼接口等。在 smbms 里沒(méi)有注冊(cè)所以放行 login 相關(guān)的路徑就夠了。如果你用的是注解方式配置 Filter比如 WebFilter(/*)注意要和 Servlet 的 URL 映射區(qū)分開(kāi)。Filter 攔的是請(qǐng)求路徑Servlet 的 WebServlet 注解定義的是功能入口兩者配合使用不要互相覆蓋。5.3 退出登錄與角色權(quán)限退出登錄比較簡(jiǎn)單調(diào)用 session.invalidate() 把整個(gè)會(huì)話廢掉然后重定向到 login.jsp。這里不要去手動(dòng) removeAttribute因?yàn)?session 里可能還存了分頁(yè)參數(shù)、條件參數(shù)不清理干凈容易殘留。角色權(quán)限這塊smbms 的常見(jiàn)實(shí)現(xiàn)是JSP 導(dǎo)航菜單里用 JSTL 判斷當(dāng)前登錄用戶的 userRole如果 roleId 是管理員顯示用戶管理入口普通員工則只顯示訂單和供應(yīng)商模塊。后臺(tái)也需要做一個(gè)簡(jiǎn)單的校驗(yàn)比如刪除用戶這個(gè)操作如果不是管理員登錄直接拒絕。雖然在教學(xué)項(xiàng)目里前端隱藏菜單已經(jīng)夠用但補(bǔ)上后臺(tái)校驗(yàn)會(huì)讓你對(duì)權(quán)限控制有更完整的理解。6. 列表頁(yè)與分頁(yè)查詢用戶、訂單共用的一套套路看完登錄接下來(lái)是整個(gè)項(xiàng)目里最肥的一塊列表和分頁(yè)。用戶管理、供應(yīng)商管理、訂單管理都有列表頁(yè)而且都支持條件查詢和分頁(yè)。這一套邏輯想明白了后面三個(gè)模塊可以復(fù)制粘貼著寫。6.1 分頁(yè)參數(shù)和 Page 對(duì)象分頁(yè)本身不復(fù)雜但參數(shù)多理清關(guān)系很重要。需要四個(gè)數(shù)totalCount 總記錄數(shù)、pageSize 每頁(yè)條數(shù)、currentPageNo 當(dāng)前頁(yè)、totalPageCount 總頁(yè)數(shù)。int totalCount userDao.getUserCount(userName, roleId); int pageSize 5; int totalPageCount (totalCount pageSize - 1) / pageSize; int currentPageNo 1; String pageIndex request.getParameter(pageIndex); if (pageIndex ! null !.equals(pageIndex)) { currentPageNo Integer.parseInt(pageIndex); } if (currentPageNo 1) currentPageNo 1; if (currentPageNo totalPageCount totalPageCount 0) currentPageNo totalPageCount; int begin (currentPageNo - 1) * pageSize;總頁(yè)數(shù)的計(jì)算公式 (totalCount pageSize - 1) / pageSize 是向上取整的意思這樣 8 條數(shù)據(jù)每頁(yè) 5 條算出來(lái)就是 2 頁(yè)而不是 1 頁(yè)。這個(gè)邊界細(xì)節(jié)很多人會(huì)在寫代碼的時(shí)候栽一跤。我把這四個(gè)參數(shù)連同查詢列表一起封裝成一個(gè) PageSupport 對(duì)象放回 request 里JSP 頁(yè)面統(tǒng)一取 pageSupport.totalPageCount、pageSupport.currentPageNo 這樣的屬性。這種對(duì)象化封裝的好處是不同模塊的頁(yè)面模板長(zhǎng)得一樣改樣式只需改一處。6.2 動(dòng)態(tài) SQL 拼接與條件回顯列表?xiàng)l件查詢的核心在 DAO 層。以用戶管理為例支持按姓名模糊查詢、按角色篩選SQL 要?jiǎng)討B(tài)拼接StringBuilder sql new StringBuilder( select u.*, r.roleName from smbms_user u left join smbms_role r on u.userRole r.id where 11); ListObject params new ArrayList(); if (userName ! null !.equals(userName)) { sql.append( and u.userName like ?); params.add(% userName %); } if (roleId 0) { sql.append( and u.userRole ?); params.add(roleId); } sql.append( order by u.creationDate desc limit ?, ?); params.add(begin); params.add(pageSize);where 11 這種寫法老項(xiàng)目里很常見(jiàn)好處是不管有沒(méi)有條件后面的 and 都能直接接上去不用費(fèi)心去判斷是否拼接了第一個(gè)條件。條件回顯是另一個(gè)坑。翻頁(yè)的時(shí)候如果只把 pageIndex 傳給后端userName 和 roleId 沒(méi)有傳那么第二頁(yè)的數(shù)據(jù)就變成了沒(méi)有查詢條件的全部數(shù)據(jù)。我最初的實(shí)現(xiàn)就是直接在超鏈接里拼 URL結(jié)果中文姓名在地址欄里會(huì)亂碼。后來(lái)我改成在 JSP 里放一個(gè)隱藏表單分頁(yè)按鈕先用 JS 往隱藏字段里寫入當(dāng)前篩選條件再提交這樣既不會(huì)亂碼也保住了條件。這是一個(gè)很典型的頁(yè)面上沒(méi)報(bào)錯(cuò)數(shù)據(jù)卻不對(duì)的隱蔽 bug排查起來(lái)很費(fèi)神。6.3 訂單模塊的組合查詢訂單管理比用戶管理多兩個(gè)查詢條件商品名、供應(yīng)商、是否付款。邏輯和用戶管理一樣只是 SQL 里多幾個(gè)判斷if (productName ! null !.equals(productName)) { sql.append( and b.productName like ?); params.add(% productName %); } if (providerId 0) { sql.append( and b.providerId ?); params.add(providerId); } if (isPayment 0) { sql.append( and b.isPayment ?); params.add(isPayment); }訂單列表還會(huì)帶出供應(yīng)商名稱所以要用 left join smbms_provider。寫到這里想提醒一句查詢列表和查詢總條數(shù)這兩條 SQL 一定要保持一致。常見(jiàn)情況是列表 SQL 里加了一個(gè)條件統(tǒng)計(jì)總數(shù)的 SQL 忘加結(jié)果就是頁(yè)面頂部顯示共 20 條翻頁(yè)卻只有 10 條。我在復(fù)現(xiàn)時(shí)真真切切踩過(guò)后來(lái)把查 count 和查 list 的兩個(gè)方法放在一起維護(hù)每次改條件都同步改兩個(gè)方法。7. 供應(yīng)商與訂單的增刪改那些容易漏掉的細(xì)節(jié)列表和分頁(yè)打通之后剩下的就是新增、修改、刪除這幾個(gè)動(dòng)作。這幾個(gè)動(dòng)作看起來(lái)是 CRUD 的機(jī)械重復(fù)但里面藏著不少不寫一遍就不會(huì)注意的細(xì)節(jié)。7.1 先查關(guān)聯(lián)再刪除供應(yīng)商數(shù)據(jù)的刪除是最容易破壞數(shù)據(jù)完整性的操作。如果某個(gè)供應(yīng)商下已經(jīng)存在訂單直接 delete provider那么訂單表里這個(gè) providerId 就變成孤數(shù)據(jù)了。所以刪除前一定要先查訂單表int billCount billDao.getBillCountByProviderId(providerId); if (billCount 0) { // 返回該供應(yīng)商下存在訂單不能刪除 } else { providerDao.deleteProviderById(providerId); }這個(gè)邏輯看起來(lái)簡(jiǎn)單但它觸及了一個(gè)非常本質(zhì)的問(wèn)題業(yè)務(wù)層面的完整性校驗(yàn)不能完全依賴數(shù)據(jù)庫(kù)約束。外部系統(tǒng)、批處理腳本、管理后臺(tái)都可能繞過(guò)頁(yè)面直接操作數(shù)據(jù)所以在 Service 層主動(dòng)做約束校驗(yàn)是最通用的兜底方案。7.2 修改時(shí)的 created/modify 字段網(wǎng)上很多版本的表單修改只更新業(yè)務(wù)字段比如用戶名、電話、地址完全不碰 createdBy、modifyBy、creationDate、modifyDate。這會(huì)導(dǎo)致一個(gè)問(wèn)題數(shù)據(jù)明明被改過(guò)了卻沒(méi)有任何痕跡。我建議修改操作至少做到兩點(diǎn)更新 modifyBy 為當(dāng)前登錄用戶 id更新 modifyDate 為當(dāng)前時(shí)間新增操作則要填 createdBy 和 creationDate。這可以說(shuō)是把表設(shè)計(jì)的價(jià)值真正用起來(lái)。用戶表還有一個(gè)特別容易翻車的字段birthday。前端日期選擇器提交的格式是 yyyy-MM-dd后端如果直接往 DATE 字段里 setString有些驅(qū)動(dòng)版本會(huì)報(bào)類型轉(zhuǎn)換錯(cuò)誤。穩(wěn)妥做法是在 Servlet 里先 SimpleDateFormat 解析成 java.util.Date再通過(guò) PreparedStatement.setDate 轉(zhuǎn)成 java.sql.Date 傳入。字符串和日期類型的轉(zhuǎn)換是 CRUD 模塊里新手報(bào)錯(cuò)最多的地方之一。7.3 Ajax 刪除訂單一個(gè)值得嘗試驗(yàn)證的前后端交互smbms 的訂單刪除環(huán)節(jié)很適合用來(lái)演示最簡(jiǎn)單的 Ajax。頁(yè)面點(diǎn)擊刪除按鈕后用 jQuery 發(fā) POST 請(qǐng)求到 BillServlet 的 del 方法后端刪除成功后返回字符串 success前端根據(jù)返回結(jié)果刷新頁(yè)面。function deleteBill(id) { if (confirm(確定刪除這條訂單嗎)) { $.post(${pageContext.request.contextPath}/bill.do, { method: del, id: id }, function (res) { if (res success) { location.reload(); } else { alert(res); } } ); } }對(duì)應(yīng) Servlet 端最后就是response.getWriter().write(success)。這個(gè)動(dòng)作本身不難但它是前端異步請(qǐng)求、后端返回字符串、前端局部刷新的雛形。如果你后面要做前后端分離這個(gè)小小的 Ajax 交互就是第一個(gè)熱身。我遇到的坑是Servlet 跳轉(zhuǎn)和返回普通文本的邊界。刪除成功后如果代碼里不小心寫了response.sendRedirectAjax 拿到的就不是 success 而是頁(yè)面內(nèi)容回調(diào)函數(shù)永遠(yuǎn)走不到正確分支。所以后端在處理 Ajax 請(qǐng)求時(shí)只寫數(shù)據(jù)不做頁(yè)面跳轉(zhuǎn)。8. 部署到 Tomcat從本地到瀏覽器首訪的驗(yàn)證步驟代碼寫完最后一步是把項(xiàng)目部署到 Tomcat 上真正通過(guò)瀏覽器訪問(wèn)。這一步對(duì)新手來(lái)說(shuō)往往比寫代碼更折磨因?yàn)槌鰡?wèn)題的時(shí)候控制臺(tái)不一定會(huì)報(bào)錯(cuò)頁(yè)面就給你一個(gè) 404 或 500。8.1 war 包與 IDEA 集成 Tomcat有兩種部署方式可以選。第一種是直接用 Maven 構(gòu)建 war 包扔到 Tomcat 的 webapps 目錄下啟動(dòng) Tomcat 后會(huì)自動(dòng)解壓部署。第二種是在 IDEA 里配置 Tomcat Servlet用 war exploded 部署開(kāi)發(fā)時(shí)改代碼能更快見(jiàn)效果。我建議先學(xué)會(huì)方式二配合 IDEA 調(diào)試斷點(diǎn)能直接打在 Servlet 代碼上排查問(wèn)題效率高。具體配置路徑前面已經(jīng)說(shuō)過(guò)關(guān)鍵點(diǎn)在于 Artifacts 要和 Web Facet 關(guān)聯(lián)缺了這一步Tomcat 能啟動(dòng)但找不到頁(yè)面。8.2 常見(jiàn)部署報(bào)錯(cuò)對(duì)照表把我在復(fù)現(xiàn)過(guò)程中遇到的幾類高頻問(wèn)題整理成了一張表現(xiàn)象可能原因處理方式ClassNotFoundException: com.mysql.cj.jdbc.DriverMySQL 驅(qū)動(dòng)沒(méi)引入或版本舊檢查 pom.xml 和 war 的 lib 目錄Access denied for user rootlocalhost賬號(hào)密碼不對(duì)或未授權(quán)檢查 jdbc.properties頁(yè)面 404Artifact 配置缺失/context 路徑不對(duì)檢查 IDEA 部署配置和訪問(wèn)路徑中文亂碼缺少字符集過(guò)濾器或數(shù)據(jù)庫(kù)連接串沒(méi)配編碼加 Filter檢查 url 的 characterEncodingPort 8080 already in use端口被占用改端口或結(jié)束占用進(jìn)程ResultSet already closed查詢后提前關(guān)閉了連接按 BaseDao 的關(guān)閉順序調(diào)整字符集這個(gè)問(wèn)題值得展開(kāi)一下。除了數(shù)據(jù)庫(kù)連接串的編碼參數(shù)代碼里通常還會(huì)有一個(gè)字符集過(guò)濾器在 doFilter 里執(zhí)行request.setCharacterEncoding(UTF-8)和response.setCharacterEncoding(UTF-8)。如果漏掉這個(gè) Filter表單提交的中文數(shù)據(jù)會(huì)在進(jìn)入 Servlet 之前就亂掉后面再怎么處理都救不回來(lái)所以它必須放在請(qǐng)求處理的最前面。8.3 每次啟動(dòng)前的小檢查清單部署次數(shù)多了之后我養(yǎng)成了一個(gè)習(xí)慣每次啟動(dòng)前花十秒鐘過(guò)一遍這三項(xiàng)。第一jdbc.properties 里的賬號(hào)密碼是否正確MySQL 服務(wù)有沒(méi)有啟動(dòng)第二Tomcat 端口是否被占用第三數(shù)據(jù)庫(kù)里有沒(méi)有初始化數(shù)據(jù)。八成的問(wèn)題都出在這三件事上。如果你訪問(wèn)的是 login.jsp但頁(yè)面里引用的 css、js 路徑全是 /css/xxx 這種絕對(duì)路徑就會(huì)出現(xiàn)樣式丟失。因?yàn)椴渴鸷箜?xiàng)目名是 smbms正確的路徑應(yīng)該是 /smbms/css/xxx。最穩(wěn)妥的寫法是在所有 JSP 頁(yè)面統(tǒng)一用${pageContext.request.contextPath}拼路徑這樣不管部署在哪個(gè) context 下都不會(huì)錯(cuò)。9. 跑通之后還能怎么走往 MyBatis 與 Spring 生態(tài)遷移smbms 完全跑通以后等于你親手徒手搭了一個(gè) JavaWeb 應(yīng)用。這時(shí)候千萬(wàn)別急著把它丟到一邊它是最好的進(jìn)化素材。9.1 替換 DAO把 JDBC 換成 MyBatis我做的第一個(gè)改造是把原生 JDBC 的 DAO 實(shí)現(xiàn)替換成 MyBatis。因?yàn)榍懊媪袅?DAO 接口所以 Servlet 和 Service 層幾乎不用改只需要寫新的 mapper 文件和實(shí)現(xiàn)類然后把 Service 里 new 出來(lái)的 DAO 實(shí)現(xiàn)類換成 MyBatis 版本。這個(gè)改造過(guò)程會(huì)讓你真正理解 ORM 框架省掉的到底是什么連接管理、SQL 執(zhí)行、結(jié)果集到對(duì)象的映射。寫一遍之后你再去看 MyBatis 的動(dòng)態(tài) SQL會(huì)發(fā)現(xiàn)和你在 smbms 里手寫的 if 拼接邏輯一模一樣。當(dāng)然遷移過(guò)程中也有幾個(gè)容易翻車的點(diǎn)。MyBatis 的if testuserName ! null and userName ! 判斷邏輯要和原 JDBC 版本保持一致比如模糊查詢里是否拼接 like、% 放在哪一邊這些細(xì)節(jié)不對(duì)就會(huì)查出完全不同的結(jié)果。另外分頁(yè)的 limit 參數(shù)在 MyBatis 里要顯式標(biāo)注類型不然某些驅(qū)動(dòng)會(huì)報(bào)參數(shù)類型不明確這類問(wèn)題排查起來(lái)往往要靠翻日志。9.2 前后端分離與 Spring 化smbms 作為腳手架的價(jià)值再進(jìn)一步可以把 JSP 全部換成純前端頁(yè)面后端只提供 JSON 接口。登錄、分頁(yè)、模糊查詢這些功能你已經(jīng)知道怎么做只是把返回格式從 JSP 頁(yè)面變成 JSON 字符串。這個(gè)練習(xí)做完了Spring Boot 里最基礎(chǔ)的 Controller 寫法對(duì)你來(lái)說(shuō)就沒(méi)有任何神秘感。如果還不滿足后面也可以把 Servlet 替換成 Spring MVC把 Service 交給 Spring 容器管理。這樣一套遷移走下來(lái)你等于用 smbms 這個(gè)骨架把整個(gè) JavaWeb 進(jìn)化史重走了一遍。我后來(lái)把這次復(fù)現(xiàn)的代碼給過(guò)幾個(gè)新人參考他們問(wèn)得最多的其實(shí)不是登錄或者分頁(yè)而是動(dòng)態(tài) SQL 拼接那段到底為什么這么寫。遇到這種情況我的建議永遠(yuǎn)只有一個(gè)別急著背把拼接出來(lái)的 SQL 打印到控制臺(tái)對(duì)照日志看一遍比對(duì)著屏幕猜十遍都有用。這一步做完smbms 對(duì)你就不是一個(gè)視頻里跑過(guò)的項(xiàng)目而是真正屬于你自己的第一份 JavaWeb 工程了。