Java / 系统课时

综合实战项目:学生管理系统

综合实战项目:学生管理系统

本课把类与对象、封装、异常和集合组合成一个可运行的学生管理系统:学号唯一、成绩合法、查询结果明确,非法操作被拒绝时已有数据保持不变,并通过一次完整运行逐行验收。

学习目标

  • 按模型、服务、入口三层划分职责,让业务规则只出现在一个地方
  • 用 LinkedHashMap 按学号索引学生,并以只读快照对外返回数据
  • 用一次完整运行验证新增、更新、查询、删除和非法输入处理

需求与职责划分

系统需要支持新增、修改成绩、按学号查询、删除和列表五项操作,并满足四条规则:学号和姓名不能为空;学号创建后不可修改且不能重复;成绩只能是 0~100;修改或删除不存在的学生时给出明确提示。

类 负责什么 不负责什么
Student 保存学号、姓名、成绩,保证自身数据合法 不知道其他学生是否存在
StudentService 学号唯一性、存在性判断和增删改查 不读取输入、不打印结果
Main 调用服务、展示结果和错误提示 不直接修改内部集合

这样划分后,“成绩必须在 0~100 之间”只写在 Student 里,“学号不能重复”只写在 StudentService 里。以后把入口换成 Scanner 菜单或网页,规则都不用重写。

存储结构与只读快照

查询都按学号进行,所以用学号作键的 Map<String, Student> 存储,按学号查找不需要遍历全部学生。选择 LinkedHashMap 是因为它会保留录入顺序,列表输出稳定、可预期。

对外返回数据时不能直接交出内部 Map,否则调用方可以绕过服务随意增删。但也不能用 Map.copyOf 复制:它返回的不可变 Map 不保证迭代顺序,LinkedHashMap 的录入顺序会丢失,列表输出可能每次运行都不一样。

本例用 List.copyOf(students.values()) 返回按录入顺序排列的只读列表。它是调用那一刻的快照,之后服务里的增删不会反映到已经拿到的列表上,需要最新数据时重新调用即可。

新增时用 putIfAbsent 一步完成“检查并放入”:返回值不是 null 说明学号已被占用,此时原有学生不会被覆盖。

完整实现

示例需要 JDK 11 及以上。将代码保存为 Main.java,三个类放在同一个文件中。

java
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.Optional;

public class Main {
    public static void main(String[] args) {
        StudentService service = new StudentService();
        service.add(new Student("S001", "小王", 88));
        service.add(new Student("S002", "小李", 92));
        service.updateScore("S001", 95);

        // 两次违规操作:只打印拒绝原因,已有数据必须保持不变
        tryRun(() -> service.add(new Student("S001", "小张", 70)));
        tryRun(() -> service.updateScore("S002", 120));

        System.out.println("全部学生:");
        service.findAll().forEach(System.out::println);
        System.out.println("查询 S001:" + describe(service.find("S001")));
        System.out.println("查询 S009:" + describe(service.find("S009")));
        System.out.println("删除 S002:" + service.remove("S002"));
        System.out.println("当前人数:" + service.findAll().size());
    }

    static void tryRun(Runnable action) {
        try {
            action.run();
        } catch (IllegalArgumentException e) {
            System.out.println("操作被拒绝:" + e.getMessage());
        }
    }

    static String describe(Optional<Student> student) {
        return student.map(Student::toString).orElse("未找到");
    }
}

final class Student {
    private final String id;
    private final String name;
    private int score;

    Student(String id, String name, int score) {
        if (id == null || id.isBlank() || name == null || name.isBlank()) {
            throw new IllegalArgumentException("学号和姓名不能为空");
        }
        this.id = id;
        this.name = name;
        updateScore(score);
    }

    String getId() {
        return id;
    }

    void updateScore(int score) {
        // 先校验再赋值:校验失败时旧成绩保持不变
        if (score < 0 || score > 100) {
            throw new IllegalArgumentException("成绩必须在 0 到 100 之间:" + score);
        }
        this.score = score;
    }

    @Override
    public String toString() {
        return id + " - " + name + " - " + score;
    }
}

class StudentService {
    // 学号作键;LinkedHashMap 保留录入顺序,列表输出稳定
    private final Map<String, Student> students = new LinkedHashMap<>();

    void add(Student student) {
        // 学号已存在时 putIfAbsent 返回旧值,且不会覆盖原有学生
        if (students.putIfAbsent(student.getId(), student) != null) {
            throw new IllegalArgumentException("学号已存在:" + student.getId());
        }
    }

    Optional<Student> find(String id) {
        return Optional.ofNullable(students.get(id));
    }

    void updateScore(String id, int score) {
        Student student = students.get(id);
        if (student == null) {
            throw new IllegalArgumentException("学生不存在:" + id);
        }
        student.updateScore(score);
    }

    boolean remove(String id) {
        return students.remove(id) != null;
    }

    List<Student> findAll() {
        // 按录入顺序返回只读快照,调用方无法借此改动内部 Map
        return List.copyOf(students.values());
    }
}

错误信息里都带上了学号或成绩值。真实项目里这类提示会进入日志,只写“学号已存在”而不写是哪个学号,排查时就无从下手。

运行与验收

-encoding UTF-8 让编译器按 UTF-8 读取源码。JDK 17 及更早版本在中文 Windows 上默认按 GBK 读取,不加这个参数中文会乱码甚至编译失败。

bash
javac -encoding UTF-8 Main.java
java Main

预期输出:

text
操作被拒绝:学号已存在:S001
操作被拒绝:成绩必须在 0 到 100 之间:120
全部学生:
S001 - 小王 - 95
S002 - 小李 - 92
查询 S001:S001 - 小王 - 95
查询 S009:未找到
删除 S002:true
当前人数:1

逐行对照需求验收:

  1. 前两行说明重复学号和越界成绩都被拒绝,提示里能看出具体是哪个值出了问题。
  2. 列表中仍是小王和小李,小李的成绩仍是 92,说明被拒绝的操作没有改动任何数据。
  3. 列表顺序与录入顺序一致,多次运行结果相同。
  4. 查询不存在的 S009 得到“未找到”,而不是打印 null。
  5. 删除后人数从 2 变为 1,remove 的返回值能告诉调用方是否真的删掉了数据。

扩展练习

  1. 用 Scanner 实现菜单,支持新增、查询、修改成绩、删除、列表和退出。输入非数字成绩时提示重新输入,程序不能退出。数字格式错误属于交互层的问题,应在 Main 中处理,不要放进 StudentService。
  2. 在 StudentService 中增加成绩统计,返回平均分、最高分和最低分。没有学生时要返回明确的结果,例如“暂无数据”,而不是抛出异常或输出 NaN。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

综合实战项目:学生管理系统

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通