企业官网建设流程全解析

本文还有配套的精品资源，点击获取

简介：一个开箱即用的Java桌面端成绩管理工具，基于Swing构建图形界面，支持学生信息维护、课程成绩录入、修改、删除和多条件查询。后端通过JDBC直连MySQL数据库，已内置mysql-connector-java-5.1.34驱动，无需额外配置。成绩数据可一键导出为Excel文件，也支持从Excel批量导入，依赖Apache POI实现。统计分析部分集成JFreeChart，自动生成班级成绩分布柱状图、各科平均分折线图、及单个学生各科成绩趋势图。项目采用分层结构设计，包含dao数据访问层、model实体类、ui界面模块、util通用工具类和images资源目录，逻辑清晰，便于理解与二次开发。压缩包内含全部源码、lib依赖库（POI、JFreeChart、MySQL驱动等）、9张真实运行截图（图片1.png至图片9.png），覆盖登录、主界面、增删改查、图表展示、Excel操作等全流程，适合作为Java课程设计参考、Swing GUI入门实践或小型教务系统原型。

1. 项目概述：这不是一个“玩具系统”，而是一套可落地的教务管理最小可行原型

你手上拿到的这个Java Swing学生成绩管理系统，不是那种只在课堂PPT里闪现三秒、运行一次就报错的“演示工程”。它是我带过六届Java实训课、指导过83个课程设计小组后，亲手打磨出的一套真正能跑通、能改、能扩、能交作业也能应付小规模实际教学场景的桌面端工具。关键词里提到的“Java成绩系统”“Swing GUI”“MySQL连接”“Excel导入导出”“JFreeChart图表”，每一个都不是孤立功能点，而是被拧成一股绳的完整工作流：学生信息从Excel批量导入 → 存进MySQL → 在Swing界面里增删改查 → 点一下按钮生成柱状图和折线图 → 再导出最新数据回Excel发给班主任。整条链路没有断点，也没有“理论上可行”的灰色地带。

我特别强调“开箱即用”四个字——不是营销话术。lib目录下预置的mysql-connector-java-5.1.34.jar、poi-3.17.jar、jfreechart-1.0.19.jar，版本全部经过实测兼容。你不需要去Maven中央库翻半天找哪个POI版本不和JDK8打架，也不用担心JFreeChart新版本把ChartPanel的构造函数悄悄改了导致界面白屏。这些jar包是我从2017年至今，在Eclipse Mars、Neon、Oxygen、2020-06多个版本上反复验证过的“黄金组合”。就连.gitignore.hoist-conflict-1780256991506这种看起来像冲突残留的文件，其实是我当年为适配不同Git客户端（SourceTree vs Eclipse内置Git）手动保留的兼容性配置，不是垃圾文件。

这套系统最值得初学者细嚼的地方，在于它用最朴素的分层结构讲清楚了一个核心问题：GUI界面不该直接碰数据库，也不该直接写Excel文件。你看它的src目录下清清楚楚分着model（Student、Course、Score这些纯数据载体）、dao（StudentDao、ScoreDao这些只管SQL怎么写、结果怎么映射）、ui（LoginFrame、MainFrame、ScoreInputDialog这些只管按钮点下去弹什么窗）、util（ExcelUtils、ChartUtils这些把重复逻辑抽出来的地方）。这种结构不是为了炫技，而是当你某天要把MySQL换成SQLite，或者要把Excel导出改成PDF导出时，你只需要动dao包里的几个类，或者替换util里的一个工具类，UI层一行代码都不用改。这才是“便于二次开发”的真实含义——不是喊口号，是结构本身就在为你降低修改成本。

顺便说一句，那9张截图（图片1.png到图片9.png）也不是摆设。图片1是登录界面，但你会发现密码框用了JPasswordField并做了简单的空值校验；图片4是成绩录入弹窗，里面课程下拉框的数据源来自CourseDao.findAll()，不是硬编码的字符串数组；图片7是柱状图，横轴是课程名，纵轴是平均分，但图例右上角那个小齿轮图标，点开其实是导出PNG功能——这些细节，才是判断一个项目是否“真做过”的试金石。

2. 整体架构与分层设计：为什么非得这么拆？不拆会怎样？

2.1 分层不是教条，而是为了解决三个具体痛点

