1. 項(xiàng)目概述與核心價(jià)值最近在整理過(guò)往的項(xiàng)目經(jīng)驗(yàn)發(fā)現(xiàn)一個(gè)挺有意思的現(xiàn)象很多計(jì)算機(jī)專(zhuān)業(yè)的學(xué)生或者剛?cè)胄械呐笥言谡n程設(shè)計(jì)或者接一些小型外包時(shí)常常會(huì)被“帶界面的教務(wù)管理系統(tǒng)”這類(lèi)題目難住。難點(diǎn)不在于業(yè)務(wù)邏輯本身而在于如何將Java、數(shù)據(jù)庫(kù)和圖形界面這三者順暢地串聯(lián)起來(lái)形成一個(gè)穩(wěn)定、可用的桌面應(yīng)用。我自己帶過(guò)不少實(shí)習(xí)生也看過(guò)很多課程設(shè)計(jì)的代碼發(fā)現(xiàn)大家容易在幾個(gè)地方卡殼數(shù)據(jù)庫(kù)連接池的管理、Swing界面的事件響應(yīng)與數(shù)據(jù)綁定、以及業(yè)務(wù)邏輯與界面展示的分離。這個(gè)項(xiàng)目看似基礎(chǔ)實(shí)則是一個(gè)檢驗(yàn)Java SE綜合能力的絕佳試金石它涵蓋了面向?qū)ο笤O(shè)計(jì)、JDBC操作、多線程Swing EDT、模塊化分層等核心知識(shí)點(diǎn)。一個(gè)完整的、帶數(shù)據(jù)庫(kù)的Java桌面教務(wù)管理系統(tǒng)絕不僅僅是“能跑通”就行。它的核心價(jià)值在于通過(guò)一個(gè)具體的業(yè)務(wù)場(chǎng)景學(xué)生、課程、成績(jī)、教師管理將Java桌面開(kāi)發(fā)中那些瑣碎但至關(guān)重要的技術(shù)點(diǎn)串聯(lián)起來(lái)形成一套可復(fù)用的工程實(shí)踐。比如如何設(shè)計(jì)一個(gè)健壯的數(shù)據(jù)庫(kù)訪問(wèn)層DAO來(lái)應(yīng)對(duì)各種CRUD操作如何在Swing的表格JTable中優(yōu)雅地展示和編輯從數(shù)據(jù)庫(kù)查詢(xún)出來(lái)的分頁(yè)數(shù)據(jù)又該如何處理用戶登錄、權(quán)限校驗(yàn)這類(lèi)通用功能把這些搞明白了以后無(wú)論是做進(jìn)銷(xiāo)存、客戶關(guān)系管理還是其他任何桌面應(yīng)用你都能快速上手。接下來(lái)我就結(jié)合自己多次重構(gòu)這類(lèi)系統(tǒng)的經(jīng)驗(yàn)從頭到尾拆解一遍重點(diǎn)會(huì)放在那些官方文檔不會(huì)細(xì)講但實(shí)際開(kāi)發(fā)中一定會(huì)遇到的“坑”和最佳實(shí)踐上。2. 技術(shù)棧選型與架構(gòu)設(shè)計(jì)思路2.1 為什么是Swing JDBC MySQL看到這個(gè)組合可能有人會(huì)問(wèn)現(xiàn)在不都流行Spring Boot Vue/React做前后端分離嗎為什么還要用“老掉牙”的Swing和純JDBC這里有兩個(gè)核心考量。第一教學(xué)與原型驗(yàn)證目的。對(duì)于學(xué)習(xí)Java SE和數(shù)據(jù)庫(kù)編程而言Swing和JDBC是最直接、最純粹的技術(shù)組合能讓你清晰地看到從界面點(diǎn)擊到SQL執(zhí)行再到結(jié)果渲染的完整鏈路沒(méi)有任何框架的“黑魔法”干擾。理解了這個(gè)底層過(guò)程未來(lái)學(xué)習(xí)MyBatis、Hibernate乃至Spring Data JPA才會(huì)知其所以然。第二輕量級(jí)桌面應(yīng)用的特定場(chǎng)景。對(duì)于一些內(nèi)部工具、離線操作軟件或者對(duì)安裝部署有極簡(jiǎn)要求的場(chǎng)合一個(gè)打包成可執(zhí)行JAR的Swing應(yīng)用用戶雙擊就能運(yùn)行無(wú)需安裝數(shù)據(jù)庫(kù)客戶端可使用嵌入式數(shù)據(jù)庫(kù)如H2或配置Web服務(wù)器有其不可替代的便利性。當(dāng)然純JDBC操作比較繁瑣所以我們通常會(huì)引入一些輕量級(jí)工具來(lái)提升效率。數(shù)據(jù)庫(kù)方面MySQL社區(qū)版免費(fèi)、普及率高是首選。為了簡(jiǎn)化JDBC編碼我會(huì)使用Apache Commons DbUtils這個(gè)小巧的庫(kù)它封裝了結(jié)果集處理能大大減少模板代碼。連接池則選擇HikariCP它是目前性能最好的JDBC連接池之一對(duì)于桌面應(yīng)用來(lái)說(shuō)也足夠輕量。界面構(gòu)建如果不想手寫(xiě)大量布局代碼可以用WindowBuilder這樣的Eclipse/IDEA插件進(jìn)行可視化拖拽設(shè)計(jì)但我會(huì)建議關(guān)鍵界面還是手寫(xiě)代碼以便更好地控制布局管理和事件監(jiān)聽(tīng)。2.2 分層架構(gòu)設(shè)計(jì)告別“意大利面條”式代碼最忌諱的寫(xiě)法就是把所有代碼——從界面按鈕監(jiān)聽(tīng)器到SQL拼接再到業(yè)務(wù)判斷——全部堆在一個(gè)類(lèi)里。這樣的代碼幾乎無(wú)法維護(hù)和測(cè)試。我們必須采用分層架構(gòu)通常分為四層實(shí)體層Entity 對(duì)應(yīng)數(shù)據(jù)庫(kù)表是簡(jiǎn)單的Java Bean。例如Student類(lèi)包含id、name、studentNumber等屬性及其getter/setter。數(shù)據(jù)訪問(wèn)層DAO 職責(zé)單一只負(fù)責(zé)與數(shù)據(jù)庫(kù)交互執(zhí)行增刪改查。每個(gè)實(shí)體類(lèi)對(duì)應(yīng)一個(gè)DAO接口及其實(shí)現(xiàn)類(lèi)如StudentDao和StudentDaoImpl。這里會(huì)集中處理SQL語(yǔ)句和PreparedStatement使用DbUtils簡(jiǎn)化操作。業(yè)務(wù)邏輯層Service 封裝具體的業(yè)務(wù)規(guī)則。例如“學(xué)生選課”這個(gè)業(yè)務(wù)在Service層里可能會(huì)依次調(diào)用CourseDao檢查課程容量、StudentDao檢查學(xué)生狀態(tài)、SelectionDao插入選課記錄并在此過(guò)程中進(jìn)行事務(wù)控制。它是連接界面層和DAO層的橋梁。表示層View 即Swing界面。它的職責(zé)是接收用戶輸入、展示數(shù)據(jù)并將用戶請(qǐng)求委托給Service層處理。界面層應(yīng)盡可能“笨”不包含業(yè)務(wù)邏輯。此外還需要一些輔助層數(shù)據(jù)庫(kù)連接與配置層 使用單例模式或靜態(tài)工廠方法提供DataSourceHikariCP確保整個(gè)應(yīng)用共用同一個(gè)連接池。工具層 包含一些通用方法如日期格式轉(zhuǎn)換、對(duì)話框彈出、表格模型封裝等。注意 很多新手會(huì)忽略事務(wù)處理。在Service層的一個(gè)方法中如果涉及多次數(shù)據(jù)庫(kù)更新如扣庫(kù)存和生成訂單必須使用事務(wù)來(lái)保證原子性。純JDBC環(huán)境下我們需要手動(dòng)獲取連接、關(guān)閉自動(dòng)提交、在try-catch-finally中處理提交或回滾。這是Service層的核心職責(zé)之一。3. 數(shù)據(jù)庫(kù)設(shè)計(jì)與核心表結(jié)構(gòu)解析數(shù)據(jù)庫(kù)設(shè)計(jì)是系統(tǒng)的基石設(shè)計(jì)不好后期編碼會(huì)處處掣肘。教務(wù)系統(tǒng)的核心實(shí)體通常包括用戶管理員、教師、學(xué)生、課程、班級(jí)、成績(jī)、選課記錄等。這里給出一個(gè)高度簡(jiǎn)化的核心表結(jié)構(gòu)并解釋設(shè)計(jì)用意。3.1 核心表結(jié)構(gòu)設(shè)計(jì)-- 用戶表統(tǒng)一存儲(chǔ)管理員、教師、學(xué)生通過(guò)user_type區(qū)分 CREATE TABLE sys_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) UNIQUE NOT NULL COMMENT 登錄名, password VARCHAR(255) NOT NULL COMMENT 加密后的密碼, real_name VARCHAR(50) NOT NULL COMMENT 真實(shí)姓名, user_type TINYINT NOT NULL COMMENT 用戶類(lèi)型0-管理員1-教師2-學(xué)生, student_number VARCHAR(20) NULL COMMENT 學(xué)號(hào)僅學(xué)生有, teacher_number VARCHAR(20) NULL COMMENT 工號(hào)僅教師有, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) COMMENT系統(tǒng)用戶表; -- 課程表 CREATE TABLE course ( id INT PRIMARY KEY AUTO_INCREMENT, course_code VARCHAR(20) UNIQUE NOT NULL COMMENT 課程代碼, course_name VARCHAR(100) NOT NULL COMMENT 課程名稱(chēng), credit DECIMAL(3,1) NOT NULL COMMENT 學(xué)分, total_hours INT NOT NULL COMMENT 總學(xué)時(shí), teacher_id INT NOT NULL COMMENT 授課教師ID, max_students INT DEFAULT 60 COMMENT 最大選課人數(shù), current_students INT DEFAULT 0 COMMENT 當(dāng)前選課人數(shù), FOREIGN KEY (teacher_id) REFERENCES sys_user(id) ) COMMENT課程信息表; -- 選課記錄表學(xué)生與課程的多對(duì)多關(guān)系 CREATE TABLE course_selection ( id INT PRIMARY KEY AUTO_INCREMENT, student_id INT NOT NULL, course_id INT NOT NULL, selection_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 選課時(shí)間, status TINYINT DEFAULT 1 COMMENT 狀態(tài)1-已選2-已退選, UNIQUE KEY uk_student_course (student_id, course_id), -- 防止重復(fù)選課 FOREIGN KEY (student_id) REFERENCES sys_user(id), FOREIGN KEY (course_id) REFERENCES course(id) ) COMMENT選課記錄表; -- 成績(jī)表 CREATE TABLE score ( id INT PRIMARY KEY AUTO_INCREMENT, selection_id INT NOT NULL UNIQUE COMMENT 關(guān)聯(lián)的選課記錄ID, usual_score DECIMAL(5,2) COMMENT 平時(shí)成績(jī), exam_score DECIMAL(5,2) COMMENT 考試成績(jī), total_score DECIMAL(5,2) GENERATED ALWAYS AS (COALESCE(usual_score,0)*0.3 COALESCE(exam_score,0)*0.7) STORED COMMENT 總評(píng)成績(jī)生成列, teacher_comment TEXT COMMENT 教師評(píng)語(yǔ), FOREIGN KEY (selection_id) REFERENCES course_selection(id) ) COMMENT成績(jī)表;3.2 設(shè)計(jì)要點(diǎn)與避坑指南密碼存儲(chǔ) 絕對(duì)不要明文存儲(chǔ)密碼password字段使用VARCHAR(255)在Java端使用BCrypt或PBKDF2等強(qiáng)哈希算法進(jìn)行加密后存儲(chǔ)。校驗(yàn)時(shí)比較哈希值。用戶表設(shè)計(jì) 采用單表繼承user_type區(qū)分還是多表student,teacher表這里采用單表好處是查詢(xún)簡(jiǎn)單權(quán)限控制統(tǒng)一。缺點(diǎn)是字段會(huì)有冗余學(xué)生的teacher_number為NULL。對(duì)于中小型系統(tǒng)單表更簡(jiǎn)單高效。外鍵與索引 像course_selection表中的student_id和course_id必須建立外鍵約束以保證數(shù)據(jù)完整性。同時(shí)為它們創(chuàng)建復(fù)合唯一索引uk_student_course這是業(yè)務(wù)邏輯一個(gè)學(xué)生不能重復(fù)選同一門(mén)課在數(shù)據(jù)庫(kù)層的保障。生成列的使用score表中的total_score是一個(gè)“生成列”其值由usual_score和exam_score自動(dòng)計(jì)算得出。這保證了數(shù)據(jù)的一致性避免了在應(yīng)用層重復(fù)計(jì)算可能帶來(lái)的錯(cuò)誤。這是MySQL 5.7和MariaDB提供的實(shí)用特性。數(shù)據(jù)字典 像user_type、status這類(lèi)字段建議在項(xiàng)目?jī)?nèi)維護(hù)一個(gè)常量類(lèi)而不是在代碼中硬編碼數(shù)字。例如public interface UserType { int ADMIN 0; int TEACHER 1; int STUDENT 2; }4. 核心模塊實(shí)現(xiàn)與Swing界面開(kāi)發(fā)實(shí)戰(zhàn)4.1 數(shù)據(jù)庫(kù)連接池與通用DAO封裝首先我們解決數(shù)據(jù)庫(kù)訪問(wèn)的基礎(chǔ)問(wèn)題。使用HikariCP配置連接池。// DatabaseConfig.java public class DatabaseConfig { private static volatile DataSource dataSource; private DatabaseConfig() {} public static DataSource getDataSource() { if (dataSource null) { synchronized (DatabaseConfig.class) { if (dataSource null) { HikariConfig config new HikariConfig(); config.setJdbcUrl(jdbc:mysql://localhost:3306/edu_sys?useUnicodetruecharacterEncodingUTF-8serverTimezoneAsia/Shanghai); config.setUsername(your_username); config.setPassword(your_password); config.setMaximumPoolSize(10); // 桌面應(yīng)用10個(gè)連接足夠 config.setMinimumIdle(2); config.setConnectionTimeout(30000); // 30秒 config.setIdleTimeout(600000); // 10分鐘 config.setMaxLifetime(1800000); // 30分鐘 // 其他優(yōu)化配置... dataSource new HikariDataSource(config); } } } return dataSource; } }接著封裝一個(gè)基于DbUtils的通用JdbcTemplate簡(jiǎn)化DAO層的編寫(xiě)。// JdbcTemplate.java (簡(jiǎn)化版) public class JdbcTemplate { private final QueryRunner queryRunner new QueryRunner(DatabaseConfig.getDataSource()); // 查詢(xún)單條記錄 public T T queryForObject(String sql, ResultSetHandlerT rsh, Object... params) throws SQLException { return queryRunner.query(sql, rsh, params); } // 查詢(xún)列表 public T ListT queryForList(String sql, ResultSetHandlerListT rsh, Object... params) throws SQLException { return queryRunner.query(sql, rsh, params); } // 執(zhí)行更新增、刪、改 public int update(String sql, Object... params) throws SQLException { return queryRunner.update(sql, params); } // 在事務(wù)中執(zhí)行操作 public T T executeTransaction(TransactionCallbackT action) throws SQLException { Connection conn null; try { conn DatabaseConfig.getDataSource().getConnection(); conn.setAutoCommit(false); T result action.doInTransaction(conn); conn.commit(); return result; } catch (SQLException e) { if (conn ! null) { conn.rollback(); } throw e; } finally { DbUtils.closeQuietly(conn); } } }有了這個(gè)模板DAO層的實(shí)現(xiàn)就非常清晰了。以StudentDaoImpl為例// StudentDaoImpl.java public class StudentDaoImpl implements StudentDao { private JdbcTemplate jdbcTemplate new JdbcTemplate(); private BeanProcessor beanProcessor new BeanProcessor(); Override public Student findById(int id) throws SQLException { String sql SELECT * FROM sys_user WHERE id ? AND user_type ?; // 使用自定義的ResultSetHandler將結(jié)果集映射為Student對(duì)象 return jdbcTemplate.queryForObject(sql, new ResultSetHandlerStudent() { Override public Student handle(ResultSet rs) throws SQLException { if (rs.next()) { return beanProcessor.toBean(rs, Student.class); } return null; } }, id, UserType.STUDENT); } Override public ListStudent findAll(int page, int size) throws SQLException { String sql SELECT * FROM sys_user WHERE user_type ? LIMIT ?, ?; int offset (page - 1) * size; return jdbcTemplate.queryForList(sql, new BeanListHandler(Student.class), UserType.STUDENT, offset, size); } // ... 其他方法 }4.2 Swing界面開(kāi)發(fā)以學(xué)生信息管理為例Swing開(kāi)發(fā)的核心是理解**事件分發(fā)線程EDT和模型-視圖-控制器MVC**模式。所有UI的創(chuàng)建和更新都必須在EDT上執(zhí)行而耗時(shí)的操作如數(shù)據(jù)庫(kù)查詢(xún)必須放在后臺(tái)線程否則界面會(huì)卡死。我們構(gòu)建一個(gè)學(xué)生信息管理界面包含查詢(xún)表格和表單。// StudentManagementPanel.java - 主面板 public class StudentManagementPanel extends JPanel { private JTable studentTable; private StudentTableModel tableModel; // 自定義的TableModel private JTextField searchField; private JButton searchButton, addButton, editButton, deleteButton; private StudentService studentService new StudentServiceImpl(); public StudentManagementPanel() { initUI(); loadStudentData(1, 20); // 加載第一頁(yè)數(shù)據(jù) } private void initUI() { setLayout(new BorderLayout(10, 10)); // 1. 頂部工具欄 JPanel topPanel new JPanel(new FlowLayout(FlowLayout.LEFT)); searchField new JTextField(20); searchButton new JButton(查詢(xún)); addButton new JButton(新增); editButton new JButton(編輯); deleteButton new JButton(刪除); topPanel.add(new JLabel(姓名:)); topPanel.add(searchField); topPanel.add(searchButton); topPanel.add(Box.createHorizontalStrut(20)); // 添加間距 topPanel.add(addButton); topPanel.add(editButton); topPanel.add(deleteButton); // 2. 中央表格 tableModel new StudentTableModel(); studentTable new JTable(tableModel); studentTable.setSelectionMode(ListSelectionModel.SINGLE_SELECTION); studentTable.getColumnModel().getColumn(0).setPreferredWidth(60); // ID列寬 studentTable.getColumnModel().getColumn(1).setPreferredWidth(100); // 學(xué)號(hào) studentTable.getColumnModel().getColumn(2).setPreferredWidth(80); // 姓名 JScrollPane scrollPane new JScrollPane(studentTable); // 3. 底部分頁(yè)欄略 // JPanel bottomPanel ... add(topPanel, BorderLayout.NORTH); add(scrollPane, BorderLayout.CENTER); // add(bottomPanel, BorderLayout.SOUTH); // 4. 綁定事件監(jiān)聽(tīng)器 setupEventListeners(); } private void setupEventListeners() { searchButton.addActionListener(e - onSearch()); addButton.addActionListener(e - onAddStudent()); editButton.addActionListener(e - onEditStudent()); deleteButton.addActionListener(e - onDeleteStudent()); } private void loadStudentData(int page, int size) { // 使用SwingWorker在后臺(tái)加載數(shù)據(jù)避免阻塞EDT SwingWorkerListStudent, Void worker new SwingWorker() { Override protected ListStudent doInBackground() throws Exception { // 這里是耗時(shí)操作 return studentService.getStudentsByPage(page, size); } Override protected void done() { try { ListStudent students get(); tableModel.setStudents(students); // 更新表格模型 tableModel.fireTableDataChanged(); // 通知表格刷新 } catch (InterruptedException | ExecutionException e) { JOptionPane.showMessageDialog(StudentManagementPanel.this, 加載數(shù)據(jù)失敗: e.getMessage(), 錯(cuò)誤, JOptionPane.ERROR_MESSAGE); } } }; worker.execute(); } private void onSearch() { String keyword searchField.getText().trim(); // 同樣使用SwingWorker執(zhí)行查詢(xún)... } private void onAddStudent() { // 彈出對(duì)話框使用StudentDialog自定義的對(duì)話框 StudentDialog dialog new StudentDialog((Frame) SwingUtilities.getWindowAncestor(this), 新增學(xué)生); dialog.setVisible(true); if (dialog.isConfirmed()) { Student newStudent dialog.getStudent(); // 調(diào)用Service層保存 try { studentService.addStudent(newStudent); loadStudentData(1, 20); // 重新加載數(shù)據(jù) JOptionPane.showMessageDialog(this, 添加成功); } catch (ServiceException ex) { JOptionPane.showMessageDialog(this, 添加失敗: ex.getMessage(), 錯(cuò)誤, JOptionPane.ERROR_MESSAGE); } } } // ... 其他方法 }自定義TableModel是關(guān)鍵它連接了數(shù)據(jù)和JTable視圖。// StudentTableModel.java public class StudentTableModel extends AbstractTableModel { private ListStudent students new ArrayList(); private String[] columnNames {ID, 學(xué)號(hào), 姓名, 性別, 入學(xué)時(shí)間}; Override public int getRowCount() { return students.size(); } Override public int getColumnCount() { return columnNames.length; } Override public String getColumnName(int column) { return columnNames[column]; } Override public Object getValueAt(int rowIndex, int columnIndex) { Student student students.get(rowIndex); switch (columnIndex) { case 0: return student.getId(); case 1: return student.getStudentNumber(); case 2: return student.getRealName(); case 3: return student.getGender() 1 ? 男 : 女; case 4: return new SimpleDateFormat(yyyy-MM-dd).format(student.getEnrollmentDate()); default: return null; } } public void setStudents(ListStudent students) { this.students students; } public Student getStudentAt(int row) { if (row 0 row students.size()) { return students.get(row); } return null; } }4.3 業(yè)務(wù)邏輯層Service與事務(wù)控制Service層是業(yè)務(wù)規(guī)則的家。以“學(xué)生選課”為例它需要處理多個(gè)DAO操作并保證事務(wù)。// CourseSelectionServiceImpl.java public class CourseSelectionServiceImpl implements CourseSelectionService { private CourseSelectionDao selectionDao new CourseSelectionDaoImpl(); private CourseDao courseDao new CourseDaoImpl(); private JdbcTemplate jdbcTemplate new JdbcTemplate(); Override public void selectCourse(int studentId, int courseId) throws ServiceException { // 使用我們封裝的JdbcTemplate執(zhí)行事務(wù) try { jdbcTemplate.executeTransaction(conn - { // 1. 檢查課程是否存在且未滿 Course course courseDao.findById(courseId, conn); // 需要傳遞連接 if (course null) { throw new SQLException(課程不存在); } if (course.getCurrentStudents() course.getMaxStudents()) { throw new SQLException(課程人數(shù)已滿); } // 2. 檢查學(xué)生是否已選該課程 if (selectionDao.exists(studentId, courseId, conn)) { throw new SQLException(不能重復(fù)選課); } // 3. 插入選課記錄 CourseSelection selection new CourseSelection(); selection.setStudentId(studentId); selection.setCourseId(courseId); selectionDao.insert(selection, conn); // 4. 更新課程當(dāng)前人數(shù) courseDao.incrementCurrentStudents(courseId, conn); return null; // 回調(diào)函數(shù)需要返回值這里返回null即可 }); } catch (SQLException e) { // 將SQLException轉(zhuǎn)換為業(yè)務(wù)異常 throw new ServiceException(選課失敗: e.getMessage(), e); } } }實(shí)操心得 Service層的異常處理很重要。底層DAO拋出的SQLException是技術(shù)細(xì)節(jié)不應(yīng)該直接拋給界面層。我們將其捕獲并轉(zhuǎn)換為自定義的ServiceException一個(gè)運(yùn)行時(shí)異常這樣界面層只需要處理一種業(yè)務(wù)異常代碼更清晰。同時(shí)在事務(wù)回調(diào)中所有DAO方法都需要重載一個(gè)接收Connection參數(shù)的版本以保證它們?cè)谕粋€(gè)事務(wù)連接中執(zhí)行。5. 功能模塊詳解與高級(jí)技巧5.1 用戶登錄與權(quán)限控制一個(gè)完整的系統(tǒng)必須有權(quán)限控制。我們?cè)O(shè)計(jì)一個(gè)簡(jiǎn)單的基于角色的訪問(wèn)控制RBAC。登錄驗(yàn)證 在UserService中根據(jù)用戶名查詢(xún)用戶并使用BCrypt校驗(yàn)密碼。登錄成功后將用戶對(duì)象包含user_type存入一個(gè)全局的SessionContext一個(gè)單例或使用ThreadLocal中。界面權(quán)限 在主界面如MainFrame初始化時(shí)根據(jù)SessionContext中的用戶類(lèi)型動(dòng)態(tài)設(shè)置菜單項(xiàng)和按鈕的可用狀態(tài)setEnabled。例如學(xué)生看不到“課程管理”菜單。數(shù)據(jù)權(quán)限 在Service層的方法中加入權(quán)限校驗(yàn)。例如在TeacherService的submitScore方法里首先要判斷當(dāng)前登錄教師是否是這門(mén)課的授課教師。// 簡(jiǎn)單的Session上下文 public class AppContext { private static final ThreadLocalSysUser currentUser new ThreadLocal(); public static void setCurrentUser(SysUser user) { currentUser.set(user); } public static SysUser getCurrentUser() { return currentUser.get(); } public static void clear() { currentUser.remove(); } } // 在登錄成功后 SysUser user userService.login(username, password); AppContext.setCurrentUser(user);5.2 數(shù)據(jù)導(dǎo)出與報(bào)表生成教務(wù)系統(tǒng)經(jīng)常需要導(dǎo)出學(xué)生名單、成績(jī)單等。我們可以使用Apache POI庫(kù)來(lái)生成Excel文件。// ExportService.java 片段 public void exportStudentList(ListStudent students, String filePath) throws IOException { Workbook workbook new XSSFWorkbook(); // 創(chuàng)建.xlsx格式工作簿 Sheet sheet workbook.createSheet(學(xué)生名單); // 創(chuàng)建標(biāo)題行 Row headerRow sheet.createRow(0); String[] headers {學(xué)號(hào), 姓名, 性別, 學(xué)院, 專(zhuān)業(yè)}; for (int i 0; i headers.length; i) { Cell cell headerRow.createCell(i); cell.setCellValue(headers[i]); // 可以設(shè)置單元格樣式... } // 填充數(shù)據(jù)行 int rowNum 1; for (Student student : students) { Row row sheet.createRow(rowNum); row.createCell(0).setCellValue(student.getStudentNumber()); row.createCell(1).setCellValue(student.getRealName()); row.createCell(2).setCellValue(student.getGender() 1 ? 男 : 女); row.createCell(3).setCellValue(student.getCollege()); row.createCell(4).setCellValue(student.getMajor()); } // 自動(dòng)調(diào)整列寬按內(nèi)容 for (int i 0; i headers.length; i) { sheet.autoSizeColumn(i); } // 寫(xiě)入文件 try (FileOutputStream outputStream new FileOutputStream(filePath)) { workbook.write(outputStream); } finally { workbook.close(); } }在界面上添加一個(gè)“導(dǎo)出”按鈕點(diǎn)擊后彈出文件選擇器JFileChooser選擇保存路徑后調(diào)用上述服務(wù)即可。5.3 使用嵌入式數(shù)據(jù)庫(kù)簡(jiǎn)化部署對(duì)于課程設(shè)計(jì)或演示要求用戶安裝MySQL可能太麻煩。我們可以使用嵌入式數(shù)據(jù)庫(kù)H2它可以將數(shù)據(jù)庫(kù)打包在應(yīng)用內(nèi)。在Maven或Gradle中引入H2依賴(lài)。修改DatabaseConfig中的JDBC URL為內(nèi)存模式或文件模式內(nèi)存模式j(luò)dbc:h2:mem:edu_sys;DB_CLOSE_DELAY-1程序關(guān)閉后數(shù)據(jù)消失。文件模式j(luò)dbc:h2:file:~/.edu_sys/db數(shù)據(jù)持久化到用戶目錄。在應(yīng)用啟動(dòng)時(shí)執(zhí)行初始化SQL腳本schema.sql和data.sql來(lái)創(chuàng)建表和插入基礎(chǔ)數(shù)據(jù)。這樣最終用戶只需要有JRE環(huán)境雙擊JAR包就能運(yùn)行完整系統(tǒng)體驗(yàn)非常好。6. 項(xiàng)目打包、部署與常見(jiàn)問(wèn)題排查6.1 使用Maven Shade Plugin打包可執(zhí)行JAR一個(gè)專(zhuān)業(yè)的項(xiàng)目需要打包成包含所有依賴(lài)的“胖JAR”uber JAR。Maven的maven-shade-plugin可以很好地完成這個(gè)任務(wù)。!-- 在pom.xml中配置 -- build plugins plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-shade-plugin/artifactId version3.4.1/version executions execution phasepackage/phase goals goalshade/goal /goals configuration transformers !-- 合并多個(gè)依賴(lài)中的META-INF/services文件 -- transformer implementationorg.apache.maven.plugins.shade.resource.ServicesResourceTransformer/ !-- 指定主類(lèi) -- transformer implementationorg.apache.maven.plugins.shade.resource.ManifestResourceTransformer mainClasscom.yourcompany.edusys.MainApp/mainClass /transformer /transformers filters filter !-- 排除簽名文件避免沖突 -- artifact*:*/artifact excludes excludeMETA-INF/*.SF/exclude excludeMETA-INF/*.DSA/exclude excludeMETA-INF/*.RSA/exclude /excludes /filter /filters /configuration /execution /executions /plugin /plugins /build運(yùn)行mvn clean package后會(huì)在target目錄下生成一個(gè)*-shaded.jar文件直接使用java -jar your-app-shaded.jar命令即可運(yùn)行。6.2 常見(jiàn)問(wèn)題與排查技巧實(shí)錄在開(kāi)發(fā)過(guò)程中你幾乎一定會(huì)遇到下面這些問(wèn)題問(wèn)題1界面卡死無(wú)響應(yīng)現(xiàn)象 點(diǎn)擊查詢(xún)按鈕后整個(gè)程序界面卡住鼠標(biāo)變成等待狀態(tài)直到數(shù)據(jù)庫(kù)查詢(xún)完成才恢復(fù)。原因 在Swing的事件分發(fā)線程EDT中執(zhí)行了耗時(shí)的數(shù)據(jù)庫(kù)操作。解決 必須使用SwingWorker、Thread或ExecutorService將耗時(shí)操作放到后臺(tái)線程。如上面loadStudentData方法所示。記住黃金法則在EDT中只做UI更新所有I/O、網(wǎng)絡(luò)、復(fù)雜計(jì)算都丟到后臺(tái)。問(wèn)題2數(shù)據(jù)庫(kù)連接泄露現(xiàn)象 程序運(yùn)行一段時(shí)間后無(wú)法獲取新的數(shù)據(jù)庫(kù)連接最終導(dǎo)致連接池耗盡。原因 沒(méi)有正確關(guān)閉Connection、Statement或ResultSet。解決使用try-with-resources語(yǔ)法Java 7確保資源自動(dòng)關(guān)閉。使用DbUtils的DbUtils.closeQuietly(...)方法它內(nèi)部處理了null檢查和異常捕獲。在DAO層確保每個(gè)方法在最后都釋放了資源。我們的JdbcTemplate和DbUtils的QueryRunner已經(jīng)幫我們做了這件事。問(wèn)題3中文字符亂碼現(xiàn)象 從數(shù)據(jù)庫(kù)讀出的中文或?qū)懭霐?shù)據(jù)庫(kù)的中文顯示為問(wèn)號(hào)“???”。原因 數(shù)據(jù)庫(kù)連接字符集不匹配。解決 確保三處編碼統(tǒng)一為UTF-8數(shù)據(jù)庫(kù)/表創(chuàng)建時(shí)指定CHARACTER SET utf8mb4MySQL。JDBC連接URL中加入?yún)?shù)?useUnicodetruecharacterEncodingUTF-8。Java源文件本身保存為UTF-8格式。問(wèn)題4表格JTable刷新后數(shù)據(jù)錯(cuò)亂或顯示舊數(shù)據(jù)現(xiàn)象 新增或刪除數(shù)據(jù)后調(diào)用fireTableDataChanged()但表格顯示不對(duì)。原因 直接修改了TableModel背后的數(shù)據(jù)列表但沒(méi)有在修改后立即通知表格。解決在TableModel中提供完整的數(shù)據(jù)操作方法如addRow(Student s)、removeRow(int row)。在這些方法內(nèi)部先更新數(shù)據(jù)列表再調(diào)用對(duì)應(yīng)的fire方法fireTableRowsInserted、fireTableRowsDeleted、fireTableDataChanged。永遠(yuǎn)在EDT中更新表格模型和調(diào)用fire方法。問(wèn)題5程序打包后找不到數(shù)據(jù)庫(kù)驅(qū)動(dòng)或配置文件現(xiàn)象 在IDE里運(yùn)行正常打包成JAR后運(yùn)行報(bào)ClassNotFoundException: com.mysql.cj.jdbc.Driver或找不到config.properties。原因 依賴(lài)的JAR包沒(méi)有被打進(jìn)去或配置文件路徑不對(duì)。解決使用上述的Shade Plugin打包確保所有依賴(lài)都在最終的JAR里。對(duì)于配置文件不要使用絕對(duì)路徑或相對(duì)于當(dāng)前工作目錄的路徑。應(yīng)該將配置文件如config.properties放在src/main/resources目錄下然后使用ClassLoader.getResourceAsStream(“config.properties”)來(lái)讀取。這樣無(wú)論JAR在哪里運(yùn)行都能正確找到資源。問(wèn)題6界面在不同分辨率下布局錯(cuò)亂現(xiàn)象 在自己電腦上布局完美在別人高分辨率屏幕上控件擠在一起或位置偏移。原因 使用了絕對(duì)布局setBounds或固定大小的組件。解決優(yōu)先使用Swing的布局管理器如BorderLayout、GridBagLayout、MigLayout第三方更強(qiáng)大。使用JPanel嵌套來(lái)組合復(fù)雜布局。為組件設(shè)置最小、最大、首選尺寸setMinimumSize,setPreferredSize?？紤]使用JFrame.pack()方法讓窗口根據(jù)內(nèi)容自動(dòng)調(diào)整大小。把這個(gè)項(xiàng)目從頭到尾實(shí)現(xiàn)一遍你會(huì)對(duì)Java桌面應(yīng)用開(kāi)發(fā)有一個(gè)非常扎實(shí)和全面的理解。它就像一塊敲門(mén)磚掌握了這些核心模式和技巧無(wú)論是轉(zhuǎn)向Java EE開(kāi)發(fā)還是深入學(xué)習(xí)客戶端框架都會(huì)輕松很多。最關(guān)鍵的是在這個(gè)過(guò)程中培養(yǎng)出來(lái)的分層設(shè)計(jì)、異常處理和問(wèn)題排查能力是任何Java開(kāi)發(fā)者都不可或缺的硬實(shí)力。