管理系統(tǒng):Swing三層架構(gòu)與避坑實(shí)踐)
簡(jiǎn)介一份面向 Java 課程設(shè)計(jì)及 GUI 初學(xué)者的圖書(shū)管理系統(tǒng)資料包覆蓋圖書(shū)入庫(kù)、分類(lèi)編目、多條件查詢(xún)、借還書(shū)及權(quán)限管理等完整業(yè)務(wù)閉環(huán)。整體圍繞系統(tǒng)管理、進(jìn)書(shū)管理、圖書(shū)入庫(kù)、查詢(xún)和借還書(shū)五大模塊展開(kāi)包含角色管理、用戶(hù)管理、修改密碼、新書(shū)登記、庫(kù)存位置更新、超期罰款與續(xù)借校驗(yàn)等細(xì)致功能讀者和管理員擁有不同操作權(quán)限貼近實(shí)際館藏業(yè)務(wù)場(chǎng)景。代碼中同時(shí)體現(xiàn)界面交互與業(yè)務(wù)邏輯的分離可直接運(yùn)行學(xué)習(xí)或二次開(kāi)發(fā)部署。資源共 263 個(gè)文件以 93 個(gè) Java 源碼為主輔以 26 個(gè)依賴(lài) jar、109 個(gè)編譯 class、SQL 初始腳本、課設(shè)報(bào)告及界面圖片整體約 16.87MB便于對(duì)照源碼、報(bào)告與數(shù)據(jù)庫(kù)腳本理清設(shè)計(jì)思路。已有 5589 人學(xué)習(xí)使用適合借鑒 Java Swing 界面布局、JDBC 數(shù)據(jù)操作與分層思想也可快速搭起圖書(shū)信息管理原型或改造成畢業(yè)設(shè)計(jì)。1. 圖書(shū)管理系統(tǒng)Java GUI 實(shí)現(xiàn)先想清楚它到底在練什么如果你搜到這個(gè)標(biāo)題多半是期末項(xiàng)目、課程設(shè)計(jì)或者簡(jiǎn)歷上缺一個(gè)“拿得出手”的桌面應(yīng)用。圖書(shū)管理系統(tǒng)用 Java GUI 實(shí)現(xiàn)幾乎是所有 Java 學(xué)習(xí)路線里繞不開(kāi)的題——但很多人做完只得到一個(gè)“能跑”的評(píng)價(jià)面試一問(wèn)封裝和布局就卡殼。這個(gè)題的核心不是“圖書(shū)增刪改查”那幾張表而是把 Swing/AWT 的界面事件、業(yè)務(wù)邏輯、數(shù)據(jù)存取三層拆開(kāi)讓你理解桌面應(yīng)用的真實(shí)結(jié)構(gòu)。適合兩類(lèi)人一是正在做課程設(shè)計(jì)、需要穩(wěn)過(guò)答辯的學(xué)生二是想通過(guò)一個(gè)完整項(xiàng)目把 Java 基礎(chǔ)、集合框架、文件 IO 或 JDBC 串起來(lái)的自學(xué)者。這篇筆記按我實(shí)際帶人做項(xiàng)目的習(xí)慣來(lái)講不貼完整源碼把架構(gòu)、關(guān)鍵代碼、參數(shù)取舍和坑講透你照著搭骨架往里填自己的需求即可。2. 界面層怎么搭從布局選型到事件監(jiān)聽(tīng)的落地套路2.1 為什么大部分人的 GUI 代碼一坨事件監(jiān)聽(tīng)和業(yè)務(wù)邏輯混在了一起不管用 Swing 還是 AWT最常見(jiàn)的翻車(chē)就是把按鈕點(diǎn)擊事件里直接寫(xiě)Connection、PreparedStatement界面卡死不說(shuō)后期想改成 MySQL 或者文件存儲(chǔ)得把整個(gè)類(lèi)重寫(xiě)。界面層只該做兩件事擺放組件、把用戶(hù)動(dòng)作轉(zhuǎn)換成對(duì)業(yè)務(wù)層的調(diào)用。我一般會(huì)先在紙上畫(huà)出界面草圖標(biāo)注每個(gè)按鈕對(duì)應(yīng)哪個(gè)業(yè)務(wù)動(dòng)作再動(dòng)手寫(xiě)代碼。這樣后面無(wú)論換界面皮膚還是換數(shù)據(jù)庫(kù)都不用動(dòng)業(yè)務(wù)邏輯。一個(gè)可復(fù)現(xiàn)的拆分方式是界面類(lèi)只持有業(yè)務(wù)對(duì)象的引用按鈕事件里只調(diào)用業(yè)務(wù)方法返回值更新到表格或文本域。這樣每個(gè)類(lèi)的職責(zé)清晰答辯時(shí)也容易講。Swing 是單線程模型所有 UI 更新必須在事件分發(fā)線程EDT上執(zhí)行這也是后面講并發(fā)時(shí)要重點(diǎn)處理的點(diǎn)。先把這一層做對(duì)后面的數(shù)據(jù)層和業(yè)務(wù)層才能站穩(wěn)。2.2 布局管理器的選型邊界布局還是網(wǎng)格布局圖書(shū)管理系統(tǒng)的界面無(wú)外乎頂部搜索欄、中間表格、右側(cè)操作按鈕、底部狀態(tài)欄。我建議用BorderLayout做主布局North 放搜索和操作按鈕Center 放JTableSouth 放狀態(tài)提示。左側(cè)如果需要分類(lèi)樹(shù)或借閱面板再加一個(gè) West。這樣窗口縮放時(shí)表格區(qū)域能自動(dòng)拉伸不會(huì)出現(xiàn)按鈕擠成一團(tuán)。JFrame frame new JFrame(圖書(shū)管理系統(tǒng)); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setSize(1000, 700); frame.setLocationRelativeTo(null); JPanel topPanel new JPanel(new FlowLayout(FlowLayout.LEFT, 10, 10)); topPanel.add(new JLabel(書(shū)名)); JTextField searchField new JTextField(15); topPanel.add(searchField); JButton searchBtn new JButton(搜索); topPanel.add(searchBtn); JButton addBtn new JButton(新增); topPanel.add(addBtn); JTable table new JTable(); JScrollPane scrollPane new JScrollPane(table); JPanel bottomPanel new JPanel(new FlowLayout(FlowLayout.RIGHT)); JLabel statusLabel new JLabel(共 0 條記錄); bottomPanel.add(statusLabel); frame.add(topPanel, BorderLayout.NORTH); frame.add(scrollPane, BorderLayout.CENTER); frame.add(bottomPanel, BorderLayout.SOUTH); frame.setVisible(true);BorderLayout的五個(gè)區(qū)域里Center 會(huì)優(yōu)先獲得剩余空間所以表格放這里最合適。FlowLayout 用于工具條和狀態(tài)欄可以避免按鈕自動(dòng)拉伸變形。如果你的搜索欄和按鈕比較多可以換成GridBagLayout但新手不建議一上來(lái)就用調(diào)試成本高。有人會(huì)用null布局然后絕對(duì)定位不推薦——窗口一縮放組件就亂跑高分屏下更是災(zāi)難。表格部分有兩個(gè)關(guān)鍵點(diǎn)一是JTable默認(rèn)不可滾動(dòng)必須包在JScrollPane里二是默認(rèn)編輯器對(duì)雙擊修改支持不友好如果你不想讓用戶(hù)直接改表格重寫(xiě)isCellEditable返回false。搜索框的事件要注意按回車(chē)觸發(fā)搜索和點(diǎn)按鈕觸發(fā)搜索是兩種習(xí)慣我一般兩個(gè)都綁綁同一個(gè)方法省得用戶(hù)抱怨“按回車(chē)沒(méi)反應(yīng)”。2.3 Swing 事件監(jiān)聽(tīng)的三種寫(xiě)法與選擇事件監(jiān)聽(tīng)有匿名內(nèi)部類(lèi)、lambda、實(shí)現(xiàn)ActionListener接口三種常見(jiàn)寫(xiě)法。匿名內(nèi)部類(lèi)最啰嗦但最直觀適合新手理解“監(jiān)聽(tīng)器是被動(dòng)回調(diào)”這個(gè)模型lambda 簡(jiǎn)潔適合寫(xiě)工具按鈕實(shí)現(xiàn)接口適合一個(gè)監(jiān)聽(tīng)器處理多個(gè)控件——通過(guò)e.getSource()判斷點(diǎn)擊來(lái)源。我建議代碼里混合用但每個(gè)類(lèi)只保留一種風(fēng)格別有的按鈕 lambda 有的按鈕匿名類(lèi)維護(hù)起來(lái)精神污染。// lambda 寫(xiě)法適合簡(jiǎn)單動(dòng)作 searchBtn.addActionListener(e - doSearch(searchField.getText().trim())); // 傳統(tǒng)寫(xiě)法適合復(fù)用同一邏輯 addBtn.addActionListener(this::handleAdd); deleteBtn.addActionListener(this::handleDelete);addBtn.addActionListener(this::handleAdd)是用方法引用把兩個(gè)按鈕的點(diǎn)擊事件指向同一個(gè)處理方法。如果你的“新增”和“編輯”彈同一個(gè)對(duì)話框這種寫(xiě)法能省不少重復(fù)代碼。事件處理的命名也有規(guī)矩doSearch、handleDelete一看就知道是事件響應(yīng)方法不要用btn1Click這種寫(xiě)給自己看的名字。這一點(diǎn)在答辯時(shí)很加分代碼結(jié)構(gòu)多是老師最看重的東西。3. 數(shù)據(jù)層設(shè)計(jì)從文件存儲(chǔ)到 JDBC 的取舍3.1 文件存儲(chǔ)還是數(shù)據(jù)庫(kù)小項(xiàng)目也有大講究很多課程設(shè)計(jì)要求里沒(méi)寫(xiě)死必須用數(shù)據(jù)庫(kù)這時(shí)候就有選擇空間。我見(jiàn)過(guò)有人用 ArrayList 硬扛程序一關(guān)數(shù)據(jù)全沒(méi)這不行有人用 TXT 文件按逗號(hào)分隔存簡(jiǎn)單但查詢(xún)和修改要遍歷全文有人用對(duì)象序列化存ListBook讀起來(lái)方便但文件結(jié)構(gòu)不透明。我的建議是如果你的課程設(shè)計(jì)只要求“能跑”用序列化或 CSV 都行如果要求“貼近真實(shí)系統(tǒng)”直接上 SQLite 或 MySQL。用 SQLite 不需要單獨(dú)裝服務(wù)驅(qū)動(dòng)一個(gè) jar 包就夠非常適合單機(jī)桌面程序。// 用對(duì)象序列化保存圖書(shū)列表代碼量最少 public class BookStore { private ListBook books new ArrayList(); public void save(String path) throws IOException { try (ObjectOutputStream out new ObjectOutputStream( new FileOutputStream(path))) { out.writeObject(books); } } SuppressWarnings(unchecked) public void load(String path) throws IOException, ClassNotFoundException { try (ObjectInputStream in new ObjectInputStream( new FileInputStream(path))) { books (ListBook) in.readObject(); } } }序列化的好處是Book類(lèi)實(shí)現(xiàn)了Serializable就能整存整取三行代碼搞定持久化。缺點(diǎn)是文件是二進(jìn)制的不能用文本編輯器直接看出了問(wèn)題難排查。ObjectInputStream讀取時(shí)返回的是Object必須強(qiáng)轉(zhuǎn)回ListBook這個(gè)轉(zhuǎn)換失敗通常會(huì)拋ClassNotFoundException——如果你改了Book類(lèi)的包名或字段舊文件就讀不出來(lái)了。這是序列化的經(jīng)典坑改一次模型類(lèi)老數(shù)據(jù)全廢。如果你選 JDBC 連 MySQL要注意驅(qū)動(dòng)版本和 Java 版本匹配。新版驅(qū)動(dòng)類(lèi)名是com.mysql.cj.jdbc.Driver老的是com.mysql.jdbc.Driver這個(gè)坑不踩一遍真的記不住。連接串里建議加上useSSLfalseserverTimezoneAsia/Shanghai否則 MySQL 8 以上會(huì)在連接時(shí)報(bào)時(shí)區(qū)錯(cuò)誤。SQLite 相對(duì)省心連接串就是jdbc:sqlite:books.db——不用配賬號(hào)密碼本地文件即數(shù)據(jù)庫(kù)特別適合桌面單機(jī)軟件。3.2 圖書(shū)實(shí)體類(lèi)的字段設(shè)計(jì)與校驗(yàn)別等到寫(xiě) SQL 才后悔實(shí)體類(lèi)的字段決定表格列、表單輸入項(xiàng)和 SQL 語(yǔ)句的映射關(guān)系。圖書(shū)常見(jiàn)的字段id主鍵、title書(shū)名、author作者、publisher出版社、isbnISBN 號(hào)、price價(jià)格、stock庫(kù)存、category分類(lèi)。其中 ISBN 適合用 String 而不是 long——ISBN 可能以 0 開(kāi)頭數(shù)值類(lèi)型會(huì)丟前導(dǎo)零。價(jià)格用BigDecimal而不是 doubledouble 的浮點(diǎn)誤差在金額計(jì)算上會(huì)翻車(chē)0.1 0.2 會(huì)得出 0.30000000000000004教訓(xùn)太深刻了。public class Book { private int id; private String title; private String author; private String publisher; private String isbn; private BigDecimal price; private int stock; private String category; public Book(String title, String author, String isbn, BigDecimal price, int stock) { this.title title; this.author author; this.isbn isbn; this.price price; this.stock stock; } // getter / setter 省略 }字段校驗(yàn)應(yīng)該放在 setter 里不要等寫(xiě)到數(shù)據(jù)庫(kù)層才發(fā)現(xiàn)空指針或格式不對(duì)。比如setStock(int stock)里if (stock 0) throw new IllegalArgumentException(庫(kù)存不能為負(fù)數(shù))這樣任何非法數(shù)據(jù)在源頭就被攔下。有人在表單層校驗(yàn)有人寫(xiě)在數(shù)據(jù)庫(kù)層但從工程角度講實(shí)體類(lèi)做基本校驗(yàn)、業(yè)務(wù)層做流程校驗(yàn)、數(shù)據(jù)庫(kù)層做約束校驗(yàn)三層各管一段寧可冗余也別漏。答辯時(shí)老師喜歡問(wèn)“你這數(shù)據(jù)哪里校驗(yàn)的”三層校驗(yàn)方案能講出東西。3.3 數(shù)據(jù)訪問(wèn)層DAO 模式的實(shí)現(xiàn)與參數(shù)化查詢(xún)數(shù)據(jù)訪問(wèn)層DAO的核心價(jià)值是業(yè)務(wù)層只面對(duì)接口不關(guān)心數(shù)據(jù)是存在 MySQL 還是序列化文件。如果你一開(kāi)始用 ArrayList后面要換 MySQL只要新寫(xiě)一個(gè)實(shí)現(xiàn)類(lèi)替換掉原來(lái)那個(gè)就可以。接口定義什么樣的方法常見(jiàn)的就六個(gè)addBook、deleteBook、updateBook、findById、findByKeyword、getAllBooks。public interface BookDao { ListBook getAllBooks(); Book findById(int id); ListBook findByKeyword(String keyword); void addBook(Book book) throws SQLException; void updateBook(Book book) throws SQLException; void deleteBook(int id) throws SQLException; }接口先定義好再分別寫(xiě)FileBookDao和MySqlBookDao。這樣代碼結(jié)構(gòu)給老師看的時(shí)候能講兩層優(yōu)勢(shì)一是業(yè)務(wù)層不依賴(lài)具體存儲(chǔ)實(shí)現(xiàn)二是測(cè)試時(shí)可以注入假的 DAO不用連真數(shù)據(jù)庫(kù)。SQL 查詢(xún)里有一個(gè)鐵律永遠(yuǎn)別用字符串拼接 SQL要用PreparedStatement參數(shù)化查詢(xún)。原因不只是防止 SQL 注入還因?yàn)槠唇痈牟涣颂厥庾址獣?shū)名里有個(gè)單引號(hào)你的 SQL 直接語(yǔ)法錯(cuò)誤。public ListBook findByKeyword(String keyword) throws SQLException { String sql SELECT * FROM book WHERE title LIKE ? OR author LIKE ?; try (Connection conn getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, % keyword %); ps.setString(2, % keyword %); try (ResultSet rs ps.executeQuery()) { ListBook books new ArrayList(); while (rs.next()) { books.add(mapRowToBook(rs)); } return books; } } }LIKE ?配合ps.setString(1, % keyword %)是模糊查詢(xún)的標(biāo)準(zhǔn)寫(xiě)法通配符作為參數(shù)傳入而不是拼進(jìn) SQL既安全又能讓數(shù)據(jù)庫(kù)復(fù)用執(zhí)行計(jì)劃。try-with-resources寫(xiě)法確保 Connection、PreparedStatement、ResultSet 都會(huì)自動(dòng)關(guān)閉這是 Java 7 之后的最佳實(shí)踐。注意一個(gè)細(xì)節(jié)LIKE 查詢(xún)里如果 keyword 本身帶%或_會(huì)被當(dāng)成通配符處理需要轉(zhuǎn)義。這個(gè)邊界情況很多人不知道測(cè)試時(shí)永遠(yuǎn)搜不到帶下劃線的書(shū)名。要么在業(yè)務(wù)層過(guò)濾特殊字符要么用ESCAPE子句我一般選擇前者——用戶(hù)輸入_時(shí)自動(dòng)替換成\_再傳入。4. 三層架構(gòu)串聯(lián)從界面到數(shù)據(jù)的一整條調(diào)用鏈4.1 業(yè)務(wù)層到底該干哪些活事務(wù)、校驗(yàn)、組裝業(yè)務(wù)層夾在界面和數(shù)據(jù)層中間很多人不知道怎么填。它不該只是轉(zhuǎn)手調(diào)用 DAO——如果那樣三層架構(gòu)就是三層空殼。業(yè)務(wù)層該處理組合校驗(yàn)比如新增圖書(shū)時(shí) ISBN 不能和已有重復(fù)、事務(wù)邊界借書(shū)操作里要先減庫(kù)存再插入借閱記錄兩步要么都成功要么都回滾、業(yè)務(wù)規(guī)則庫(kù)存不足不能借出。這些邏輯放界面層會(huì)讓代碼亂成一鍋粥放數(shù)據(jù)層會(huì)讓 SQL 和業(yè)務(wù)耦合只有業(yè)務(wù)層是正確位置。public class BookService { private BookDao bookDao; public BookService(BookDao bookDao) { this.bookDao bookDao; } public boolean addBook(Book book) { ListBook exists bookDao.findByKeyword(book.getIsbn()); if (!exists.isEmpty()) { return false; // ISBN 重復(fù)業(yè)務(wù)規(guī)則拒絕 } try { bookDao.addBook(book); return true; } catch (SQLException e) { return false; } } }BookService構(gòu)造時(shí)注入BookDao接口不直接 new 具體實(shí)現(xiàn)。這就是控制反轉(zhuǎn)代碼里只有“依賴(lài)接口”這一個(gè)約定以后測(cè)試也好、換實(shí)現(xiàn)也好都先改這里。業(yè)務(wù)方法返回布爾值而不是拋異常是為了讓界面層好判斷返回true彈“新增成功”返回false彈“ISBN 重復(fù)”。如果改成往里拋SQLException界面層會(huì)變成一堆 try-catch——難看但不是不能用看你項(xiàng)目規(guī)模。我自己做小項(xiàng)目時(shí)也常直接用 boolean 返回簡(jiǎn)單直接缺點(diǎn)是錯(cuò)誤原因只有一個(gè)布爾值用戶(hù)不知道到底錯(cuò)在哪。要么返回一個(gè)自定義結(jié)果對(duì)象要么異常和布爾值混用看具體場(chǎng)景但別一個(gè)項(xiàng)目里兩種風(fēng)格都來(lái)。4.2 從按鈕到數(shù)據(jù)庫(kù)的完整鏈路一次新增操作走全程為了讓你真正看明白三層怎么協(xié)作我把“新增圖書(shū)”的完整調(diào)用鏈拆開(kāi)講。用戶(hù)填完表單點(diǎn)“保存”界面層拿到輸入值構(gòu)造一個(gè)Book對(duì)象調(diào)用bookService.addBook(book)業(yè)務(wù)層先做重復(fù)校驗(yàn)再調(diào)用bookDao.addBook(book)數(shù)據(jù)層組裝INSERTSQL執(zhí)行后返回。界面層根據(jù)返回值決定彈什么提示同時(shí)刷新表格數(shù)據(jù)。這條鏈路看起來(lái)簡(jiǎn)單但很多人的代碼里少了最后一步“刷新表格”——新增了書(shū)界面上沒(méi)變化用戶(hù)以為沒(méi)存上又點(diǎn)了一次新增結(jié)果存了兩條。我習(xí)慣讓表格刷新成為一個(gè)獨(dú)立方法任何增刪改操作后都調(diào)用它。// 界面層新增按鈕事件 private void handleAdd() { String title titleField.getText().trim(); String author authorField.getText().trim(); String isbn isbnField.getText().trim(); if (title.isEmpty() || author.isEmpty()) { statusLabel.setText(書(shū)名為空或作者為空); return; } Book book new Book(title, author, isbn, new BigDecimal(priceField.getText().trim()), Integer.parseInt(stockField.getText().trim())); boolean ok bookService.addBook(book); if (ok) { refreshTable(); // 關(guān)鍵操作后刷新 statusLabel.setText(新增成功); } else { statusLabel.setText(新增失敗ISBN 可能重復(fù)); } }界面層先做“空值校驗(yàn)”再進(jìn)入業(yè)務(wù)層是為了減少不必要的調(diào)用——空字符串傳給BigDecimal構(gòu)造會(huì)直接拋NumberFormatException根本到不了業(yè)務(wù)層。這里有個(gè)細(xì)節(jié)TextField.getText()不會(huì)自動(dòng)去空格用戶(hù)敲個(gè)空格就通過(guò)非空校驗(yàn)了所以trim()必須加。價(jià)格和庫(kù)存的轉(zhuǎn)型異常我故意沒(méi)在這里處理真實(shí)項(xiàng)目里要包裹 try-catch 彈提示不然用戶(hù)輸入“abc”點(diǎn)新增程序直接崩潰。這也是新手最常見(jiàn)的翻車(chē)點(diǎn)之一。4.3 表格模型DefaultTableModel 的正確用法JTable 的setModel方法很多人亂來(lái)每次刷新數(shù)據(jù)直接new DefaultTableModel(...)但這樣會(huì)丟掉列寬設(shè)置。更規(guī)范的做法是初始化時(shí)創(chuàng)建表模型設(shè)置列名刷新時(shí)清空行數(shù)據(jù)再重新添加。DefaultTableModel的setRowCount(0)是清空所有行的標(biāo)準(zhǔn)方法然后循環(huán)addRow。有人用Vector往里傳建議用Object[]或List加addRow()就行。private DefaultTableModel tableModel; private JTable table; private String[] columns {ID, 書(shū)名, 作者, 出版社, ISBN, 價(jià)格, 庫(kù)存}; private void initTable() { tableModel new DefaultTableModel(columns, 0); // 0 行、指定列名 table new JTable(tableModel); table.getColumnModel().getColumn(0).setPreferredWidth(50); table.getColumnModel().getColumn(1).setPreferredWidth(180); // 禁止直接編輯單元格 tableModel new DefaultTableModel(columns, 0) { Override public boolean isCellEditable(int row, int column) { return false; } }; } private void refreshTable() { tableModel.setRowCount(0); for (Book b : bookService.getAllBooks()) { tableModel.addRow(new Object[]{ b.getId(), b.getTitle(), b.getAuthor(), b.getPublisher(), b.getIsbn(), b.getPrice(), b.getStock() }); } }new DefaultTableModel(columns, 0)的第二個(gè)參數(shù)是初始行數(shù)傳 0 表示空表之后全靠addRow填充。覆蓋isCellEditable返回false用戶(hù)雙擊單元格就不會(huì)進(jìn)入編輯狀態(tài)——這個(gè)不加的話表格看起來(lái)能改但改完不落到數(shù)據(jù)庫(kù)特別容易讓用戶(hù)誤操作。價(jià)格列如果想右對(duì)齊顯示可以在 TableCellRenderer 里用SwingConstants.RIGHT不過(guò)小項(xiàng)目可以不做。刷新表格時(shí)每次addRow會(huì)觸發(fā)重繪幾百條數(shù)據(jù)沒(méi)問(wèn)題數(shù)據(jù)過(guò)萬(wàn)就該考慮分頁(yè)了這個(gè)問(wèn)題后面講。5. 借閱流程與并發(fā)除了增刪改查你還能多做什么5.1 借書(shū)還書(shū)的狀態(tài)設(shè)計(jì)別只用布爾值圖書(shū)管理系統(tǒng)的核心業(yè)務(wù)不只是“增刪改查”借書(shū)還書(shū)才是體現(xiàn)設(shè)計(jì)能力的地方。最簡(jiǎn)單做法是給圖書(shū)加一個(gè)borrowed布爾字段但這不夠——你沒(méi)法記錄“誰(shuí)借的、什么時(shí)候借的”。稍微好一點(diǎn)的是建一張獨(dú)立借閱表字段包括借閱 ID、圖書(shū) ID、讀者 ID、借出時(shí)間、歸還時(shí)間。這樣從“圖書(shū)”和“借閱人”兩個(gè)維度都能查到歷史記錄。public class BorrowRecord { private int id; private int bookId; private String readerId; private LocalDateTime borrowTime; private LocalDateTime returnTime; private boolean returned; // getter / setter 省略 }LocalDateTime是 Java 8 之后處理時(shí)間的標(biāo)準(zhǔn)類(lèi)比Date強(qiáng)太多格式轉(zhuǎn)換簡(jiǎn)單、線程安全、有完善的加減和比較方法。存數(shù)據(jù)庫(kù)時(shí)用Timestamp.valueOf(LocalDateTime)轉(zhuǎn)換取出時(shí)用toLocalDateTime()。有些教材還在教SimpleDateFormatjava.util.Date能做但代碼繞。歸還時(shí)間returnTime允許為 null表示未歸還——這個(gè)“null 有語(yǔ)義”的設(shè)計(jì)在數(shù)據(jù)庫(kù)里要小心查詢(xún)“當(dāng)前借出的記錄”要寫(xiě)WHERE return_time IS NULL等你寫(xiě)多了 SQL 自然就懂了。5.2 多窗口協(xié)作主界面和借閱對(duì)話框的傳參方式借書(shū)操作通常彈一個(gè)子窗口選擇讀者、顯示圖書(shū)信息、確認(rèn)借出。這里有兩種做法一是JOptionPane簡(jiǎn)單輸入框二是自定義JDialog。自定義對(duì)話框麻煩一點(diǎn)但專(zhuān)業(yè)子窗口通過(guò)構(gòu)造函數(shù)接收父窗口傳入的數(shù)據(jù)點(diǎn)擊“確認(rèn)”后把用戶(hù)選擇的結(jié)果通過(guò)回調(diào)或返回值傳給主窗口。public class BorrowDialog extends JDialog { private boolean confirmed false; private String selectedReaderId; private Book targetBook; public BorrowDialog(Frame owner, Book book) { super(owner, 借閱登記, true); // 模態(tài)對(duì)話框 this.targetBook book; // 初始化組件省略 confirmBtn.addActionListener(e - { this.selectedReaderId readerIdField.getText().trim(); this.confirmed true; dispose(); }); } public boolean isConfirmed() { return confirmed; } public String getSelectedReaderId() { return selectedReaderId; } }超類(lèi)構(gòu)造的true是模態(tài)子窗口彈出時(shí)父窗口不可操作強(qiáng)迫用戶(hù)先處理完再回來(lái)。dispose()只關(guān)閉當(dāng)前窗口不會(huì)結(jié)束程序——如果是System.exit(0)會(huì)把整個(gè) JVM 殺了。主界面使用這個(gè)對(duì)話框的流程是BorrowDialog dlg new BorrowDialog(frame, book); dlg.setVisible(true);然后判斷dlg.isConfirmed()。這個(gè)寫(xiě)法把“用戶(hù)有沒(méi)有點(diǎn)確認(rèn)”和“確認(rèn)后帶什么數(shù)據(jù)回來(lái)”封裝好了主界面不用直接訪問(wèn)子窗口的內(nèi)部組件是窗口傳參的規(guī)范套路。有個(gè)細(xì)節(jié)提醒setVisible(true)會(huì)阻塞因?yàn)槟B(tài)所以isConfirmed()的調(diào)用要放在setVisible之后順序錯(cuò)了拿不到結(jié)果。5.3 多線程與 Swing 的恩怨SwingWorker 的正確打開(kāi)方式界面卡死是桌面應(yīng)用最常見(jiàn)的敗筆。比如從文件加載數(shù)據(jù)、批量導(dǎo)入圖書(shū)如果直接在主線程里做窗口會(huì)變成“未響應(yīng)”用戶(hù)以為程序崩了。Swing 是單線程模型所有 UI 更新必須在 EDT事件分發(fā)線程上執(zhí)行耗時(shí)的數(shù)據(jù)操作要放后臺(tái)線程。問(wèn)題在于后臺(tái)線程不能直接操作 UI 組件否則會(huì)出并發(fā)問(wèn)題。Java 官方給的方案是SwingWorkerV, T。class LoadDataWorker extends SwingWorkerListBook, Object { private final BookService service; private final JTable table; private final DefaultTableModel model; private final JLabel status; LoadDataWorker(BookService service, JTable table, DefaultTableModel model, JLabel status) { this.service service; this.table table; this.model model; this.status status; } Override protected ListBook doInBackground() throws Exception { return service.getAllBooks(); // 后臺(tái)線程執(zhí)行不卡界面 } Override protected void done() { try { ListBook books get(); // 回到 EDT可以安全更新 UI model.setRowCount(0); for (Book b : books) { model.addRow(new Object[] { ... }); } status.setText(加載完成共 books.size() 條); } catch (Exception e) { status.setText(加載失敗 e.getMessage()); } } }doInBackground里跑耗時(shí)邏輯done回到 EDT 更新 UI這是 SwingWorker 最標(biāo)準(zhǔn)的分工。get()方法會(huì)拋出ExecutionException包裝的是后臺(tái)線程拋出的真實(shí)異?!?catch 的話程序可能直接崩。這段代碼在答辯時(shí)拿出來(lái)講老師基本就知道你會(huì)處理并發(fā)問(wèn)題了。很多人的借閱系統(tǒng)一打開(kāi)就加載全量數(shù)據(jù)數(shù)據(jù)量大時(shí)界面空白好幾秒。一個(gè)更好的做法是先加載前 100 條用戶(hù)滾動(dòng)到末尾再觸發(fā)加載——不過(guò)這是進(jìn)階優(yōu)化小項(xiàng)目能從 SwingWorker 畢業(yè)已經(jīng)很扎實(shí)。另外如果你用 lambda 里寫(xiě)new SwingWorker注意變量捕獲局部變量要final或 effectively final不然編譯直接報(bào)錯(cuò)。這是個(gè)能卡十分鐘的編譯錯(cuò)誤先跟你預(yù)告。6. 圖書(shū)管理系統(tǒng)避坑指南3 個(gè)必踩的坑和修復(fù)方案6.1 現(xiàn)象窗口關(guān)閉后程序還在后臺(tái)跑點(diǎn)窗口右上角的 X窗口消失了但 Java 進(jìn)程還留在任務(wù)管理器里。對(duì)于有經(jīng)驗(yàn)的人一眼就懂但新手真的會(huì)以為代碼沒(méi)問(wèn)題。原因JFrame默認(rèn)的關(guān)閉行為是HIDE_ON_CLOSE它只是隱藏窗口而不退出 JVM。解決在你創(chuàng)建 JFrame 后設(shè)置關(guān)閉行為。正確做法是frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE)它會(huì)退出整個(gè)應(yīng)用。但注意如果你的程序里還有非守護(hù)線程比如某個(gè)后臺(tái)任務(wù)線程沒(méi)關(guān)干凈EXIT_ON_CLOSE也未必能強(qiáng)制退出——JVM 會(huì)在所有非守護(hù)線程結(jié)束時(shí)才退出。另一種情況如果你后續(xù)要加“自動(dòng)保存”功能可以考慮DO_NOTHING_ON_CLOSE然后在窗口事件里先保存再dispose()或System.exit(0)這樣更安全。但課程設(shè)計(jì)不用想太深直接EXIT_ON_CLOSE完事。血淚經(jīng)驗(yàn)很多人的程序出現(xiàn)“關(guān)不掉”其實(shí)是某個(gè)Timer沒(méi)停窗口關(guān)了但定時(shí)器還活著。如果你用了javax.swing.Timer記得在窗口關(guān)閉事件里stop()。6.2 現(xiàn)象新增的圖書(shū)記錄重啟程序后就消失了圖書(shū)列表運(yùn)行期一切正常重啟后數(shù)據(jù)全部丟失。原因數(shù)據(jù)只存在內(nèi)存的ArrayList里沒(méi)有任何持久化機(jī)制。這不是 bug而是壓根沒(méi)做存儲(chǔ)。如果你是用文件存儲(chǔ)的方案可能路徑寫(xiě)錯(cuò)了——new File(books.txt)是相對(duì)路徑依賴(lài)于“當(dāng)前工作目錄”而這個(gè)目錄在 IDE 和命令行下不一樣。解決不要在代碼里寫(xiě)死相對(duì)路徑。更好的方案是用System.getProperty(user.home)拼一個(gè)絕對(duì)路徑比如new File(System.getProperty(user.home), LibrarySystem/books.dat)確保文件不會(huì)丟在某個(gè)奇怪的臨時(shí)目錄里。如果你用序列化存儲(chǔ)還要注意另一個(gè)坑Book類(lèi)加上新字段后老文件讀取會(huì)拋InvalidClassException——這是序列化版本不一致導(dǎo)致的。解決在Book類(lèi)里顯式聲明private static final long serialVersionUID 1L;并在代碼里做兼容處理。如果你用 JDBC 連 MySQL重啟后丟失的原因大概率是CREATE DATABASE IF NOT EXISTS沒(méi)寫(xiě)在啟動(dòng)邏輯里或者連接串寫(xiě)到了內(nèi)存庫(kù)jdbc:mysql://localhost:3306/卻沒(méi)指定具體庫(kù)名——前者是連錯(cuò)庫(kù)后者是每次重啟建臨時(shí)表。寫(xiě)一個(gè)DatabaseInitializer類(lèi)啟動(dòng)時(shí)檢查表是否存在不存在就建表這是所有選項(xiàng)里最省心的。6.3 現(xiàn)象搜索框輸入中文后按鈕沒(méi)反應(yīng)界面里點(diǎn)“搜索”按鈕點(diǎn)擊后無(wú)任何反饋控制臺(tái)也不報(bào)錯(cuò)而且在英文輸入下一切正常。這個(gè)現(xiàn)象的坑不在 Java而在輸入法。中文輸入狀態(tài)下用戶(hù)敲出的字符會(huì)先進(jìn)入輸入法候選框此時(shí)按回車(chē)會(huì)觸發(fā)輸入法“確認(rèn)”而不是觸發(fā)按鈕的ActionEvent。所以出現(xiàn)中文輸入法下“搜索按鈕敲回車(chē)沒(méi)反應(yīng)”或者“按了回車(chē)卻打了兩個(gè)字”。解決如果你要在搜索框里支持回車(chē)觸發(fā)搜索建議綁定鍵盤(pán)事件而不是只依賴(lài)按鈕的 ActionEvent或者把搜索框的輸入提交時(shí)機(jī)改用DocumentListener實(shí)時(shí)監(jiān)聽(tīng)內(nèi)容變化——但這樣每次敲一個(gè)字母都會(huì)觸發(fā)一次搜索太頻繁。我的做法是搜索按鈕用傳統(tǒng)ActionListener同時(shí)給搜索框加KeyListener監(jiān)聽(tīng)回車(chē)鍵——注意是keyPressed里判斷KeyEvent.VK_ENTER無(wú)論輸入法是否確認(rèn)都會(huì)觸發(fā)。但加了 KeyListener 之后中文輸入法在候選框時(shí)回車(chē)也可能觸發(fā)——所以真實(shí)經(jīng)驗(yàn)是既有“按鈕點(diǎn)擊”也有“焦點(diǎn)在搜索框時(shí)按回車(chē)觸發(fā)”兩者綁定的是同一個(gè)方法只要不是大數(shù)據(jù)量全表掃描觸發(fā)多一兩次無(wú)所謂。這個(gè)坑的精髓就是永遠(yuǎn)別只綁定一種觸發(fā)方式三種都綁上懶和笨的交互方式兼容。另一個(gè)相關(guān)的小坑是TextField的getText()返回的字符串可能是全角空格或中文標(biāo)點(diǎn)導(dǎo)致LIKE查詢(xún)搜不到預(yù)期結(jié)果——所以數(shù)據(jù)寫(xiě)入時(shí)一定要trim()如果還是不行就去看數(shù)據(jù)庫(kù)里真實(shí)的字符值。這個(gè)對(duì)比太常見(jiàn)了望周知。7. 可用性進(jìn)階三個(gè)讓系統(tǒng)“像那么回事”的細(xì)節(jié)打磨7.1 鍵盤(pán)操作完整支持桌面軟件做到“鼠標(biāo)能點(diǎn)、鍵盤(pán)能走”才算半個(gè)合格品??旖萱I三件套全局菜單用JMenuBar 菜單項(xiàng)快捷鍵按鈕用setMnemonic比如“新增”設(shè)成VK_N按下 AltN 觸發(fā)按鈕默認(rèn)響應(yīng)回車(chē)用JRootPane.setDefaultButton(addBtn)。這些改動(dòng)加起來(lái)不到十行代碼但演示時(shí)給人的感覺(jué)完全不一樣——評(píng)委用鍵盤(pán)操作比鼠標(biāo)點(diǎn)來(lái)點(diǎn)去專(zhuān)業(yè)得多。同時(shí)建議給表格加雙擊事件雙擊行觸發(fā)“查看詳情”或“編輯”符合主流表格軟件的習(xí)慣。實(shí)現(xiàn)是在表格上注冊(cè)MouseAdapter在mouseClicked里用table.getSelectedRow()拿當(dāng)前行。注意區(qū)分單擊點(diǎn)選和雙擊確認(rèn)——雙擊時(shí)會(huì)先觸發(fā)兩次單擊事件如果你在單擊里做了事比如選中刷新?tīng)顟B(tài)欄雙擊后會(huì)有輕微閃爍。處理方式是判斷e.getClickCount() 2時(shí)只做詳情操作不做選中操作。這個(gè)細(xì)節(jié)很多人不處理但演示時(shí)體驗(yàn)差異很明顯。7.2 CardLayout 做多視圖切換很多人做“管理員視圖 / 讀者視圖”或“模塊切換”時(shí)用removeAll()再加新面板這樣不僅閃爍還會(huì)丟布局狀態(tài)。更優(yōu)雅的解決方案是CardLayout預(yù)先裝好多個(gè)面板切換時(shí)一條命令完成。典型場(chǎng)景左邊是導(dǎo)航列表右邊內(nèi)容區(qū)隨選擇切換“圖書(shū)管理”“借閱管理”“讀者管理”。JPanel cardPanel new JPanel(new CardLayout()); cardPanel.add(bookManagePanel, BOOK_MANAGE); cardPanel.add(borrowPanel, BORROW); cardPanel.add(readerPanel, READER); CardLayout cardLayout (CardLayout) cardPanel.getLayout(); navList.addListSelectionListener(e - { if (!e.getValueIsAdjusting()) { switch (navList.getSelectedIndex()) { case 0: cardLayout.show(cardPanel, BOOK_MANAGE); break; case 1: cardLayout.show(cardPanel, BORROW); break; case 2: cardLayout.show(cardPanel, READER); break; } } });CardLayout.show(container, name)是切換的核心name 是添加面板時(shí)給的字符串常量。getValueIsAdjusting()必須判斷——JList的選區(qū)變化事件會(huì)觸發(fā)兩次一次調(diào)整中一次調(diào)整完不判斷的話切換卡頓。這套寫(xiě)法避免了你手動(dòng)removeAll和重新add帶來(lái)的閃爍問(wèn)題而且每個(gè)面板只初始化一次內(nèi)部組件的狀態(tài)比如滾動(dòng)位置、選中行會(huì)保留體驗(yàn)好非常多。個(gè)人經(jīng)驗(yàn)?zāi)苡靡粋€(gè) CardLayout 搞定的導(dǎo)航就別用多個(gè)JFrame來(lái)回開(kāi)關(guān)后者一旦忘了dispose()就是內(nèi)存泄漏。7.3 分頁(yè)加載從“能跑”到“能扛”數(shù)據(jù)量突破幾千條后一次查全表 往DefaultTableModel里塞幾千行界面會(huì)明顯卡頓。這時(shí)候該上分頁(yè)了。SQL 層面用LIMIT ? OFFSET ?Swing 層面用一個(gè)簡(jiǎn)單的“上一頁(yè)/下一頁(yè)”按鈕組控制當(dāng)前頁(yè)碼。數(shù)據(jù)訪問(wèn)層需要兩個(gè)方法getBooksByPage(int page, int pageSize)返回當(dāng)前頁(yè)數(shù)據(jù)getTotalCount()返回總記錄數(shù)。業(yè)務(wù)層算總頁(yè)數(shù)(total pageSize - 1) / pageSize向上取整。界面層每次翻頁(yè)調(diào)用一次refreshTable只加載當(dāng)前頁(yè)的數(shù)據(jù)滾動(dòng)條快速響應(yīng)界面再也不會(huì)卡死。分頁(yè)的三個(gè)細(xì)節(jié)一是頁(yè)碼越界處理用戶(hù)快速連點(diǎn)時(shí)頁(yè)碼可能超出范圍二是排序字段要跟著分頁(yè)走ORDER BY id LIMIT ? OFFSET ?不排序的話分頁(yè)可能重復(fù)或有空洞三是OFFSET在數(shù)據(jù)量極大時(shí)性能會(huì)下降可以考慮用“上次看到的 ID”代替頁(yè)碼做游標(biāo)分頁(yè)——但小項(xiàng)目做到普通分頁(yè)就夠用了。有這層分頁(yè)處理答辯時(shí)直接回答“大數(shù)據(jù)量的性能優(yōu)化”這類(lèi)問(wèn)題就有料了。7.4 數(shù)據(jù)正確性檢查寫(xiě)一個(gè)小工具類(lèi)自測(cè)項(xiàng)目做完不代表可以交。我建議花半小時(shí)寫(xiě)一個(gè)DataChecker類(lèi)跑一遍自檢邏輯新增一條書(shū)查一下能不能按書(shū)名搜到改庫(kù)存看表格是否刷新刪一本書(shū)再看看借閱記錄里有沒(méi)有臟數(shù)據(jù)。這些看似瑣碎的驗(yàn)證其實(shí)就是在幫你提前踩掉那些“演示時(shí)評(píng)委恰好點(diǎn)到就翻車(chē)”的坑。從上到下跑完這個(gè)自檢清單你比那些寫(xiě)完就交的同學(xué)心里有底得多。下次再做桌面應(yīng)用記得先把“關(guān)閉行為、空值校驗(yàn)、刷新表格、時(shí)間格式”這四個(gè)老問(wèn)題直接寫(xiě)進(jìn)代碼模板這套東西省下來(lái)的調(diào)試時(shí)間足夠你再學(xué)完一個(gè)小框架。希望幫到你——如果按這篇的思路把資料捋順拿下一個(gè)課程設(shè)計(jì)的優(yōu)秀評(píng)級(jí)是綽綽有余的事。本文還有配套的精品資源點(diǎn)擊獲取