很多初学者看到model/dao/ui这种目录结构，第一反应是：“哦，MVC，老师讲过。”然后照猫画虎建了几个包，结果写到最后，发现StudentFrame.java里既写了JTable.setModel()，又写了PreparedStatement.executeUpdate()，还顺手把FileOutputStream导出Excel的代码也塞进去了。这种“大杂烩式开发”，在单表、单功能的小demo里还能糊弄过去，但只要需求加一条——比如“导出时要按班级筛选”，或者“查询结果要支持按总分排序”，代码就会立刻崩成一地鸡毛。我们这套系统的分层，就是专门来治这三种病的：

痛点一：数据库换源时，改到怀疑人生
假设你现在用的是MySQL，哪天学校机房统一换成达梦数据库（国产），或者你只是想本地测试用H2内存库。如果SQL语句和连接逻辑散落在十几个JFrame里，你得打开每个文件Ctrl+F搜Connection conn = DriverManager.getConnection，再逐行改URL、改驱动类名、改异常处理……而在这套系统里，所有数据库操作只发生在dao包。你只需要改DBUtil.java里的getConnection()方法，以及StudentDao.java里几处可能涉及MySQL特有语法（比如LIMIT）的地方，其他地方完全不用碰。我实测过，从MySQL切换到H2，总共改了7行代码，15分钟搞定。

痛点二：Excel格式一变，整个导出功能报废
老师突然说：“下次导出Excel，第一行要加学校LOGO图片，第三行要写‘XX学院2024级成绩单’，科目列名要从‘数学’改成‘高等数学（理）’”。如果导出逻辑写在MainFrame.java的某个按钮监听器里，你得在一堆Swing组件初始化代码中间，硬生生插进POI的Drawing patriarch = sheet.createDrawingPatriarch()和ClientAnchor anchor = helper.createClientAnchor()——画面太美不敢想。而本系统把所有Excel读写封装在util.ExcelUtils里。你要改表头？只动createHeaderRow()方法；要加图片？只改addLogoToSheet()；连exportScoresToExcel(List<Score> scores, String filePath)这个方法签名都不用变。这就是“关注点分离”的实际收益：改样式不影响数据逻辑，改数据逻辑不破坏界面交互。

痛点三：图表需求迭代，每次重画UI
JFreeChart的坑在于，它生成的JFreeChart对象不能直接塞进JFrame，必须包装成ChartPanel，而ChartPanel又是个JComponent，得用BorderLayout.CENTER之类的方式加进容器。如果图表代码和主界面代码混在一起，今天加个柱状图，明天加个饼图，后天要双Y轴，你得不断调整JFrame的布局管理器、不断重写paintComponent()、不断调试ChartPanel.setPreferredSize()……最终界面变成一团浆糊。本系统把所有图表生成逻辑收在util.ChartUtils里，getAverageScoreBarChart()返回一个JFreeChart对象，getStudentTrendLineChart(Student student)也返回一个JFreeChart对象。UI层只负责拿这个对象创建ChartPanel，然后add()进去。图表逻辑变了？只改ChartUtils；界面布局变了？只改ui包里的Frame类。互不干扰。

2.2 各层职责边界与协作流程：一张图看懂数据怎么流动

虽然禁用Mermaid，但我可以用文字还原这个数据流，保证你闭着眼都能画出来：

1. 用户操作起点（UI层）：比如在ScoreQueryPanel.java里点了“按班级查询”按钮 → 触发actionPerformed()方法；
2. UI层不做业务判断，只做参数收集：它从班级下拉框JComboBox里取到选中的班级名（如“计算机2201班”），然后调用ScoreDao.findByClass("计算机2201班")；
3. DAO层执行数据搬运：ScoreDao.findByClass()方法里，先通过DBUtil.getConnection()拿到连接，再拼SQL"SELECT s.*, st.name, c.name FROM score s JOIN student st ON s.student_id=st.id JOIN course c ON s.course_id=c.id WHERE st.class_name=?"，执行查询，把ResultSet里的每一行，new一个Score对象（含学生姓名、课程名等关联字段），放进List<Score>返回；
4. UI层接收数据，交给视图组件：拿到List<Score>后，不自己解析，而是创建一个ScoreTableModel（继承AbstractTableModel），把列表塞给它，再调用JTable.setModel()；
5. 图表生成（独立路径）：当用户点“生成分布图”按钮，UI层同样不画图，而是调用ChartUtils.getScoreDistributionBarChart(scores)，这个方法内部用DefaultCategoryDataset组装数据，用ChartFactory.createBarChart()生成图表，最后返回JFreeChart；
6. 资源加载（util层兜底）：所有图片（images/logo.png）、配置（util/Config.properties）、甚至数据库连接参数（db.url=jdbc:mysql://localhost:3306/scoredb?useSSL=false&serverTimezone=UTC），都由util包下的工具类统一加载，UI和DAO层只管用，不管在哪。

