1. 別小看停車系統(tǒng)JSP方案解決的三個現(xiàn)實(shí)問題如果你在學(xué)校被分配到這個題目或者公司內(nèi)部要做一個園區(qū)級別的停車管理系統(tǒng)演示版八成都會搜到智能停車管理系統(tǒng)j3e0t這一類的項(xiàng)目包。很多同學(xué)拿到手第一反應(yīng)是JSP不是老技術(shù)了嗎為什么還要用。但真正把它跑起來之后你會明白用JSP做這類管理系統(tǒng)恰恰是性價比最高的選擇之一。先說這個系統(tǒng)到底解決什么問題。一批固定的車位比如地下車庫、寫字樓配套車位需要管理車輛進(jìn)出的記錄、車位占用情況、費(fèi)用結(jié)算再加上管理員能登錄后臺看數(shù)據(jù)。這些需求聽起來簡單但落到代碼層面你至少要處理的現(xiàn)實(shí)問題有三個第一車輛進(jìn)出的完整臺賬。不是光記錄一個車牌號就行得有入場時間、出場時間、停車時長、費(fèi)用金額最好還能篩選某個時間段內(nèi)的所有記錄方便月底對賬。第二車位的動態(tài)狀態(tài)。哪些車位被占了、哪些是空的、能不能按區(qū)域匯總這是停車管理系統(tǒng)區(qū)別于普通登記系統(tǒng)的核心邏輯。第三用戶權(quán)限的邊界。普通用戶或者車主和管理員看到的內(nèi)容不一樣。管理員能操作后臺配置普通用戶可能只需要查自己的停車記錄或者預(yù)約車位。說實(shí)話如果你用Spring Boot從頭搭一套技術(shù)上當(dāng)然沒問題但學(xué)習(xí)成本和研究代碼的時間會翻好幾倍。而這個JSP項(xiàng)目包程序源碼數(shù)據(jù)庫調(diào)試部署的思路是用最少的技術(shù)棧完成完整業(yè)務(wù)閉環(huán)一個Tomcat加上MySQL就能全部跑通前端頁面、Java后臺和數(shù)據(jù)庫三層關(guān)系一目了然。這對于上課、交作業(yè)、做畢業(yè)設(shè)計或者想快速理解一個Web系統(tǒng)是怎么轉(zhuǎn)起來的這件事幫助是直接的。我習(xí)慣用這類項(xiàng)目教學(xué)時告訴別人一句話JSP不是讓你非要在生產(chǎn)環(huán)境里證明什么而是讓你以最短路徑看到一個系統(tǒng)的完整形態(tài)。等你看懂了它的性別、模塊和數(shù)據(jù)庫關(guān)系再去遷移到Spring Boot、SSM或者其他框架只是體力活。這份源碼的價值恰恰在這里——它把系統(tǒng)是怎么長出來的完整攤開給你看。所以這篇文章我打算從架構(gòu)、數(shù)據(jù)庫、頁面邏輯和部署調(diào)試幾個角度把這個項(xiàng)目徹底拆開講一遍。手里有源碼的跟著走一遍能跑通沒源碼的看完也能自己照著寫一個。2. 系統(tǒng)模塊劃分代碼量不大但邊界要清楚拿到項(xiàng)目后很多人第一件事是急著點(diǎn)開源碼看頁面恨不得把代碼從頭讀到尾。我的建議是反過來先把系統(tǒng)的功能模塊畫出來再去看代碼。這個項(xiàng)目雖然是管理系統(tǒng)的老幾樣但模塊邊界仍然值得逐條理清。以成熟的版本為例核心模塊通常分為以下幾塊登錄與用戶管理區(qū)分管理員和普通用戶登錄后進(jìn)入不同的首頁。管理員可以管理用戶信息普通用戶只能查看和操作自己權(quán)限內(nèi)的數(shù)據(jù)。車位信息管理車位的基本信息維護(hù)包括車位編號、區(qū)域位置、當(dāng)前是否被占用、對應(yīng)的車輛信息、備注說明等。車輛停車管理核心業(yè)務(wù)模塊。車輛入庫時記錄車牌號、入場時間分配一個空閑車位車輛出場時計算停車時長和費(fèi)用標(biāo)記車位為空。停車記錄統(tǒng)計按時間段查詢進(jìn)出記錄計算收入?yún)R總方便管理員對賬。車位狀態(tài)展示可以用表格或平面圖形式清晰展示哪些車位空閑、哪些占用這是停車系統(tǒng)最直觀的價值點(diǎn)。不要小看邊界清楚這四個字它對代碼閱讀和后續(xù)擴(kuò)展都極其重要。例如用戶刪除權(quán)限必須和停車記錄解耦——如果某個用戶有停車記錄而你直接刪掉用戶表里的記錄關(guān)聯(lián)記錄就會變成無主數(shù)據(jù)頁面上查出來就是一團(tuán)亂麻。源碼里一般會做外鍵關(guān)聯(lián)或者業(yè)務(wù)層的判斷你要留意看。接著看你手上的項(xiàng)目包結(jié)構(gòu)。通常是一個標(biāo)準(zhǔn)Java Web工程的布局項(xiàng)目根目錄/ ├── src/ │ ├── com.xxx.dao/ // 數(shù)據(jù)庫訪問層負(fù)責(zé)SQL操作 │ ├── com.xxx.model/ // 實(shí)體類對應(yīng)數(shù)據(jù)表結(jié)構(gòu) │ ├── com.xxx.servlet/ // Servlet接收前端請求并調(diào)用業(yè)務(wù)層 │ ├── com.xxx.util/ // DBUtil等公共工具類 │ └── ... ├── WebContent/ // 或webapp目錄 │ ├── admin/ // 管理員頁面 │ ├── user/ // 普通用戶頁面 │ ├── css/ js/ // 靜態(tài)資源 │ └── WEB-INF/ │ ├── web.xml // Web配置文件 │ └── lib/ // 依賴jar包 └── sql/ └── parking.sql // 數(shù)據(jù)庫腳本我第一次看這種結(jié)構(gòu)時也有點(diǎn)煩覺得怎么這么多文件夾。但吃透之后發(fā)現(xiàn)這其實(shí)是ServletJSP時代最經(jīng)典的MVC簡化版JSP負(fù)責(zé)展示ViewServlet負(fù)責(zé)控制跳轉(zhuǎn)和參數(shù)處理ControllerDAO負(fù)責(zé)數(shù)據(jù)庫操作Model。后來你學(xué)Spring MVC時會發(fā)自內(nèi)心地感謝這種不繞彎的分層——它就是最樸素的分層教學(xué)。這里有個通用建議不要在Servlet里直接拼HTML也不要在JSP頁面里直接寫SQL。項(xiàng)目里如果已經(jīng)有了DBUtil這種工具類就統(tǒng)一走它。沒有的話自己補(bǔ)一個也行核心目的是讓數(shù)據(jù)庫連接這件事只在一處配置后面改連接信息的時候不抓狂。3. 數(shù)據(jù)庫設(shè)計六張核心表和計費(fèi)邏輯落地數(shù)據(jù)庫是整個停車系統(tǒng)的地基。很多小白上線不到一天就崩不是因?yàn)榇a跑不起來而是建表時沒考慮好關(guān)系。這個項(xiàng)目的SQL腳本通常會一次性幫你建好庫表和測試數(shù)據(jù)但你如果打算自己復(fù)刻請圍繞以下六張核心表來設(shè)計。3.1 核心表結(jié)構(gòu)說明用戶表users/user_info用戶ID、用戶名、密碼、角色管理員/普通用戶、真實(shí)姓名、聯(lián)系方式。 密碼存不存明文這個項(xiàng)目如果只是教學(xué)演示多半是明文或簡單的MD5能跑通就行。自己加需求時至少用MD5加鹽或者寫個簡單的加密工具類這點(diǎn)不過分。車位表parking_space/car_space車位ID、車位編號、所在區(qū)域、是否占用、備注。是否占用建議用int型的flag字段0空閑1占用比用字符串空閑/占用要更利于寫查詢條件。車輛信息表car_info車牌號作為唯一標(biāo)識或者主鍵、車輛類型、車主ID、入場時間。一般來說一輛車對應(yīng)一個車主所以在表里加一個owner_id外鍵關(guān)聯(lián)用戶表。停車記錄表parking_record記錄ID、車牌號、車位ID、入場時間、出場時間、停車時長、總費(fèi)用。出場時間要為NULL的情況設(shè)計好——對那些還沒有出場的車出場時間和費(fèi)用字段可以是空的等結(jié)算時再回填。費(fèi)用規(guī)則表fee_rule單價、計時單位、免費(fèi)時長、封頂金額。這塊我建議單獨(dú)建表而不是把價格寫死在代碼里。原因很簡單管理員改收費(fèi)規(guī)則時不需要動代碼直接改數(shù)據(jù)庫或者做個配置頁面就行。管理員操作日志表opt_log可選**操作人ID、操作類型、操作時間、操作詳情。這個在畢設(shè)演示時非常加分老師問起[數(shù)據(jù)安全]或者[操作軌跡]你能直接演示給他看。3.2 一張可參考的建表SQL拿MySQL舉例精簡版的腳本長這樣CREATE TABLE users ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL, role TINYINT DEFAULT 0, -- 0普通用戶 1管理員 real_name VARCHAR(50), phone VARCHAR(20) ); CREATE TABLE parking_space ( id INT PRIMARY KEY AUTO_INCREMENT, space_no VARCHAR(20) NOT NULL UNIQUE, zone VARCHAR(20) DEFAULT A區(qū), status TINYINT DEFAULT 0, -- 0空閑 1占用 remark VARCHAR(200) ); CREATE TABLE parking_record ( id INT PRIMARY KEY AUTO_INCREMENT, plate_no VARCHAR(20) NOT NULL, space_id INT, entry_time DATETIME, exit_time DATETIME, duration_minutes INT, total_fee DECIMAL(10,2), FOREIGN KEY (space_id) REFERENCES parking_space(id) );注意parking_record里我推薦存一個duration_minutes字段。為什么因?yàn)槌鰣鰰r算費(fèi)用用兩個時間戳相減再做格式化和費(fèi)用計算代碼會陷入一堆時間處理邏輯。直接在出場時把分鐘數(shù)算好存進(jìn)去后續(xù)統(tǒng)計和展示都會輕松得多。這是一種典型的用空間換邏輯簡潔的做法適合這類小系統(tǒng)。3.3 計費(fèi)規(guī)則的實(shí)現(xiàn)思路計費(fèi)邏輯看起來很簡單時長乘單價。但你要踩的坑都在細(xì)節(jié)里。比如不足一小時按一小時計還是按分鐘計大多數(shù)停車系統(tǒng)是不足一小時按一小時。有沒有免費(fèi)時段比如進(jìn)場15分鐘內(nèi)免費(fèi)這個判斷必須在計時終止時做?？缣煸趺刺幚碛械南到y(tǒng)晚上八點(diǎn)到次日八點(diǎn)算夜場統(tǒng)一價有的系統(tǒng)直接按總時長。如果項(xiàng)目里沒寫具體要求建議先實(shí)現(xiàn)最樸素的按時長計費(fèi)再預(yù)留一個fee_rule表方便后改。代碼層面無非是(exitTime - entryTime)算出秒數(shù)或分鐘數(shù)再除以計費(fèi)單位向上取整乘單價。用Java寫就兩行l(wèi)ong minutes (exit.getTime() - entry.getTime()) / (1000 * 60); double fee Math.ceil(minutes / 60.0) * unitPrice;這段邏輯不要散落在多個JSP里務(wù)必封裝在ParkingService類的calculateFee()方法里。以后要改規(guī)則只改這一處。這個習(xí)慣很多人要到翻車之后才會養(yǎng)成——改一個需求結(jié)果全局搜unitPrice搜出七八處最后自己都不知道哪處生效。4. 本地跑起來的完整鏈路環(huán)境搭建與項(xiàng)目結(jié)構(gòu)導(dǎo)讀這個項(xiàng)目包附帶調(diào)試部署說明但我見過太多人在環(huán)境這一步就卡了一晚上。這里把全流程按我實(shí)測的路徑給你捋一遍。4.1 需要的四個基礎(chǔ)組件組件建議版本用途JDK1.8或8u系列老舊項(xiàng)目兼容性最佳Java編譯與運(yùn)行環(huán)境Tomcat8.5或9.0Web服務(wù)器承載JSP/ServletMySQL5.7或8.0數(shù)據(jù)庫5.7一般更省心IDEEclipse或IDEA導(dǎo)入源碼、部署運(yùn)行這里有一個版本細(xì)節(jié)如果你是JDK17以上老項(xiàng)目里的mysql-connector-java版本太舊可能會出現(xiàn)時區(qū)錯誤推薦用MySQL Connector/J 8.0.33及以上驅(qū)動類名仍然是com.mysql.cj.jdbc.Driver。4.2 數(shù)據(jù)庫導(dǎo)入與連接配置在Navicat或命令行里導(dǎo)入sql/parking.sql注意執(zhí)行前選對字符集默認(rèn)utf8mb4否則你插入中文測試數(shù)據(jù)會變問號。導(dǎo)入之后去Java源碼里找到DBUtil一般位置在com.xxx.util包改三處private static final String URL jdbc:mysql://localhost:3306/parking?useSSLfalsecharacterEncodingutf8serverTimezoneAsia/Shanghai; private static final String USERNAME root; private static final String PASSWORD 你自己的密碼;特別說一句serverTimezoneAsia/Shanghaimysql-connector-java 8.x版本沒有這個參數(shù)會直接連不上報一個Cannot create PoolableConnectionFactory的錯誤。很多人掛在這一步不是代碼問題是連接串少了時區(qū)。4.3 IDE里部署Tomcat的步驟IDEA為例打開項(xiàng)目后File → Project Structure → Artifacts確認(rèn)Web項(xiàng)目的構(gòu)建輸出是war或者exploded形式。Run/Debug Configurations → 左上角加號 → Tomcat Server → LocalServer Tab頁里點(diǎn)Configure選擇Tomcat安裝目錄。Deployment Tab頁里把a(bǔ)rtifact加進(jìn)去Application context建議填/parking。啟動Tomcat瀏覽器訪問http://localhost:8080/parking。Eclipse用戶流程也差不多只是多了右鍵項(xiàng)目→Run As→Run on Server這個入口。提示如果你用IDEA啟動后出現(xiàn)404時先看IDEA的控制臺日志里是否報ClassNotFoundException絕大多數(shù)是Artifacts里沒有把lib下的jar包打進(jìn)去。解決辦法Project Structure → Artifacts → 選中項(xiàng)目 → Available Elements里把lib右鍵→Put into WEB-INF/lib重新啟動就好。4.4 默認(rèn)賬號說明這類項(xiàng)目包里通常預(yù)置了初始賬號方便演示。常見的是admin/admin123有的項(xiàng)目會自帶一個user/123456。找不到的話打開SQL文件users表的insert語句里就是答案。這個細(xì)節(jié)別忽略登錄不進(jìn)去大概率不是代碼問題是沒看初始化的數(shù)據(jù)。5. 調(diào)試部署中的真實(shí)翻車點(diǎn)從404到中文亂碼每次把這類項(xiàng)目發(fā)給別人我大概能猜到他們會在哪些地方卡住。這里把高頻問題集中列出來你對照著排查可以省掉一晚上的折騰。5.1 項(xiàng)目啟動后訪問404排查順序很重要按這個來不要跳確認(rèn)Tomcat有沒有啟動成功?？纯刂婆_日志是否出現(xiàn)INFO: Server startup in ...。確認(rèn)訪問路徑的對不對。如果你把Application context配成/parking訪問根路徑http://localhost:8080/確實(shí)會404這不是錯誤是你沒訪問對地方。確認(rèn)web.xml里的welcome-file-list配置。如果歡迎頁指向login.jsp那訪問/parking應(yīng)該會自動調(diào)到登錄頁。如果配的是index.jsp且文件不存在同樣會404。最后再檢查Artifacts是否包含所有jar包。5.2 數(shù)據(jù)庫連接失敗報錯一般是Access denied for user或者Communications link failure。Access denied用戶名、密碼不對或者你正在用的賬號沒有遠(yuǎn)程權(quán)限。Communications link failureMySQL沒啟動或者連接串里的端口不是3306。這里有個小坑本機(jī)裝過多個MySQL實(shí)例時localhost:3306可能指向一個舊服務(wù)而那個服務(wù)里根本沒有parking庫。用Navicat先連接一下再確認(rèn)一下連的是哪個端口不然你在代碼里改了密碼也沒用。5.3 中文亂碼亂碼有三種來源必須分清。JSP頁面顯示亂碼檢查頁面開頭的% page contentTypetext/html;charsetUTF-8 languagejava %沒有的話補(bǔ)上。數(shù)據(jù)庫存儲亂碼建表時指定DEFAULT CHARSETutf8mb4連接串里帶characterEncodingutf8Navicat/命令行導(dǎo)入SQL時也要確認(rèn)字符集。這屬于一個鏈路只改了其中一環(huán)仍然會亂。請求參數(shù)亂碼POST提交中文變問號在Servlet的doPost開頭加一行request.setCharacterEncoding(UTF-8);或者在web.xml里配CharacterEncodingFilter過濾器。順帶提醒千萬不要自己拼SQL去處理中文條件查詢比如where name keyword 一旦編碼配置有遺漏這行代碼會給你帶來很難發(fā)現(xiàn)的調(diào)試噩夢。請用PreparedStatement占位符。5.4 500錯誤和空指針最常見的場景用戶登錄后列表頁報NullPointerException。原因通常是session里的用戶對象是空的或者查詢結(jié)果集里某個字段為null頁面直接調(diào)用了.toString()。你去看報錯日志定位到第幾行多半是這種小細(xì)節(jié)加一個空值判斷就好。還有一個高發(fā)點(diǎn)是日期格式化。Oracle的JSTL標(biāo)簽庫在JSP里格式化DATETIME類型有時會報異常穩(wěn)妥的做法是在實(shí)體類里先把Date轉(zhuǎn)成String用字符串展示。別在JSP里和java.util.Date硬剛不是不能是沒必要。5.5 修改了代碼不生效很多人改完JSP刷新瀏覽器發(fā)現(xiàn)還是老樣子。先檢查IDE有沒有自動部署IDEA里是Build → Rebuild并重啟Tomcat再檢查瀏覽器緩存——開發(fā)模式下按CtrlF5強(qiáng)刷。JSP文件有一個天生的優(yōu)勢Tomcat在調(diào)試模式下是熱加載的改完保存然后刷新即可生效。但如果改的是Java類或者配置文件建議老老實(shí)實(shí)重啟Tomcat別依賴熱部署IDE的熱部署有時候不觸發(fā)重新編譯會給你一種改了跟沒改一樣的錯覺。6. 在原有功能上能做的二次擴(kuò)展既然源碼和數(shù)據(jù)庫都到手了純跑通只是起點(diǎn)。如果這是你的課設(shè)、畢設(shè)或者是要提交的練手項(xiàng)目我建議你在這個基礎(chǔ)上做一兩個小而亮眼的擴(kuò)展點(diǎn)面試或答辯時都能說得上話。6.1 給車位加一個區(qū)域分布視圖現(xiàn)在很多系統(tǒng)是表格展示車位狀態(tài)一眼抓不到重點(diǎn)。你可以在頁面上用一個網(wǎng)格或卡片視圖每個車位是一個色塊綠色表示空閑、紅色表示占用點(diǎn)擊色塊能看到該車位對應(yīng)的車輛信息。增加的代碼量不大后端提供一個listAllSpacesWithCarInfo()方法前端用表格或div渲染視覺效果立刻上一個檔次。6.2 增加簡單的月度統(tǒng)計報表在parking_record表的基礎(chǔ)上寫一個按天分組的SQLSELECT DATE(entry_time) AS day, COUNT(*) AS total_orders, SUM(total_fee) AS income FROM parking_record WHERE exit_time IS NOT NULL GROUP BY DATE(entry_time) ORDER BY day DESC;頁面上用表格展示再配一個簡單的柱狀圖可以用ECharts的CDN引入一個bar圖只需要幾行配置就是數(shù)據(jù)可視化的加分項(xiàng)。如果不想引入額外依賴純用表格加顏色條也能表達(dá)。6.3 把密碼改成加密存儲如果項(xiàng)目里還是明文密碼擴(kuò)展一下也不難。用DigestUtils.md5Hex()或者BCrypt注冊時加密登錄時比較。這屬于安全意識的體現(xiàn)答辯時一句我考慮了密碼安全問題比寫十行代碼更得分。我見過不少同學(xué)做這個擴(kuò)展時栽在一個地方數(shù)據(jù)庫里已經(jīng)有明文賬號代碼改成MD5后老賬號登錄不進(jìn)去了。處理方法很簡單——寫一個一次性腳本把現(xiàn)有密碼統(tǒng)一更新成MD5加密后的值要么就清掉舊數(shù)據(jù)重新注冊。6.4 車輛編號與自定義查詢原系統(tǒng)如果只能按車牌號模糊查詢你可以擴(kuò)展成多條件組合查詢車牌號、時間段、車位區(qū)域、是否出場四個條件可組合對應(yīng)一個動態(tài)拼接SQL的搜索方法。這塊是面試官眼里很實(shí)在的業(yè)務(wù)需求場景適合練手。寫動態(tài)SQL時注意一個安全習(xí)慣條件拼接請使用StringBuilder然后全部用PreparedStatement參數(shù)綁定不要圖方便直接用字符串拼接進(jìn)SQL否則SQL注入的路子就開了。7. 我最后想說的話這個項(xiàng)目包的價值在于它用一個不太復(fù)雜的技術(shù)棧把一個管理系統(tǒng)應(yīng)該有的東西全都撐起來了用戶權(quán)限、數(shù)據(jù)表關(guān)系、業(yè)務(wù)流轉(zhuǎn)、頁面交互、部署方式。如果你只是把它跑起來然后復(fù)制粘貼交作業(yè)那學(xué)到的東西很有限。真正劃算的打開方式是先跑通再改壞一個功能最后再把它修好。這個過程里你對一個Web系統(tǒng)運(yùn)轉(zhuǎn)機(jī)制的體感會超過你背十頁八股文。我在實(shí)際調(diào)試這類項(xiàng)目時還有一個習(xí)慣把數(shù)據(jù)庫里的測試數(shù)據(jù)改造成自己編的場景比如模擬一輛車早上八點(diǎn)進(jìn)場、下午六點(diǎn)出場中間夾雜幾次跨天的記錄。然后對著頁面核驗(yàn)費(fèi)用計算是否正確。這個方法能幫你快速找到計費(fèi)邏輯的邊界問題——比如跨天到底算不算兩個時段費(fèi)用。改過這一次之后你對需求邊界和測試數(shù)據(jù)設(shè)計的理解會完全不同。最后分享一個小經(jīng)驗(yàn)如果你要部署到別的機(jī)器上演示別只拷一份war包就完事。把數(shù)據(jù)庫SQL腳本、配置文件里的用戶名密碼、Tomcat端口這三個地方提前確認(rèn)一遍。大多數(shù)演示翻車現(xiàn)場都是死在別人機(jī)器上MySQL密碼和你本機(jī)不一樣。項(xiàng)目包再完整也經(jīng)不起環(huán)境不一致的折騰這些準(zhǔn)備工作等你吃過虧就會明白有多重要。