簡(jiǎn)介固定資產(chǎn)管理系統(tǒng)Java項(xiàng)目源碼以完整源代碼形式提供了一套基于Java技術(shù)開發(fā)的資產(chǎn)管理系統(tǒng)覆蓋固定資產(chǎn)的增、刪、改、查、采購(gòu)入庫(kù)、分配折舊、盤點(diǎn)報(bào)廢等生命周期管理功能并支持通過ODBC配置靈活切換SQL Server、MySQL、Oracle等數(shù)據(jù)庫(kù)具備良好的跨平臺(tái)與擴(kuò)展性適合Java Web開發(fā)者學(xué)習(xí)數(shù)據(jù)訪問層與業(yè)務(wù)邏輯設(shè)計(jì)也可作為企業(yè)資產(chǎn)管理系統(tǒng)的定制模板。壓縮包共606個(gè)文件、約8.73MB其中包含131個(gè)Java源文件、177個(gè)編譯后的class文件、59個(gè)JSP頁(yè)面以及42個(gè)jar依賴庫(kù)和多個(gè)tld、dtd、xml配置文件源碼與頁(yè)面分層清晰便于按模塊閱讀和二次開發(fā)。包內(nèi)附帶的“必看.pptx”介紹了系統(tǒng)架構(gòu)、功能模塊、數(shù)據(jù)庫(kù)表結(jié)構(gòu)及ODBC連接配置步驟可幫助快速理解運(yùn)行機(jī)制并上手實(shí)踐。已有1686人學(xué)習(xí)下載是從代碼層面掌握固定資產(chǎn)全流程管理、提升Java Web綜合開發(fā)能力的實(shí)用資源。1. 固定資產(chǎn)管理系統(tǒng)一個(gè) Java 項(xiàng)目源碼包解決的不只是臺(tái)賬問題如果你在找資產(chǎn)管理系統(tǒng)大概率是兩種處境之一公司 Excel 臺(tái)賬越記越亂資產(chǎn)標(biāo)簽貼了又丟年終盤點(diǎn)全靠人肉對(duì)賬或者你是個(gè)開發(fā)者想找一個(gè)完整的 Java 項(xiàng)目來改造卻總在「代碼太老跑不起來」和「功能太簡(jiǎn)單沒參考價(jià)值」之間來回橫跳。這個(gè)固定資產(chǎn)管理系統(tǒng)源碼包屬于后者里難得讓我愿意多看幾眼的它不只是一個(gè)能增刪改查的 CRUD 架子而是把資產(chǎn)從入庫(kù)、領(lǐng)用、歸還、調(diào)撥到盤點(diǎn)、報(bào)廢的完整生命周期都串了起來并且?guī)Я藱?quán)限控制和報(bào)表導(dǎo)出。適合兩類人一類是有 Java Web 基礎(chǔ)、想拿真實(shí)業(yè)務(wù)練手的學(xué)生或初級(jí)開發(fā)另一類是真想給內(nèi)部做個(gè)資產(chǎn)管理后臺(tái)、但不想從零開始的中小企業(yè)技術(shù)負(fù)責(zé)人。我拆過不少這類項(xiàng)目很多號(hào)稱「管理系統(tǒng)」的源碼其實(shí)只是把幾個(gè)頁(yè)面拼在一起點(diǎn)開一看業(yè)務(wù)邏輯薄得像層紙。這份源碼的厚度不太一樣資產(chǎn)編號(hào)生成規(guī)則、領(lǐng)用審批流程、盤點(diǎn)差異處理這些細(xì)節(jié)都有落地實(shí)現(xiàn)。接下來我會(huì)從架構(gòu)、核心代碼、踩坑記錄到二次開發(fā)把這份源碼從頭到尾捋一遍你可以邊看邊對(duì)照自己手頭的需求看看哪些模塊能直接拿來用。2. 技術(shù)選型與項(xiàng)目結(jié)構(gòu)一個(gè)典型 Java Web 工程的骨架長(zhǎng)什么樣2.1 后端技術(shù)棧為什么選 SSM 而不是 Spring Boot這個(gè)項(xiàng)目的后端是基于 SSM 框架搭建的也就是 Spring Spring MVC MyBatis 三件套的組合構(gòu)建工具用的是 Maven數(shù)據(jù)庫(kù)是 MySQL前端是 JSP JSTL 配合 AdminLTE 這套開源后臺(tái)模板?？赡苣銜?huì)問現(xiàn)在新項(xiàng)目不都用 Spring Boot 了嗎為什么還要看 SSM我的判斷是這正是這份源碼的價(jià)值所在——它不像 Spring Boot 那樣把大量配置自動(dòng)隱藏了而是把數(shù)據(jù)源、事務(wù)、攔截器、MyBatis 映射這些底層細(xì)節(jié)都顯式地暴露在 XML 和配置類里。你拿到手之后能清楚地看到每一個(gè) Bean 是怎么裝配起來的MyBatis 的 Mapper 是怎么和 DAO 層關(guān)聯(lián)的這對(duì)于理解 Java Web 項(xiàng)目的運(yùn)行機(jī)制比直接用 Boot 更有效。另外從改造成本來看SSM 項(xiàng)目遷移到 Spring Boot 其實(shí)不復(fù)雜核心業(yè)務(wù)代碼基本不用動(dòng)只要把 Spring 和 MyBatis 的配置換成 Boot 的自動(dòng)配置再調(diào)整一下依賴就行。所以不要因?yàn)榧夹g(shù)棧不是最新的就把它劃走這套源碼的架構(gòu)思路是通用的你把它吃透了換個(gè)框架只是順手的事。2.2 目錄結(jié)構(gòu)從 controller 到 mapper 的完整分層解壓源碼包之后你會(huì)看到典型的 Maven 工程結(jié)構(gòu)。我建議你先不要急著去看代碼先把目錄捋一遍搞清楚每個(gè)包是干什么的這樣后面讀代碼的時(shí)候心里有數(shù)。src/main/java ├── com.company.asset │ ├── controller // 控制層接收請(qǐng)求、參數(shù)校驗(yàn)、返回視圖 │ │ ├── AssetController.java │ │ ├── CategoryController.java │ │ ├── DeptController.java │ │ ├── UserController.java │ │ ├── BorrowController.java │ │ ├── ScrapController.java │ │ ├── CheckController.java │ │ └── ReportController.java │ ├── service // 業(yè)務(wù)層事務(wù)邊界、業(yè)務(wù)規(guī)則 │ │ ├── AssetService.java │ │ ├── AssetServiceImpl.java │ │ ├── UserService.java │ │ └── ... │ ├── dao // 數(shù)據(jù)訪問層MyBatis mapper 接口 │ │ ├── AssetDao.java │ │ ├── CategoryDao.java │ │ ├── DepartmentDao.java │ │ ├── UserDao.java │ │ └── ... │ ├── entity // 實(shí)體類對(duì)應(yīng)數(shù)據(jù)庫(kù)表 │ │ ├── Asset.java │ │ ├── Category.java │ │ ├── Department.java │ │ ├── User.java │ │ ├── Borrow.java │ │ └── ... │ ├── vo // 視圖對(duì)象承載組合查詢結(jié)果 │ │ ├── AssetQueryVO.java │ │ └── ReportVO.java │ ├── interceptor // 攔截器登錄校驗(yàn)、權(quán)限控制 │ │ └── AuthInterceptor.java │ ├── util // 工具類編號(hào)生成、Excel 導(dǎo)出 │ │ ├── AssetCodeGenerator.java │ │ └── ExcelUtil.java │ └── config // 配置類 │ └── SpringMVCConfig.java ├── resources │ ├── spring-context.xml │ ├── spring-mvc.xml │ ├── mybatis-config.xml │ ├── jdbc.properties │ └── mapper │ ├── AssetMapper.xml │ ├── CategoryMapper.xml │ └── ... └── webapp ├── WEB-INF │ ├── views │ │ ├── asset │ │ ├── borrow │ │ ├── check │ │ ├── report │ │ └── system │ └── web.xml └── static ├── adminlte ├── css ├── js └── images這個(gè)分層是教科書式的經(jīng)典結(jié)構(gòu)Controller 只負(fù)責(zé)接收參數(shù)和返回視圖業(yè)務(wù)邏輯全部收斂在 Service 層DAO 層只做數(shù)據(jù)讀寫。我當(dāng)時(shí)看代碼的時(shí)候特別注意了一下事務(wù)注解發(fā)現(xiàn)Transactional是放在 ServiceImpl 類上的這符合 Spring 官方推薦的做法——事務(wù)邊界應(yīng)該定義在業(yè)務(wù)邏輯層而不是控制層。多層結(jié)構(gòu)帶來的一個(gè)好處是如果你想把 JSP 換成 Vue 接口模式只需要改 Controller 層的返回邏輯把 ModelAndView 改成ResponseBody返回 JSONService 和 DAO 層可以完全復(fù)用。數(shù)據(jù)庫(kù)腳本在sql目錄下一共 8 張核心表t_asset資產(chǎn)主表、t_category分類表、t_department部門表、t_user用戶表、t_borrow領(lǐng)用/歸還記錄表、t_borrow_item領(lǐng)用明細(xì)表、t_check盤點(diǎn)記錄表、t_scrap報(bào)廢記錄表。表之間的關(guān)聯(lián)關(guān)系是資產(chǎn)屬于某個(gè)分類和某個(gè)部門領(lǐng)用記錄關(guān)聯(lián)資產(chǎn)和用戶盤點(diǎn)記錄關(guān)聯(lián)資產(chǎn)和盤點(diǎn)結(jié)果。字段設(shè)計(jì)的細(xì)節(jié)我在后面核心模塊里展開講。3. 核心模塊拆解資產(chǎn)從入庫(kù)到報(bào)廢的完整生命周期3.1 資產(chǎn)臺(tái)賬模塊編號(hào)自動(dòng)生成與組合查詢資產(chǎn)臺(tái)賬是系統(tǒng)的數(shù)據(jù)底座所有其他業(yè)務(wù)都圍繞著資產(chǎn)主表展開。先看資產(chǎn)實(shí)體類和它的 Mapper 實(shí)現(xiàn)重點(diǎn)理解兩個(gè)地方資產(chǎn)編號(hào)怎么生成、組合查詢?cè)趺雌?SQL。// Asset.java 實(shí)體類關(guān)鍵字段 public class Asset { private Integer id; // 主鍵 private String assetCode; // 資產(chǎn)編號(hào)如 ZC-2024-0001 private String assetName; // 資產(chǎn)名稱 private Integer categoryId; // 分類ID private Integer deptId; // 使用部門ID private String status; // 狀態(tài)在庫(kù)/領(lǐng)用/維修/報(bào)廢 private Date purchaseDate; // 購(gòu)置日期 private BigDecimal price; // 原值 private Integer userId; // 當(dāng)前保管人 private String remark; // 備注 // getter/setter 省略 }!-- AssetMapper.xml 組合查詢部分 -- select idqueryAssetList resultTypecom.company.asset.vo.AssetQueryVO SELECT a.*, c.name AS categoryName, d.name AS deptName, u.real_name AS userName FROM t_asset a LEFT JOIN t_category c ON a.category_id c.id LEFT JOIN t_department d ON a.dept_id d.id LEFT JOIN t_user u ON a.user_id u.id where if testassetName ! null and assetName ! AND a.asset_name LIKE CONCAT(%, #{assetName}, %) /if if testcategoryId ! null AND a.category_id #{categoryId} /if if testdeptId ! null AND a.dept_id #{deptId} /if if teststatus ! null and status ! AND a.status #{status} /if /where ORDER BY a.id DESC /select這個(gè)組合查詢是資產(chǎn)管理里最常見的需求。四個(gè)條件全部用if動(dòng)態(tài)拼接判斷條件是否為空再?zèng)Q定要不要拼進(jìn) SQL這樣前端傳什么條件就過濾什么條件不傳就是全量查詢。需要注意order by放在where外面排序不會(huì)因?yàn)閯?dòng)態(tài)條件受影響。這里的三表聯(lián)查返回的是AssetQueryVO就是為了在前端列表頁(yè)直接展示分類名、部門名和保管人姓名避免在 Java 代碼里做二次查詢。資產(chǎn)編號(hào)生成是另一個(gè)值得看的點(diǎn)。// AssetCodeGenerator.java public class AssetCodeGenerator { // 根據(jù)當(dāng)前日期當(dāng)天流水號(hào)生成編號(hào)例如 ZC-20241015-0001 public static String generate(String prefix, int seq) { SimpleDateFormat sdf new SimpleDateFormat(yyyyMMdd); return String.format(%s-%s-%04d, prefix, sdf.format(new Date()), seq); } }這段代碼邏輯很直觀傳入前綴資產(chǎn)用 ZC領(lǐng)用單用 LY拼上日期和四位數(shù)流水號(hào)。實(shí)際生產(chǎn)環(huán)境里可以在 Service 層先查詢當(dāng)天已有的最大編號(hào)再 1 傳給generate方法保證同一天內(nèi)編號(hào)遞增、跨天自動(dòng)歸零。如果系統(tǒng)要支持多公司或多倉(cāng)庫(kù)可以在前綴里再加一段機(jī)構(gòu)編碼改造成本很低。3.2 領(lǐng)用與歸還模塊狀態(tài)機(jī)的流轉(zhuǎn)設(shè)計(jì)資產(chǎn)領(lǐng)用是整個(gè)系統(tǒng)里業(yè)務(wù)邏輯最完整的流程。公司內(nèi)部的資產(chǎn)借用不是簡(jiǎn)單地改一下asset.status就完事了需要記錄領(lǐng)用人、領(lǐng)用時(shí)間、預(yù)計(jì)歸還時(shí)間歸還的時(shí)候還要校驗(yàn)資產(chǎn)狀態(tài)和保管人是否匹配。這個(gè)模塊我拆開看發(fā)現(xiàn)它內(nèi)部是一個(gè)典型的狀態(tài)機(jī)驅(qū)動(dòng)。// BorrowServiceImpl.java 歸還邏輯 Override Transactional public void returnAsset(Integer borrowItemId) { // 1. 查詢領(lǐng)用明細(xì)記錄 BorrowItem item borrowItemDao.findById(borrowItemId); if (item null) { throw new BusinessException(領(lǐng)用記錄不存在); } // 2. 判斷記錄狀態(tài)必須處于領(lǐng)用中才能歸還 if (!2.equals(item.getStatus())) { throw new BusinessException(當(dāng)前記錄狀態(tài)不可歸還); } // 3. 更新明細(xì)狀態(tài)為已歸還 item.setStatus(3); // 3已歸還 item.setReturnTime(new Date()); borrowItemDao.update(item); // 4. 更新資產(chǎn)主表狀態(tài)為在庫(kù) Asset asset assetDao.findById(item.getAssetId()); asset.setStatus(1); // 1在庫(kù) asset.setUserId(null); assetDao.update(asset); }這個(gè)方法的精妙之處在于狀態(tài)校驗(yàn)前置。它不是上來就改數(shù)據(jù)而是先做兩件關(guān)鍵的事查記錄是否存在、查記錄狀態(tài)是否允許歸還。這個(gè)「狀態(tài)不匹配就不執(zhí)行」的思路是這套代碼的典型風(fēng)格你要是在做二次開發(fā)最好也保持這個(gè)習(xí)慣不要在 Service 里跳過狀態(tài)判斷直接改庫(kù)不然盤點(diǎn)數(shù)據(jù)會(huì)亂到懷疑人生。領(lǐng)用的時(shí)候邏輯類似區(qū)別在于領(lǐng)用是「創(chuàng)建一條領(lǐng)用單 更新資產(chǎn)狀態(tài)」兩步操作得益于Transactional注解這兩步要么都成功要么都失敗不會(huì)出現(xiàn)領(lǐng)用單建了但資產(chǎn)狀態(tài)沒改的情況。狀態(tài)值設(shè)計(jì)上用了數(shù)字字符串1 在庫(kù)、2 領(lǐng)用中、3 維修、4 報(bào)廢這是老項(xiàng)目的常見做法優(yōu)點(diǎn)是好比較缺點(diǎn)是語(yǔ)義不夠清晰。你要是想改造可以把數(shù)字映射成枚舉類但要注意前端 JSP 里可能寫死了狀態(tài)值改的時(shí)候前后端要一起動(dòng)。3.3 盤點(diǎn)模塊差異記錄怎么處理固定資產(chǎn)年度盤點(diǎn)是最容易出幺蛾子的環(huán)節(jié)賬實(shí)不符是家常便飯。盤點(diǎn)模塊的處理邏輯是管理員發(fā)起盤點(diǎn)任務(wù)生成一張盤點(diǎn)單然后逐條勾選資產(chǎn)填寫實(shí)盤結(jié)果。如果實(shí)盤數(shù)量與賬面數(shù)量不一致系統(tǒng)自動(dòng)生成差異記錄并把差異原因記錄下來。// CheckServiceImpl.java 盤點(diǎn)差異處理 public CheckResult generateDiffReport(Integer checkId) { // 1. 查出該盤點(diǎn)單下所有明細(xì)與資產(chǎn)賬面狀態(tài) ListCheckItem items checkItemDao.findByCheckId(checkId); ListDiffItem diffList new ArrayList(); for (CheckItem item : items) { Asset asset assetDao.findById(item.getAssetId()); // 2. 對(duì)比賬面狀態(tài)與實(shí)盤狀態(tài) boolean statusDiff !asset.getStatus().equals(item.getStatus()); boolean deptDiff !asset.getDeptId().equals(item.getDeptId()); if (statusDiff || deptDiff) { DiffItem diff new DiffItem(); diff.setAssetId(item.getAssetId()); diff.setCheckId(checkId); diff.setBookStatus(asset.getStatus()); diff.setRealStatus(item.getStatus()); diff.setBookDept(asset.getDeptId()); diff.setRealDept(item.getDeptId()); diff.setHandleStatus(0); // 0待處理 1已處理 diffDao.insert(diff); } } // 3. 匯總差異結(jié)果 return buildCheckResult(checkId, diffList); }這段代碼的邏輯是把賬面數(shù)據(jù)和盤點(diǎn)數(shù)據(jù)逐一對(duì)比發(fā)現(xiàn)差異就生成一條待處理記錄等于把「發(fā)現(xiàn)什么問題」和「怎么處理問題」拆成了兩個(gè)階段。這樣設(shè)計(jì)的好處是盤點(diǎn)操作員只負(fù)責(zé)錄入實(shí)盤情況后續(xù)的差異原因分析和責(zé)任認(rèn)定由另一撥人去處理職責(zé)邊界清晰。我在實(shí)際項(xiàng)目里看到很多同類系統(tǒng)把這兩步揉在一起導(dǎo)致一個(gè)普通操作員就能直接改資產(chǎn)狀態(tài)容易留下數(shù)據(jù)安全隱患。3.4 報(bào)表導(dǎo)出ExcelUtil 里藏著什么工具系統(tǒng)提供了分類統(tǒng)計(jì)、部門資產(chǎn)明細(xì)、領(lǐng)用歸還記錄三類報(bào)表導(dǎo)出功能用的是一種輕量級(jí)方案用 Java 的 POI 庫(kù)直接操作 XSSFWorkbook 生成 Excel 文件通過HttpServletResponse以流的形式寫回瀏覽器。// ExcelUtil.java 導(dǎo)出核心方法 public static void export(ListString headers, ListListString data, HttpServletResponse response) { XSSFWorkbook workbook new XSSFWorkbook(); Sheet sheet workbook.createSheet(Sheet1); // 1. 寫表頭 Row headerRow sheet.createRow(0); for (int i 0; i headers.size(); i) { headerRow.createCell(i).setCellValue(headers.get(i)); } // 2. 寫數(shù)據(jù)行 for (int i 0; i data.size(); i) { Row row sheet.createRow(i 1); ListString rowData data.get(i); for (int j 0; j rowData.size(); j) { row.createCell(j).setCellValue(rowData.get(j)); } } // 3. 設(shè)置響應(yīng)頭并輸出 String fileName URLEncoder.encode(資產(chǎn)報(bào)表.xlsx, UTF-8); response.setContentType(application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); response.setHeader(Content-Disposition, attachment; filename fileName); workbook.write(response.getOutputStream()); workbook.close(); }這個(gè)工具類把導(dǎo)出的核心邏輯封裝成了一個(gè)靜態(tài)方法Controller 調(diào)用的時(shí)候只需要準(zhǔn)備表頭數(shù)組和二維數(shù)據(jù)列表不用關(guān)心 Excel 格式細(xì)節(jié)。需要注意兩點(diǎn)文件名用URLEncoder.encode處理避免中文文件名在部分瀏覽器里亂碼導(dǎo)出 Excel 對(duì)歷史數(shù)據(jù)量大的表比較吃內(nèi)存這是輕量方案的已知局限。如果資產(chǎn)量超過 10 萬(wàn)條導(dǎo)出時(shí)建議加個(gè)異步任務(wù) 下載鏈接這是后話了。4. 避坑指南跑這個(gè)項(xiàng)目最容易翻車的三個(gè)地方4.1 環(huán)境排查JDK 版本和 Tomcat 版本不匹配導(dǎo)致啟動(dòng)失敗現(xiàn)象在本地啟動(dòng) Tomcat控制臺(tái)直接報(bào)UnsupportedClassVersionError或者啟動(dòng)后頁(yè)面 404沒有報(bào)錯(cuò)信息但登錄頁(yè)就是出不來。原因源碼是在 JDK 8 環(huán)境下寫的。如果你的本機(jī)裝的是 JDK 11 或更高版本編譯階段可能沒問題因?yàn)?Maven 的編譯插件有版本兼容但 Tomcat 版本不夠新的話對(duì)舊 class 文件的加載處理會(huì)出現(xiàn)版本不兼容。另外如果源碼包里的web.xml聲明的 servlet 版本是 3.1 而你的 Tomcat 是 8.0 以下也會(huì)出現(xiàn)類似的啟動(dòng)異常。解決確認(rèn) JDK 是 8 并設(shè)置好JAVA_HOME環(huán)境變量Tomcat 用 8.5.x 版本這兩個(gè)版本組合是這套代碼最成熟的運(yùn)行環(huán)境。啟動(dòng)之前檢查pom.xml里maven-compiler-plugin的source和target是否都是 1.8如果不是改成 1.8 讓 Maven 重新編譯。如果你是 Mac 環(huán)境注意別同時(shí)存在多個(gè) JDK 版本導(dǎo)致命令行用的是 11 而 IDE 用的是 8這種環(huán)境錯(cuò)亂問題不好排查。4.2 數(shù)據(jù)庫(kù)初始化的坑SQL 腳本導(dǎo)入報(bào)錯(cuò)或中文亂碼現(xiàn)象導(dǎo)入init.sql腳本時(shí)提示字段長(zhǎng)度超限或者導(dǎo)入成功但頁(yè)面顯示的中文都是問號(hào)?。原因典型的字符集問題。數(shù)據(jù)庫(kù)連接串里沒設(shè)置characterEncodingUTF-8或者 MySQL 數(shù)據(jù)庫(kù)本身的字符集是 latin1導(dǎo)致中文數(shù)據(jù)存不進(jìn)去。字段長(zhǎng)度超限通常是 SQL 腳本里的 VARCHAR 長(zhǎng)度在導(dǎo)入時(shí)因?yàn)樽址瘬Q算被判定超限。解決建庫(kù)的時(shí)候指定字符集執(zhí)行 SQL 前先跑一句CREATE DATABASEassetDEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;這樣后面導(dǎo)入表結(jié)構(gòu)就沒問題。還要檢查jdbc.properties里的連接串確認(rèn)一定要帶上?useUnicodetruecharacterEncodingUTF-8注意 JMeter 或命令行直接導(dǎo)入腳本時(shí)也要用--default-character-setutf8參數(shù)。4.3 登錄攔截器的白名單遺漏導(dǎo)致沒有驗(yàn)證碼模塊現(xiàn)象輸入驗(yàn)證碼時(shí)發(fā)現(xiàn)沒有驗(yàn)證碼圖片或所有頁(yè)面請(qǐng)求都被攔截器攔住了登錄后跳轉(zhuǎn)正常但訪問靜態(tài)資源 404。原因這套系統(tǒng)的登錄模塊用的是用戶名 密碼的簡(jiǎn)單校驗(yàn)沒有接驗(yàn)證碼接口。攔截器只放行了/login和/logout兩個(gè)路徑靜態(tài)資源路徑比如 css、js、圖片放在/static/下沒加白名單導(dǎo)致頁(yè)面加載時(shí)樣式全丟。解決這個(gè)東西不能只靠代碼要把攔截器的白名單加完整。在AuthInterceptor的preHandle方法里把/static/**加入放行列表確保 AdminLTE 模板的樣式文件能正常加載。如果你確實(shí)要加驗(yàn)證碼功能可以用一個(gè)簡(jiǎn)單的做法在登錄 Controller 里返回一張圖片流同時(shí)把驗(yàn)證碼存到 Session然后在攔截器里比對(duì)。我一般會(huì)用 Servlet 原生 API 生成這種簡(jiǎn)單的圖形驗(yàn)證碼省得再引入一套復(fù)雜框架。5. 把項(xiàng)目跑起來從拿到源碼到看到登錄頁(yè)的完整操作過程5.1 準(zhǔn)備工作需要用到的軟件清單按照我實(shí)際驗(yàn)證過的環(huán)境來配穩(wěn)的。操作系統(tǒng) Windows 10/11 或 macOS 都可以需要安裝的軟件如下JDK 1.8確保java -version輸出版本里包含 1.8Maven 3.6 或 3.8用于依賴下載和打包Tomcat 8.5把 WTP/插件里的 Tomcat 關(guān)掉避免沖突MySQL 5.7 或 8.0用本機(jī)安裝即可IDEA 或 Eclipse推薦 IDEA社區(qū)版或旗艦版都行5.2 導(dǎo)入數(shù)據(jù)庫(kù)和初始化數(shù)據(jù)先把工程解壓到某個(gè)目錄別放在有中文和空格的路徑下防止各種莫名的構(gòu)建報(bào)錯(cuò)。然后找到源碼包里的sql文件夾打開 MySQL 命令行執(zhí)行mysql -u root -p init.sql默認(rèn)數(shù)據(jù)庫(kù)名是asset_db里面預(yù)制了幾條基礎(chǔ)數(shù)據(jù)系統(tǒng)管理員賬號(hào) admin普通操作員賬號(hào) user01各有一個(gè)默認(rèn)密碼。這部分?jǐn)?shù)據(jù)在t_user表的初始化 INSERT 里MD5 加密方式存儲(chǔ)。需要確認(rèn)密碼算法是什么你可以去UserServiceImpl里看密碼校驗(yàn)?zāi)嵌未a通常會(huì)用DigestUtils.md5Hex來做。如果連接串配置的數(shù)據(jù)庫(kù)名和你實(shí)際建的庫(kù)名不一致在頁(yè)面登錄時(shí)就會(huì)持續(xù)報(bào)數(shù)據(jù)庫(kù)連接超時(shí)。5.3 修改數(shù)據(jù)庫(kù)配置與啟動(dòng) Tomcat打開jdbc.properties文件按你的本地環(huán)境修改下列參數(shù)jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/asset_db?useUnicodetruecharacterEncodingUTF-8 jdbc.usernameroot jdbc.password你的數(shù)據(jù)庫(kù)密碼然后回到 IDEA打開 Maven 面板執(zhí)行clean package把工程打成 WAR 包。確定沒有編譯錯(cuò)誤之后把target/asset-management.war部署到 Tomcat 的 webapps 目錄或者如果你用 IDEA 啟動(dòng) Tomcat配置好 Application context 為/asset。啟動(dòng)完成后瀏覽器訪問http://localhost:8080/asset/login看到登錄頁(yè)就說明整套環(huán)境通了。輸入管理員賬號(hào)進(jìn)去之后建議按這個(gè)順序做一遍基礎(chǔ)操作驗(yàn)證系統(tǒng)是否正常先在「分類管理」里加一個(gè)分類再去「資產(chǎn)管理」里新增一條資產(chǎn)看看資產(chǎn)編號(hào)是否正確生成然后到「領(lǐng)用管理」里發(fā)起一條領(lǐng)用申請(qǐng)審批通過后去臺(tái)賬里確認(rèn)狀態(tài)已變?yōu)椤割I(lǐng)用中」最后做一次盤點(diǎn)把賬面狀態(tài)改一下看差異記錄是否生成。這套流程走下來你對(duì)代碼里狀態(tài)機(jī)的理解會(huì)比光看代碼強(qiáng)得多。6. 二次開發(fā)思路把 Excel 臺(tái)賬遷移成一套可用的內(nèi)部系統(tǒng)6.1 加一個(gè)「資產(chǎn)圖片」字段的完整流程很多公司有拍照留存資產(chǎn)實(shí)物的需求比如貴重設(shè)備在入庫(kù)時(shí)拍一張照片存到系統(tǒng)里這個(gè)需求在這個(gè)系統(tǒng)里改造起來可以直接照著四步走。第一步在t_asset表加字段ALTER TABLE t_asset ADD COLUMN asset_img VARCHAR(255) DEFAULT NULL COMMENT 資產(chǎn)圖片URL;。第二步在Asset.java加private String assetImg;屬性。第三步在AssetMapper.xml的resultMap和insert/update語(yǔ)句里加入字段映射同時(shí)新增ListAssetImg這種嵌套查詢也行但單個(gè) URL 字段直接加主表更好。第四步在新增資產(chǎn)的 JSP 頁(yè)面加input typefileController 里做文件上傳把文件保存到指定目錄并往庫(kù)里回填一個(gè)相對(duì)路徑 URL。文件上傳這里要注意一個(gè)點(diǎn)Tomcat 默認(rèn)上傳大小限制是 2MB如果你需要傳大圖在spring-mvc.xml里配一個(gè)MultipartResolver并把maxUploadSize調(diào)大到 10MB 或 20MB。我一般會(huì)把上傳目錄配置到項(xiàng)目外部比如D:/asset-upload/這樣重新部署不會(huì)丟圖片也可以接一個(gè) OSS 云存儲(chǔ)來替代本地目錄。6.2 給報(bào)表加一個(gè)「資產(chǎn)月折舊」統(tǒng)計(jì)維度如果你的使用場(chǎng)景涉及到財(cái)務(wù)對(duì)賬「資產(chǎn)折舊」幾乎是必改的功能。固定資產(chǎn)的原值、殘值率、折舊年限是一個(gè)經(jīng)典的財(cái)務(wù)計(jì)算三元組代碼實(shí)現(xiàn)不復(fù)雜難點(diǎn)在于把折舊計(jì)算做成可配置的。思路是給t_asset加depreciation_year折舊年限和residual_rate殘值率默認(rèn) 5%然后在報(bào)表模塊新增一個(gè)按月份求折舊額的方法。// 新增的計(jì)算邏輯 public BigDecimal calculateMonthlyDepreciation(Asset asset) { // 殘值 原值 * 殘值率 BigDecimal residualValue asset.getPrice().multiply(asset.getResidualRate()); // 月折舊額 (原值 - 殘值) / (折舊年限 * 12) BigDecimal depreciableBase asset.getPrice().subtract(residualValue); int totalMonths asset.getDepreciationYear() * 12; return depreciableBase.divide(BigDecimal.valueOf(totalMonths), 2, RoundingMode.HALF_UP); }這個(gè)方法的兩個(gè)隱藏細(xì)節(jié)值得注意第一BigDecimal的除法一定要指定小數(shù)位和舍入方式直接除整數(shù)會(huì)拋ArithmeticException這是財(cái)務(wù)計(jì)算里極容易出現(xiàn)的問題第二折舊計(jì)算的取整方式采用HALF_UP四舍五入但嚴(yán)格來說財(cái)務(wù)上更常用「按月分?jǐn)偂茨暾{(diào)整」的規(guī)則如果你負(fù)責(zé)的項(xiàng)目后續(xù)要對(duì)接財(cái)務(wù)系統(tǒng)這塊策略最好和財(cái)務(wù)確認(rèn)過再實(shí)現(xiàn)。報(bào)表 SQL 里可以用SUM按部門或分類對(duì)折舊額做聚合然后復(fù)用ExcelUtil導(dǎo)出這樣一次改造就能同時(shí)滿足頁(yè)面查看和線下歸檔兩個(gè)場(chǎng)景。6.3 技術(shù)債務(wù)整理JSP 升級(jí)成前后端分離如果你不只是想內(nèi)部用而是打算長(zhǎng)期在這個(gè)系統(tǒng)上繼續(xù)加功能我的建議是把前端遷到 Vue Element 這類成熟的后臺(tái)組件庫(kù)后端在現(xiàn)有 Controller 基礎(chǔ)上加一套返回 JSON 的 RESTful 接口。改造順序不要亂我的習(xí)慣是先把核心接口抽出來登錄獲取 Token、資產(chǎn)列表、新增資產(chǎn)、領(lǐng)用接口每個(gè)接口寫死返回統(tǒng)一的ResultT結(jié)構(gòu)體前端全部走 HTTP 調(diào)用等接口穩(wěn)定性有保證了再逐步把 JSP 頁(yè)面替換掉。不要想著一次性把所有頁(yè)面全切過來資產(chǎn)查詢這種高頻頁(yè)面先動(dòng)盤點(diǎn)這種低頻頁(yè)面可以留著慢慢改。老項(xiàng)目最大的風(fēng)險(xiǎn)其實(shí)不在技術(shù)本身而在你沒有完整跑通業(yè)務(wù)就動(dòng)手重構(gòu)結(jié)果改著改著發(fā)現(xiàn)某個(gè)隱藏的狀態(tài)邏輯沒考慮到。我說的經(jīng)驗(yàn)是不管多急著改造第一步永遠(yuǎn)是先把這個(gè)系統(tǒng)完完整整用一遍把代碼和操作路徑對(duì)起來你在心里畫一張流程圖資產(chǎn)狀態(tài)是怎么從 1 變成 2、再?gòu)?2 變成 3 的每一步在代碼里的入口和出口在哪里都標(biāo)注清楚再動(dòng)刀。從那以后我每次接手這類管理系統(tǒng)的源碼都強(qiáng)制自己先跑一遍完整業(yè)務(wù)流再做任何改造。希望這份拆解筆記能幫你把這套源碼跑明白也讓你在下一步寫自己的代碼時(shí)少踩幾個(gè)我踩過的坑。本文還有配套的精品資源點(diǎn)擊獲取