Java初级项目药品管理系统：从零开始构建完整功能模块

在软件开发学习过程中，掌握一个完整的Java项目实践是迈向专业开发者的重要一步。本文将详细介绍如何从零开始设计并实现一个Java初级项目药品管理系统，涵盖需求分析、系统架构设计、核心功能开发、数据库设计以及测试部署等全流程，适合初学者循序渐进地理解企业级应用的开发逻辑。

一、项目背景与需求分析

随着医疗信息化的发展，医院和药店对药品管理的需求日益增长。传统的手工记录方式效率低、易出错，因此需要一套基于计算机的药品管理系统来实现药品入库、出库、库存查询、过期提醒等功能。本项目旨在为初学者提供一个结构清晰、功能完整、易于扩展的Java基础项目模板。

1. 功能需求

• 药品信息管理：添加、删除、修改、查询药品基本信息（名称、规格、单价、库存量、生产日期、有效期）。
• 库存管理：自动计算当前库存状态，支持上下架操作。
• 出入库记录：记录每次药品进出情况，便于追溯。
• 过期预警：系统每日检查即将过期药品（如剩余天数小于7天），发出提示。
• 用户权限控制：模拟管理员与普通用户角色，不同权限访问不同功能。

2. 非功能需求

• 界面简洁友好，使用Swing或JavaFX实现图形化交互。
• 数据持久化采用MySQL数据库，通过JDBC连接。
• 代码模块化设计，便于后期维护与升级。
• 具备基本异常处理机制，提升程序健壮性。

二、系统架构设计

为了保证项目的可读性和可扩展性，我们采用典型的三层架构：表现层（UI）→ 业务逻辑层（Service）→ 数据访问层（DAO）。

1. 表现层（View）

使用Java Swing编写图形界面，包含主菜单、药品列表展示窗体、新增/编辑窗口、库存统计面板等。每个功能模块独立成一个窗口类，便于复用和调试。

2. 业务逻辑层（Service）

封装所有业务规则，例如：

• validateInput()：校验输入数据合法性（如价格不能为负数）。
• checkExpiry()：判断药品是否临近过期。
• generateReport()：生成当日库存报告。

3. 数据访问层（DAO）

负责与数据库交互，定义接口如：

public interface MedicineDAO {
    List findAll();
    Medicine findById(int id);
    void insert(Medicine medicine);
    void update(Medicine medicine);
    void delete(int id);
}

实现类MedicineDAOImpl中使用JDBC进行CRUD操作，并做好事务管理和异常捕获。

三、关键技术点详解

1. 数据库设计

创建MySQL数据库表结构如下：

CREATE TABLE medicine (
    id INT PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(50) NOT NULL,
    specification VARCHAR(30),
    price DECIMAL(10,2),
    stock INT DEFAULT 0,
    production_date DATE,
    expiry_date DATE,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

该表字段清晰，满足基本药品管理需求，同时预留了时间戳字段用于审计跟踪。

2. JDBC连接与SQL操作

建立数据库连接时推荐使用连接池技术（如HikariCP）提高性能，但作为初级项目，可以直接用DriverManager方式：

Class.forName("com.mysql.cj.jdbc.Driver");
Connection conn = DriverManager.getConnection(
    "jdbc:mysql://localhost:3306/pharmacy_db", "root", "password"
);

在DAO中编写SQL语句执行增删改查操作，注意防止SQL注入攻击，应使用PreparedStatement替代字符串拼接。

3. GUI界面开发（Swing示例）

以“药品列表”窗体为例：

JFrame frame = new JFrame("药品管理平台");
JTable table = new JTable(model); // model来自DAO查询结果
JScrollPane scrollPane = new JScrollPane(table);
frame.add(scrollPane, BorderLayout.CENTER);
frame.setSize(800, 600);
frame.setVisible(true);

利用TableModel动态绑定数据，使表格自动刷新，无需手动逐行更新。

4. 过期预警机制实现

可以在定时任务中调用checkExpiry()方法，每天凌晨自动扫描数据库中的药品：

Calendar today = Calendar.getInstance();
for (Medicine m : dao.findAll()) {
    if (m.getExpiryDate().before(today.getTime())) {
        System.out.println("警告：药品【" + m.getName() + "】已过期！");
    }
}

更高级的做法可以集成邮件通知或弹窗提醒，增强实用性。

四、常见问题与解决方案

1. 中文乱码问题

确保数据库字符集设置为utf8mb4，连接URL中添加参数：

jdbc:mysql://localhost:3306/pharmacy_db?useUnicode=true&characterEncoding=utf8

2. 异常处理不完善

建议在Service层统一捕获SQLException并抛出自定义异常，避免直接暴露底层错误给用户。

3. UI线程阻塞

长时间操作（如批量导入数据）应在后台线程中执行，避免界面卡死。可用SwingWorker类实现：

new SwingWorker() {
    @Override
    protected Void doInBackground() throws Exception {
        // 执行耗时操作
        return null;
    }
    @Override
    protected void done() {
        // 更新UI
    }
}.execute();

五、项目部署与测试建议

完成编码后，应进行单元测试和集成测试：

• 使用JUnit编写DAO层单元测试，验证增删改查是否正确。
• 手动测试各项功能流程，模拟真实场景（如药品入库后再查询）。
• 打包成jar文件，使用命令行运行：java -jar pharmacy-system.jar。

扩展方向（进阶建议）

• 引入Spring Boot框架简化配置，替代传统JDBC编程。
• 增加日志记录功能（Log4j或SLF4J），便于追踪问题。
• 开发Web版本，使用Spring MVC + Thymeleaf构建前后端分离架构。
• 加入权限认证（JWT + Spring Security）实现多角色登录。

六、总结

通过本项目的学习，初学者不仅可以掌握Java面向对象编程的核心思想，还能深入理解MVC架构、数据库操作、异常处理和GUI开发等多项技能。虽然这是一个初级项目，但它具备良好的工程规范，是后续学习更复杂系统的良好起点。建议读者在实际练习中不断优化代码结构，尝试重构、单元测试和文档撰写，逐步成长为一名合格的Java开发者。