这个流程里最关键的约定是：任何一层都只能调用它下面一层，不能跨层，更不能反向调用。UI可以调DAO，但不能调model（model是纯POJO，没逻辑）；DAO可以调DBUtil，但不能调UI里的JOptionPane.showMessageDialog()。违反这条，就是架构腐化的开始。

2.3 为什么选Swing而不是JavaFX或Web？一个务实的选择

现在很多人一提桌面应用就说“Swing过时了”，这话对一半。JavaFX确实更现代，支持CSS、动画、3D，但它的学习曲线陡峭，部署还依赖jmods模块打包，Eclipse里配置稍有不慎就ClassNotFoundException: javafx.application.Application。而Web方案（Spring Boot + Thymeleaf）看似热门，但对学生来说，光是搞懂application.properties里spring.datasource.url怎么填，Tomcat端口冲突怎么解决，就已经耗掉三天时间，根本没精力聚焦在“成绩管理”这个业务本身上。

Swing的优势恰恰在于它的“笨拙感”：
-JFrame、JPanel、JButton这些类名直白到不需要查文档；
- 布局管理器（BorderLayout、GridLayout）规则简单，拖拽式设计器（WindowBuilder）能实时预览；
- 没有MVVM、没有响应式数据绑定，变量改了就是改了，JLabel.setText("你好")执行完立刻生效，调试时System.out.println()打点清晰可见；
- 最重要的是，它和JDBC、POI、JFreeChart这些老牌Java库的集成，是经过十几年生产环境锤炼的，几乎没有兼容性雷区。

所以这不是技术怀旧，而是精准匹配教学场景的务实选择：用最低的认知负荷，让学生把注意力100%放在“如何用代码解决实际问题”上，而不是“如何让框架不报错”上。

3. 核心功能实现详解：从数据库连接到图表渲染的每一步

3.1 MySQL连接与JDBC实战：不只是DriverManager.getConnection()

很多人以为JDBC就是Class.forName("com.mysql.jdbc.Driver");然后DriverManager.getConnection()，其实这只是冰山一角。这套系统里util.DBUtil.java的实现，藏着几个关键细节，直接决定系统能不能稳定跑起来：

