简介本资源是一套基于Java开发的水果品质检测数据管理系统完整源码与数据库面向农业信息化开发者、高校计算机专业学生及Java Web学习者解决农产品质检数据采集、存储、分析与可视化管理的实际问题。压缩包共843个文件含26个核心Java类、31个Jar依赖库、74个HTML前端页面、38个JSP动态模板、45个CSS与201个JS脚本配合MySQL数据库SQL脚本及Spring Boot配置文件完整呈现MVC分层架构与MyBatis持久层实现包体大小16.58MB结构清晰便于按模块用户管理、检测标准设置、数据录入、统计报表快速定位学习。已有166人下载学习读者可直接部署运行深入理解Spring BootMyBatis整合开发、水果质检业务建模、多维度数据分析逻辑及前后端交互实现细节具备较强的教学示范性与工程参考价值。1. 这不是个“水果商城后台”而是一套面向农业质检场景的轻量级Java数据治理闭环当你在实验室用光谱仪测完一批苹果的糖度、硬度、果皮色差手边只有一台Windows笔记本和一个刚导出的Excel表格——此时你需要的不是Spring BootVue的电商后台而是一个能快速录入、分类、查询、导出检测结果并支持基础统计分析的本地化数据管理系统。本项目正是为此而生它用纯Java SESwing构建界面以HSQLDB嵌入式数据库落地存储不依赖Tomcat、不需部署、双击jar即可运行。核心价值在于“检测即入库”——从田间采样编号、到实验室仪器读数、再到质检员复核归档全程数据可追溯、字段可扩展、导出格式标准化CSV/Excel。适合农科院技术员、高职院校《农产品质量检测》课程实训、中小型果蔬合作社品控岗尤其对Java初学者而言它是理解“数据库连接池配置→JDBC事务控制→Swing事件驱动→POJO封装→报表导出”这一完整链路的极佳入口。2. 用Java SEHSQLDB实现零依赖本地化部署的最小可行系统2.1 为什么选HSQLDB而非MySQL或SQLite在农业质检现场设备常为老旧笔记本或无网络环境的便携终端。MySQL需独立服务进程、用户权限管理、端口开放SQLite虽轻量但缺乏ACID事务保障与并发写入稳定性。HSQLDB作为纯Java实现的嵌入式数据库具备三重不可替代性零安装仅需hsqldb.jar加入classpath数据库文件.script,.data直接存于项目根目录启动时自动创建强事务支持支持SERIALIZABLE隔离级别确保多质检员同时录入时“批次号唯一校验”“检测项完整性约束”不被绕过内存模式兼容开发阶段可用jdbc:hsqldb:mem:testdb加速调试生产环境切换为jdbc:hsqldb:file:./data/fruitdb即完成部署。提示HSQLDB 2.7.2是当前与Java 8兼容最稳定的版本避免使用3.x系列——其默认启用sql syntax strict会拒绝CREATE TABLE IF NOT EXISTS等常用语句。2.2 数据库建模紧扣质检业务实体的5张核心表系统采用符合第三范式的结构设计所有表均含id主键与create_time时间戳关键字段加索引提升查询效率表名主要字段业务含义索引策略fruit_batchbatch_no(VARCHAR, UNIQUE),harvest_date,origin_area采样批次主表batch_no为实验室唯一编码batch_noharvest_date复合索引quality_paramparam_code(VARCHAR, PK),param_name,unit,min_value,max_value检测参数字典如SUGAR_DEG、HARDNESS_N、COLOR_L*param_code主键索引detection_recordrecord_id,batch_id(FK),param_code(FK),value,tester_id,test_time单次检测记录每条对应一个参数值batch_idparam_code联合索引tester_infotester_id,name,department,certification_no检测员信息支持按部门统计工作量department索引report_templatetemplate_id,template_name,export_fields,is_default报表模板定义控制导出字段顺序与别名is_default位图索引-- 创建批次表含业务约束 CREATE TABLE fruit_batch ( id INTEGER IDENTITY PRIMARY KEY, batch_no VARCHAR(32) NOT NULL UNIQUE, harvest_date DATE NOT NULL, origin_area VARCHAR(100) NOT NULL, create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP ); CREATE INDEX idx_batch_date ON fruit_batch(harvest_date); -- 创建检测记录表外键关联非空约束 CREATE TABLE detection_record ( record_id INTEGER IDENTITY PRIMARY KEY, batch_id INTEGER NOT NULL, param_code VARCHAR(20) NOT NULL, value DECIMAL(8,3) NOT NULL, tester_id VARCHAR(20) NOT NULL, test_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP, CONSTRAINT fk_batch FOREIGN KEY (batch_id) REFERENCES fruit_batch(id), CONSTRAINT fk_param FOREIGN KEY (param_code) REFERENCES quality_param(param_code) );2.2.1 字段设计背后的质检逻辑batch_no设为VARCHAR而非INT因实际采样编号含字母前缀如“AP20240501-001”强制转数字会导致前导零丢失value用DECIMAL(8,3)糖度测量精度达0.001°Bx浮点数存储会产生累积误差detection_record中未设UNIQUE(batch_id, param_code)允许同一参数多次检测如取3次硬度均值后续通过视图聚合tester_id为VARCHAR对接现有单位工号系统如“NY2023001”避免整型ID与人事系统冲突。2.3 Java层架构三层解耦下的Swing界面与JDBC操作分离系统采用经典MVC变体——Model-View-Controller-DAO四层结构各层职责明确且无循环依赖Model层FruitBatch.java、DetectionRecord.java等POJO字段与数据库列严格一一映射含Override toString()便于调试DAO层BatchDao.java、RecordDao.java封装JDBC操作每个方法对应单一SQL如insertBatch()仅执行INSERTfindBatchByDateRange()仅执行SELECTController层MainController.java接收Swing按钮事件调用DAO方法并处理异常如SQLException转为JOptionPane.showMessageDialog提示View层MainFrame.java为主窗口BatchInputPanel.java为录入面板所有Swing组件通过setActionCommand()绑定业务动作标识符。// BatchDao.java 中的关键方法带事务控制 public boolean insertBatch(FruitBatch batch) throws SQLException { String sql INSERT INTO fruit_batch(batch_no, harvest_date, origin_area) VALUES (?, ?, ?); try (Connection conn dataSource.getConnection(); PreparedStatement ps conn.prepareStatement(sql, Statement.RETURN_GENERATED_KEYS)) { conn.setAutoCommit(false); // 启用手动事务 ps.setString(1, batch.getBatchNo()); ps.setDate(2, new java.sql.Date(batch.getHarvestDate().getTime())); ps.setString(3, batch.getOriginArea()); int affected ps.executeUpdate(); if (affected 0) throw new SQLException(批次插入失败); // 获取自增ID并更新POJO try (ResultSet rs ps.getGeneratedKeys()) { if (rs.next()) batch.setId(rs.getInt(1)); } conn.commit(); // 显式提交 return true; } catch (SQLException e) { conn.rollback(); // 异常回滚 throw e; } }注意HSQLDB的getGeneratedKeys()在INSERT后必须立即调用延迟会导致ResultSet关闭conn.setAutoCommit(false)是保障“批次插入检测记录插入”原子性的关键。3. 实战从源码解压到生成首份质检报告的完整操作链3.1 环境准备与源码编译JDK 8u291项目要求JDK 8最低版本因HSQLDB 2.7.2不兼容JDK 17的模块化机制推荐使用Adoptium Temurin 8u292# 验证Java环境 $ java -version openjdk version 1.8.0_292 OpenJDK Runtime Environment (Temurin)(build 1.8.0_292-b10) # 解压源码包后进入根目录 $ unzip 基于Java设计的水果品质检测数据管理系统源码数据库.zip $ cd fruit-quality-system/ # 编译全部Java文件含src/main/java与src/test/java $ javac -encoding UTF-8 -cp lib/hsqldb.jar:lib/commons-lang3-3.12.0.jar \ -d target/classes \ src/main/java/com/fruit/dao/*.java \ src/main/java/com/fruit/model/*.java \ src/main/java/com/fruit/view/*.java \ src/main/java/com/fruit/controller/*.java3.1.1 关键依赖说明hsqldb.jarHSQLDB 2.7.2核心库提供org.hsqldb.jdbc.JDBCDataSourcecommons-lang3-3.12.0.jar用于StringUtils.isBlank()校验输入、DateUtils.truncate()处理日期无Spring、无MyBatis所有JDBC连接通过BasicDataSource手动管理降低学习门槛log4j-api-2.17.1.jar与log4j-core-2.17.1.jar日志输出至logs/app.log便于追踪检测记录插入失败原因。3.2 数据库初始化与首次运行首次运行前需手动创建data/目录并初始化HSQLDB# 创建数据库文件存放目录 $ mkdir -p data/ # 执行初始化脚本含建表基础参数字典 $ java -cp target/classes:lib/hsqldb.jar \ org.hsqldb.Server -database.0 file:data/fruitdb -dbname.0 fruitdb此命令启动HSQLDB服务器模式仅用于初始化随后访问http://localhost:9001使用默认账号sa/密码为空登录执行src/main/resources/init.sql中的建表语句。关闭服务器后系统将自动切换为嵌入式模式运行。# 启动主程序自动加载嵌入式数据库 $ java -cp target/classes:lib/* com.fruit.view.MainFrame3.2.1 首次录入实操步骤点击菜单栏【批次管理】→【新增批次】填写批次号AP20240501-001必填唯一校验采摘日期2024-05-01日期选择器自动格式化产地山东烟台点击【保存】弹出“批次添加成功ID1”提示切换至【检测录入】面板选择批次号AP20240501-001在参数下拉框选择SUGAR_DEG输入值13.250点击【添加记录】重复步骤3录入HARDNESS_N7.820、COLOR_L*52.300点击【生成报告】→【按批次导出Excel】文件保存至export/AP20240501-001_report.xlsx。提示若导出Excel报错NoClassDefFoundError: org/apache/poi/ss/usermodel/Workbook说明poi-5.2.4.jar未正确引入——检查lib/目录是否存在该文件其版本必须为5.2.4低版本不支持.xlsx格式。3.3 核心功能验证用SQL直查确保数据一致性当Swing界面操作结果存疑时应绕过应用层直连数据库验证# 启动HSQLDB桌面工具无需安装 $ java -cp lib/hsqldb.jar org.hsqldb.util.DatabaseManagerSwing # 连接URL: jdbc:hsqldb:file:data/fruitdb # 用户名: sa密码: 空执行以下SQL验证业务逻辑-- 验证批次与检测记录关联正确性 SELECT b.batch_no, p.param_name, r.value, r.test_time FROM detection_record r JOIN fruit_batch b ON r.batch_id b.id JOIN quality_param p ON r.param_code p.param_code WHERE b.batch_no AP20240501-001; -- 查询某参数近7天平均值用于趋势分析 SELECT AVG(r.value) as avg_sugar, COUNT(*) as total_tests FROM detection_record r JOIN fruit_batch b ON r.batch_id b.id WHERE r.param_code SUGAR_DEG AND b.harvest_date DATEADD(DAY, -7, CURRENT_DATE);3.3.1 常见数据异常定位表现象可能原因验证SQL修复方式批次号重复保存成功batch_no字段未设UNIQUE约束SELECT COUNT(*) FROM fruit_batch WHERE batch_noAP20240501-001;执行ALTER TABLE fruit_batch ADD CONSTRAINT uk_batch_no UNIQUE(batch_no);检测记录显示“null”值value字段为NULL但界面未校验SELECT * FROM detection_record WHERE value IS NULL;在RecordDao.insertRecord()中增加if (record.getValue() null) throw new IllegalArgumentException(检测值不能为空);导出Excel无表头ReportExporter.java中headerRow.createCell(i).setCellValue(headers[i]);未执行SELECT column_name FROM information_schema.columns WHERE table_namedetection_record;检查headers[]数组长度是否等于查询字段数4. 进阶技巧3个让系统真正适配农业质检场景的定制化改造4.1 为色差检测增加Lab色彩空间计算模块原始系统仅存储COLOR_L*单值但实际质检需Lab*三通道数据判断果皮褐变程度。改造方案在quality_param表新增param_codeCOLOR_A*、COLOR_B*两条记录修改DetectionRecord.java将value字段拆分为lValue、aValue、bValue三个BigDecimal属性在RecordDao.insertRecord()中对param_code为COLOR_L*/A*/B*的记录统一按batch_id分组插入确保三值同批次入库。// 新增色差计算工具类避免Swing线程阻塞 public class ColorCalculator { // 计算色差ΔECIE76公式用于判断是否超出标准阈值 public static BigDecimal calculateDeltaE(BigDecimal l1, BigDecimal a1, BigDecimal b1, BigDecimal l2, BigDecimal a2, BigDecimal b2) { BigDecimal dl l1.subtract(l2).abs(); BigDecimal da a1.subtract(a2).abs(); BigDecimal db b1.subtract(b2).abs(); return dl.pow(2).add(da.pow(2)).add(db.pow(2)).sqrt(); } // 示例对比标准样品L*50.0, A*12.5, B*25.0与实测值 public static void main(String[] args) { BigDecimal deltaE calculateDeltaE( new BigDecimal(52.3), new BigDecimal(11.8), new BigDecimal(24.9), new BigDecimal(50.0), new BigDecimal(12.5), new BigDecimal(25.0) ); System.out.println(色差ΔE deltaE.setScale(2, RoundingMode.HALF_UP)); // 输出ΔE2.73 } }4.1.1 集成到Swing界面的操作路径在【检测录入】面板增加COLOR_A*、COLOR_B*输入框与COLOR_L*同行显示点击【添加记录】时触发ColorCalculator.calculateDeltaE()实时计算ΔE值若ΔE 3.0行业常见阈值弹出黄色警示“色差超标建议复检”。4.2 用JFreeChart绘制批次品质趋势折线图系统默认仅支持表格导出但质检员需直观查看糖度变化趋势。集成步骤添加jfreechart-1.5.3.jar到lib/目录在MainFrame.java中新增【趋势分析】菜单项点击后打开TrendChartPanel.java查询SQL改为动态拼接按参数类型时间范围// TrendChartPanel.java 中的数据获取逻辑 private XYDataset createDataset(String paramCode, LocalDate startDate, LocalDate endDate) { TimeSeries series new TimeSeries(检测值, Day.class); String sql SELECT b.harvest_date, r.value FROM detection_record r JOIN fruit_batch b ON r.batch_id b.id WHERE r.param_code ? AND b.harvest_date BETWEEN ? AND ? ORDER BY b.harvest_date; try (PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, paramCode); ps.setDate(2, java.sql.Date.valueOf(startDate)); ps.setDate(3, java.sql.Date.valueOf(endDate)); try (ResultSet rs ps.executeQuery()) { while (rs.next()) { series.add(new Day(rs.getDate(harvest_date)), rs.getBigDecimal(value)); } } } return new TimeSeriesCollection(series); }4.2.1 图表交互增强点X轴自动适配日期范围30天显示日粒度≥30天显示周粒度鼠标悬停显示具体数值与批次号右键导出PNG图像调用ChartUtilities.saveChartAsPNG()。4.3 数据库同步用HSQLDB的SCRIPT TO命令实现跨设备备份针对多检测点果园、冷库、实验室需定期合并数据的场景利用HSQLDB内置命令生成可移植SQL脚本# 在A设备上导出增量数据仅导出今日新增记录 $ java -cp lib/hsqldb.jar org.hsqldb.scriptio.ScriptTool \ -url jdbc:hsqldb:file:data/fruitdb \ -user sa \ -script export_20240501.sql \ -query SELECT * FROM fruit_batch WHERE create_time 2024-05-01 00:00:00; \ -query SELECT * FROM detection_record WHERE test_time 2024-05-01 00:00:00; # 在B设备上执行导入需先停用应用避免锁表 $ java -cp lib/hsqldb.jar org.hsqldb.cmdline.SqlTool \ --rcFile /dev/null \ --sql RUNSCRIPT FROM export_20240501.sql \ jdbc:hsqldb:file:data/fruitdb sa注意SCRIPT TO生成的SQL包含SET DATABASE REFERENTIAL INTEGRITY FALSE可避免外键冲突但执行前务必确认目标库quality_param字典已一致否则param_code引用将失败。5. 参数调优与性能边界当检测数据量突破10万条时的关键配置5.1 HSQLDB连接池与缓存参数优化默认HSQLDB配置在10万条记录下查询响应超2秒需调整server.properties位于data/目录# 增加内存缓存减少磁盘IO hsqldb.cache_file_scale16 hsqldb.cache_size_scale16 hsqldb.cache_rows_max50000 # 启用索引优化对detection_record表生效 hsqldb.index_column_count_max3 hsqldb.index_unique_count_max2 # 日志精简避免写满磁盘 hsqldb.log_size100 hsqldb.log_level15.1.1 验证优化效果的基准测试脚本// BenchmarkTest.java模拟10万条检测记录插入与查询 public class BenchmarkTest { public static void main(String[] args) throws Exception { long start System.currentTimeMillis(); // 插入10万条记录分批每批1000条 for (int i 0; i 100; i) { insertBatchOf1000(i * 1000); } System.out.println(插入耗时 (System.currentTimeMillis() - start) ms); // 查询最近1000批次的糖度均值 start System.currentTimeMillis(); executeQuery(SELECT AVG(r.value) FROM detection_record r JOIN fruit_batch b ON r.batch_idb.id WHERE b.harvest_date DATEADD(DAY, -30, CURRENT_DATE) AND r.param_codeSUGAR_DEG); System.out.println(查询耗时 (System.currentTimeMillis() - start) ms); } }5.2 Swing界面响应延迟的3个定位点当录入界面卡顿时按优先级排查事件分发线程阻塞检查ActionListener.actionPerformed()中是否执行了耗时操作如直接调用RecordDao.insertRecord()——应改用SwingWorker异步执行TableModel数据量过大JTable显示超5000行时渲染缓慢需启用分页PagingTableModel或虚拟滚动JXTableHSQLDB锁竞争多线程同时写入detection_record时INSERT语句持有表级锁应将detection_record表拆分为detection_record_2024、detection_record_2025按年分表。5.3 安全加固防止SQL注入的硬性编码规范尽管系统为内网使用仍需杜绝基础漏洞禁止字符串拼接SQL所有PreparedStatement参数必须用?占位符限制输入长度batch_no字段在Swing输入框设置setDocument(new PlainDocument() { ... })拦截超长输入关闭HSQLDB Web控制台生产环境启动时添加-noconsole参数禁用http://localhost:9001访问。// 在MainFrame.java构造函数中禁用控制台 static { System.setProperty(hsqldb.reconfig_logging, false); } // 启动时传参java -Dhsqldb.reconfig_loggingfalse -cp ... com.fruit.view.MainFrame本文还有配套的精品资源点击获取