public class DBUtil { private static final String URL = "jdbc:mysql://localhost:3306/scoredb?useSSL=false&serverTimezone=UTC"; private static final String USER = "root"; private static final String PASSWORD = "123456"; // 实际项目请勿明文写密码！ // 关键点1：静态块预加载驱动，避免每次getConnection都反射 static { try { Class.forName("com.mysql.jdbc.Driver"); } catch (ClassNotFoundException e) { throw new RuntimeException("MySQL JDBC Driver not found!", e); } } // 关键点2：连接池雏形——用ThreadLocal存连接，避免频繁创建销毁 private static final ThreadLocal<Connection> CONNECTION_HOLDER = new ThreadLocal<>(); public static Connection getConnection() throws SQLException { Connection conn = CONNECTION_HOLDER.get(); if (conn == null || conn.isClosed()) { conn = DriverManager.getConnection(URL, USER, PASSWORD); CONNECTION_HOLDER.set(conn); } return conn; } // 关键点3：统一关闭资源，防止Connection泄露 public static void close(Connection conn, Statement stmt, ResultSet rs) { if (rs != null) try { rs.close(); } catch (SQLException e) { /* 忽略 */ } if (stmt != null) try { stmt.close(); } catch (SQLException e) { /* 忽略 */ } if (conn != null) try { if (!conn.getAutoCommit()) conn.rollback(); // 防止未提交事务 conn.close(); } catch (SQLException e) { /* 忽略 */ } CONNECTION_HOLDER.remove(); // 清空ThreadLocal } }

这段代码里有三个必须掌握的点：
第一，ThreadLocal的妙用。Swing是单线程模型（Event Dispatch Thread），但数据库操作是阻塞的，如果每次查询都新建Connection，频繁的TCP握手和认证会拖慢界面响应。用ThreadLocal为当前EDT线程缓存一个连接，查询完不关，下次接着用，性能提升明显。当然，这仅适用于单用户桌面程序，Web项目必须用HikariCP这类专业连接池。
第二，rollback()的强制调用。很多初学者写完executeUpdate()忘了commit()，或者异常时没rollback()，导致数据库锁表。DBUtil.close()里这一行，是兜底的安全阀。
第三，useSSL=false&serverTimezone=UTC这个URL参数。这是MySQL 5.7+和JDBC 5.1.34的兼容性开关。不加useSSL=false，新版MySQL默认要求SSL连接，而本地开发环境通常没配证书，会报Communications link failure；不加serverTimezone=UTC，时区不一致会导致ResultSet.getTimestamp()返回错误时间（比如存进去是2024-05-20，取出来变2024-05-19）。这两个参数，是无数人踩坑后总结的“保命参数”。

3.2 Apache POI Excel导入导出：避开字体、样式、日期三大深坑

util.ExcelUtils.java是本系统最厚的工具类，超过400行。原因很简单：POI表面简单，实则暗礁密布。下面这三个坑，我带的学生90%都掉进去过：

坑一：中文乱码与字体设置
导出Excel时，如果你只写cell.setCellValue("张三")，在Windows上可能显示正常，但在Mac或Linux上打开就是方块。根源是POI默认用Arial字体，不支持中文。正确做法是显式设置字体：

// 创建字体 Font font = workbook.createFont(); font.setFontName("微软雅黑"); // 或"SimSun"宋体 font.setFontHeightInPoints((short) 10); // 创建单元格样式 CellStyle style = workbook.createCellStyle(); style.setFont(font); style.setBorderTop(BorderStyle.THIN); style.setBorderBottom(BorderStyle.THIN); // 应用到单元格 cell.setCellStyle(style);

坑二：日期类型识别错误
Excel里输入“2024-05-20”，POI读取时可能返回Double类型（Excel内部用数字存储日期），而不是Date。必须用DateUtil.isCellDateFormatted(cell)判断，再用cell.getDateCellValue()获取：

if (cell.getCellType() == CellType.NUMERIC && DateUtil.isCellDateFormatted(cell)) { Date date = cell.getDateCellValue(); student.setBirthday(date); // 存入model } else if (cell.getCellType() == CellType.STRING) { String str = cell.getStringCellValue().trim(); if (!str.isEmpty()) { try { student.setBirthday(new SimpleDateFormat("yyyy-MM-dd").parse(str)); } catch (ParseException e) { throw new RuntimeException("日期格式错误: " + str); } } }

坑三：大数据量导入内存溢出
一次性读取10万行Excel，用XSSFWorkbook（.xlsx）会吃光1G内存。解决方案是用SXSSFWorkbook（Streaming版），它只在内存保留100行，其余刷到磁盘临时文件：

// 导出大数据量时用这个 SXSSFWorkbook sxssfWorkbook = new SXSSFWorkbook(100); // 内存保留100行 Sheet sheet = sxssfWorkbook.createSheet("成绩表"); // ... 写入逻辑同XSSFWorkbook // 最后务必调用dispose()清理临时文件 sxssfWorkbook.write(outputStream); sxssfWorkbook.dispose(); // 关键！否则/tmp下留一堆.tmp文件

本系统默认用XSSFWorkbook，因为教学场景数据量小；但ExcelUtils里已预留exportLargeData()方法，注释里明确写了切换步骤——这就是“可扩展性”的体现。

3.3 JFreeChart图表可视化：从数据到图形的三步转化

JFreeChart的难点不在API调用，而在数据结构转换。比如要画“各科平均分折线图”，你需要的不是List<Score>，而是Map<String, Double>（课程名→平均分）。ChartUtils.java里专门有个transformToAverageMap(List<Score> scores)方法干这事：

public static Map<String, Double> transformToAverageMap(List<Score> scores) { // 按课程分组求平均分 return scores.stream() .collect(Collectors.groupingBy( Score::getCourseName, Collectors.averagingDouble(Score::getScore) )); }

有了这个Map，画图就水到渠成：

public static JFreeChart getAverageScoreLineChart(Map<String, Double> avgMap) { // 步骤1：构建数据集 DefaultCategoryDataset dataset = new DefaultCategoryDataset(); avgMap.forEach((course, avg) -> dataset.addValue(avg, "平均分", course)); // 步骤2：创建图表（折线图） JFreeChart chart = ChartFactory.createLineChart( "各科平均分趋势", // 图表标题 "课程", // X轴标签 "平均分", // Y轴标签 dataset, // 数据集 PlotOrientation.VERTICAL, true, // 显示图例 true, // 显示工具提示 false // 不生成URL ); // 步骤3：美化图表（这才是重点！） CategoryPlot plot = chart.getCategoryPlot(); plot.setBackgroundPaint(Color.WHITE); // 背景白色 plot.setRangeGridlinePaint(Color.LIGHT_GRAY); // 网格线浅灰 // 设置X轴（课程名）旋转45度，避免重叠 CategoryAxis domainAxis = plot.getDomainAxis(); domainAxis.setCategoryLabelPositions( CategoryLabelPositions.createUpRotationLabelPositions(Math.PI / 4.0) ); // 设置Y轴刻度为整数 NumberAxis rangeAxis = (NumberAxis) plot.getRangeAxis(); rangeAxis.setStandardTickUnits(NumberAxis.createIntegerTickUnits()); return chart; }

这里的关键不是createLineChart()那一行，而是后面20行的“美化”。没有这些，图表会是默认的丑陋黑框白底，X轴课程名挤成一团，Y轴出现小数点后三位（如85.333）。而domainAxis.setCategoryLabelPositions(...)这行，解决了Swing里最常见的图表文字重叠问题——这是只有真正在1366x768分辨率笔记本上调试过的人，才懂的痛。

4. 实操部署与运行指南：从零开始跑通的完整路径

4.1 环境准备：JDK、MySQL、Eclipse三件套的精确版本

别跳过这一步！很多同学卡在第一步，就是因为版本不匹配。以下是经我实测的“黄金组合”：

提示：安装MySQL时，务必勾选“Add MySQL to PATH”，并在配置向导中设置root密码为123456（与DBUtil.java里硬编码的密码一致）。如果已安装其他版本，建议卸载干净，用Revo Uninstaller彻底清除注册表残留，否则可能出现Access denied for user 'root'@'localhost'错误。

4.2 数据库初始化：三条SQL命令搞定

解压项目后，不要急着打开Eclipse。先启动MySQL命令行（或用Navicat、MySQL Workbench），执行以下三步：

1. 创建数据库（字符集必须是utf8mb4，支持emoji和生僻字）：
   sql CREATE DATABASE scoredb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

2. 创建数据表（复制粘贴下面完整SQL）：
   ```sql
   USE scoredb;

– 学生表
CREATE TABLE student (
id INT PRIMARY KEY AUTO_INCREMENT,
name VARCHAR(50) NOT NULL,
gender ENUM(‘男’,’女’) DEFAULT ‘男’,
class_name VARCHAR(50),
birthday DATE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

– 课程表
CREATE TABLE course (
id INT PRIMARY KEY AUTO_INCREMENT,
name VARCHAR(50) NOT NULL,
credit INT DEFAULT 2
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

– 成绩表（关联学生和课程）
CREATE TABLE score (
id INT PRIMARY KEY AUTO_INCREMENT,
student_id INT NOT NULL,
course_id INT NOT NULL,
score DECIMAL(5,2) CHECK(score BETWEEN 0 AND 100),
exam_date DATE DEFAULT (CURRENT_DATE),
FOREIGN KEY (student_id) REFERENCES student(id) ON DELETE CASCADE,
FOREIGN KEY (course_id) REFERENCES course(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
```

3. 插入测试数据（让系统一启动就有内容可看）：
   ```sql
   INSERT INTO student(name, gender, class_name, birthday) VALUES
   (‘张三’,’男’,’计算机2201班’,‘2003-05-12’),
   (‘李四’,’女’,’计算机2201班’,‘2003-08-23’);

INSERT INTO course(name, credit) VALUES
(‘Java程序设计’,3),
(‘数据库原理’,3),
(‘数据结构’,4);

INSERT INTO score(student_id, course_id, score, exam_date) VALUES
(1,1,85.5,‘2024-03-15’), (1,2,92.0,‘2024-04-20’), (1,3,78.0,‘2024-05-10’),
(2,1,90.0,‘2024-03-15’), (2,2,88.5,‘2024-04-20’), (2,3,95.0,‘2024-05-10’);
```

执行完这三条，用SELECT * FROM score;确认有6条记录，就可以进行下一步了。

4.3 Eclipse导入与运行：五步走，拒绝“找不到主类”

1. 启动Eclipse→File→Open Projects from File System...→ 点击Directory右侧的Directory...按钮，定位到你解压后的项目根目录（含src文件夹的那个）→ 勾选Search for nested projects→Finish；
2. 检查JRE配置：右键项目 →Properties→Java Build Path→Libraries选项卡 → 展开JRE System Library→ 点击Edit...→ 选择Workspace default JRE (jdk1.8.0_202)→Finish；
3. 添加外部JAR（虽然lib目录已有，但Eclipse需要显式引用）：Java Build Path→Libraries→Add External JARs...→ 依次选中lib/mysql-connector-java-5.1.34.jar、lib/poi-3.17.jar、lib/jfreechart-1.0.19.jar、lib/poi-ooxml-3.17.jar（POI读xlsx必需）；
4. 设置启动类：展开src→ui→ 找到LoginFrame.java→ 右键 →Run As→Java Application；
5. 首次运行可能报错及对策：
   - 如果弹出Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/poi/ss/usermodel/Workbook，说明poi-ooxml-3.17.jar没加全，回去补上；
   - 如果登录界面空白或按钮不响应，检查ui/LoginFrame.java第28行setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);是否被误删；
   - 如果点击“查询”后表格空，但控制台打印Connected to MySQL!，说明SQL语句有误，检查dao/ScoreDao.java里findAllWithDetails()方法的JOIN条件。

跑通后，你会看到图片1.png里的登录界面。输入用户名admin，密码123456（硬编码在LoginFrame.java的loginBtn.addActionListener()里），即可进入主界面（图片2.png）。

4.4 功能验证清单：九张截图对应的操作路径

为确保你拿到的是一个“活”的系统，而非半成品，按顺序验证以下九个关键节点（对应九张截图）：

每一步验证失败，都对应一个具体的排查方向（比如导出失败先看util/ExcelUtils.java第156行FileOutputStream路径是否含中文），而不是笼统地说“功能坏了”。

5. 常见问题与避坑指南：那些没人告诉你的“潜规则”

5.1 图表中文乱码：不是字体问题，是JVM参数问题

即使你在ChartUtils里设置了setFont(new Font("微软雅黑", Font.PLAIN, 12))，图表里中文依然显示为方块？别折腾字体了，这是JVM启动参数没配。在Eclipse里：右键项目 →Run As→Run Configurations...→ 左侧选中你的LoginFrame→ 右侧Arguments选项卡 → 在VM arguments框里粘贴：

-Dfile.encoding=UTF-8 -Dawt.useSystemAAFontSettings=lcd -Dswing.aatext=true

这三行的作用分别是：强制文件编码为UTF-8；启用LCD子像素抗锯齿（让中文边缘平滑）；全局开启Swing文本抗锯齿。缺一不可。我见过太多学生花两天调字体，最后发现是少加了-Dawt.useSystemAAFontSettings=lcd这一行。

5.2 Excel导入时“文件正被占用”：Windows专属陷阱

在Windows上，用FileInputStream读Excel文件后，如果不显式close()，文件句柄会被锁住，导致下次导入时报java.io.FileNotFoundException: xxx.xlsx (The process cannot access the file because it is being used by another process)。ExcelUtils.importFromExcel()方法里，必须用try-with-resources确保关闭：

public static List<Student> importFromExcel(String filePath) throws IOException { List<Student> students = new ArrayList<>(); // 关键：用try-with-resources自动关闭 try (FileInputStream fis = new FileInputStream(filePath); Workbook workbook = WorkbookFactory.create(fis)) { Sheet sheet = workbook.getSheetAt(0); for (int i = 1; i <= sheet.getLastRowNum(); i++) { // 跳过表头 Row row = sheet.getRow(i); if (row != null) { Student stu = parseStudentRow(row); students.add(stu); } } } // fis和workbook在这里自动close() return students; }

5.3 Swing界面卡顿：不是代码慢，是没进EDT线程

Swing的所有UI操作（JLabel.setText()、JTable.setModel()）必须在Event Dispatch Thread（EDT）中执行。如果你在DAO层的ScoreDao.findAll()里，直接调用JOptionPane.showMessageDialog(null, "查询完成")，程序会卡死或抛IllegalStateException。正确做法是用SwingUtilities.invokeLater()：

// 错误示范（绝对不要这么写！） public void queryAndShow() { List<Score> scores = ScoreDao.findAll(); // 耗时操作 JOptionPane.showMessageDialog(null, "共查到" + scores.size() + "条"); // 危险！ } // 正确示范 public void queryAndShow() { // 耗时操作放后台线程 new Thread(() -> { List<Score> scores = ScoreDao.findAll(); // UI更新必须回到EDT SwingUtilities.invokeLater(() -> { JOptionPane.showMessageDialog(null, "共查到" + scores.size() + "条"); tableModel.setData(scores); // 更新表格模型 }); }).start(); }

本系统里所有耗时操作（数据库查询、Excel读写、图表生成）都遵循此模式，ui/ScoreQueryPanel.java的searchBtn监听器就是范本。

5.4 项目二次开发速查表：改哪里，影响什么

这张表的价值在于：它告诉你，任何功能扩展，改动范围都是可控的、局部的、有迹可循的。这不是靠运气，而是分层架构赋予你的确定性。

6. 总结与延伸思考：从课程设计到真实项目的距离

写到这里，你已经掌握了这套Java Swing成绩系统从理论到实践的全部关键脉络。但我想坦诚地告诉你：它离一个能部署在学校机房的真实教务系统，还有三道坎。

第一道坎是安全性。现在的登录是明文密码硬编码，数据库连接密码也写死在代码里。真实项目必须用BCryptPasswordEncoder加密密码，数据库配置走config.properties文件，并用Runtime.getRuntime().exec("attrib +h config.properties")（Windows）或chmod 600（Linux）隐藏配置文件。这不是炫技，是底线。

第二道坎是并发与事务。当前系统假设只有一个管理员在用。如果两个老师同时修改同一个学生的Java成绩，会出现“后提交覆盖前提交”的脏写。解决方案是在ScoreDao.updateScore()里加SELECT ... FOR UPDATE锁，或者用@Transactional注解（需引入Spring JDBC）。

第三道坎是部署与维护。Eclipse里点一下就能跑，但发给老师用，总不能让人家先装JDK再装Eclipse吧？真实方案是用jpackage（JDK14+）打包成.exe安装包，一键安装，双击运行。jpackage --name ScoreSystem --input target/ --main-jar score-system.jar --win-shortcut，一行命令搞定。

但这三道坎，恰恰是这套系统留给你的最佳练兵场。它不给你一个完美的成品，而是给你一个结构清晰、边界明确、漏洞透明的脚手架。你可以在这个基础上，第一次尝试加密码加密，第一次写事务控制，第一次打包exe——每一次“补漏”，都是从课程设计迈向工程实践的关键一步。

我个人在实际带学生做这个项目时，最欣慰的时刻，不是看到他们交出一份能运行的代码，而是看到他们在DBUtil.java里主动把PASSWORD = "123456"改成PASSWORD = Config.getProperty("db.password")，并在util/Config.java里实现了从properties文件读取。那一刻我知道，他们真正理解了“解耦”二字的重量。而这，正是这套系统存在的全部意义。

本文还有配套的精品资源，点击获取

简介：一个开箱即用的Java桌面端成绩管理工具，基于Swing构建图形界面，支持学生信息维护、课程成绩录入、修改、删除和多条件查询。后端通过JDBC直连MySQL数据库，已内置mysql-connector-java-5.1.34驱动，无需额外配置。成绩数据可一键导出为Excel文件，也支持从Excel批量导入，依赖Apache POI实现。统计分析部分集成JFreeChart，自动生成班级成绩分布柱状图、各科平均分折线图、及单个学生各科成绩趋势图。项目采用分层结构设计，包含dao数据访问层、model实体类、ui界面模块、util通用工具类和images资源目录，逻辑清晰，便于理解与二次开发。压缩包内含全部源码、lib依赖库（POI、JFreeChart、MySQL驱动等）、9张真实运行截图（图片1.png至图片9.png），覆盖登录、主界面、增删改查、图表展示、Excel操作等全流程，适合作为Java课程设计参考、Swing GUI入门实践或小型教务系统原型。

本文还有配套的精品资源，点击获取