飞算JavaAI实战：在线图书借阅平台设计与实现

确认需求后，工具会继续往下走，自动完成接口设计、表结构设计、处理逻辑和源码生成。生成后的项目结构比较清晰，实体、DTO、VO、Mapper、Service、Controller、Config 等包基本都替我搭好了，省掉了大量重复性的建包和写骨架代码工作。

com.student.library
├─ entity          // 实体类（映射数据库表）
│  ├─ User.java
│  ├─ Book.java
│  ├─ BorrowRecord.java
│  └─ Category.java
├─ dto             // 数据传输对象（接收前端请求参数）
│  ├─ UserRegisterDTO.java
│  ├─ BookAddDTO.java
│  ├─ BorrowBookDTO.java
│  └─ BookQueryDTO.java
├─ vo              // 视图对象（向前端返回数据）
│  ├─ BookDetailVO.java
│  ├─ BorrowRecordVO.java
│  └─ UserBorrowVO.java
├─ mapper          // 数据访问接口（MyBatis-Plus）
│  ├─ UserMapper.java
│  ├─ BookMapper.java
│  └─ BorrowRecordMapper.java
├─ service         // 业务逻辑层
│  ├─ UserService.java
│  ├─ BookService.java
│  └─ BorrowService.java
├─ controller      // 接口控制层
│  ├─ UserController.java
│  ├─ BookController.java
│  └─ BorrowController.java
└─ config          // 配置类
   └─ WebConfig.java

2. 核心代码展示

飞算生成的代码整体是规范的，参数校验、事务控制、注释这些基础能力都考虑到了。我后来主要做的是补足一些课程设计里更贴近实际的细节，比如超期提醒、借阅规则限制，以及少量字段的业务含义调整。

2.1 entity 包：核心实体类

User.java 用来区分学生和管理员，学生账号保存学号，管理员账号保存工号；Book.java 则记录图书的库存、剩余可借数量等信息。这里有个点值得留意：availableCount 不是简单字段，它后面会直接影响借阅和展示逻辑，所以设计时最好和 totalCount 对应起来。

package com.student.library.entity;

import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

import java.time.LocalDateTime;

/**
 * 用户实体类：映射 user 表，区分学生（role=0）和管理员（role=1）
 */
@Data
@NoArgsConstructor
@AllArgsConstructor
@TableName("user")
public class User {

    /** 用户ID：主键，自增 */
    @TableId(type = IdType.AUTO)
    private Long id;

    /** 账号：学生填学号，管理员填工号 */
    private String account;

    /** 密码：建议存储加密后的字符串 */
    private String password;

    /** 姓名 */
    private String name;

    /** 角色：0=学生，1=管理员 */
    private Integer role;

    /** 班级：仅学生有值 */
    private String className;

    /** 邮箱：用于接收提醒 */
    private String email;

    /** 创建时间 */
    private LocalDateTime createTime;
}

package com.student.library.entity;

import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

import java.time.LocalDateTime;

/**
 * 图书实体类：映射 book 表，记录图书基本信息与库存状态
 */
@Data
@NoArgsConstructor
@AllArgsConstructor
@TableName("book")
public class Book {

    /** 图书编号：主键，自增 */
    @TableId(type = IdType.AUTO)
    private Long bookNo;

    /** 书名 */
    private String bookName;

    /** 作者 */
    private String author;

    /** 图书分类 */
    private Long categoryId;

    /** 出版社 */
    private String publisher;

    /** 出版日期 */
    private LocalDateTime publishDate;

    /** 馆藏总数 */
    private Integer totalCount;

    /** 剩余可借数量 */
    private Integer availableCount;

    /** 图书简介 */
    private String description;
}

2.2 dto 包：数据传输对象

DTO 的作用很直接：把前端提交的数据和内部实体隔开。这样做的好处是，接口更干净，校验也能集中放在入参上，不用把所有逻辑都堆到 Service 里。

package com.student.library.dto;

import jakarta.validation.constraints.NotNull;
import lombok.Data;

/**
 * 图书借阅请求 DTO：接收学生借阅时的参数
 */
@Data
public class BorrowBookDTO {

    /** 学生ID */
    @NotNull(message = "学生ID不能为空")
    private Long studentId;

    /** 图书编号 */
    @NotNull(message = "图书编号不能为空")
    private Long bookNo;

    /** 借阅天数 */
    @NotNull(message = "借阅天数不能为空")
    private Integer borrowDays = 30;
}

package com.student.library.dto;

import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Positive;
import lombok.Data;

import java.time.LocalDateTime;

/**
 * 图书添加请求 DTO：接收管理员添加图书的参数
 */
@Data
public class BookAddDTO {

    /** 书名 */
    @NotBlank(message = "书名不能为空")
    private String bookName;

    /** 作者 */
    @NotBlank(message = "作者不能为空")
    private String author;

    /** 分类ID */
    @NotNull(message = "图书分类不能为空")
    private Long categoryId;

    /** 出版社 */
    @NotBlank(message = "出版社不能为空")
    private String publisher;

    /** 出版日期 */
    @NotNull(message = "出版日期不能为空")
    private LocalDateTime publishDate;

    /** 馆藏总数 */
    @NotNull(message = "馆藏总数不能为空")
    @Positive(message = "馆藏总数必须大于0")
    private Integer totalCount;

    /** 图书简介 */
    private String description;
}

2.3 vo 包：视图对象

VO 主要负责把前端真正需要看的内容整理出来，像分类 ID、内部状态这些字段就没有必要直接暴露。这样页面展示更清楚，接口也更安全。

package com.student.library.vo;

import lombok.Data;

import java.time.LocalDateTime;

/**
 * 图书详情 VO：给学生展示图书时需要的信息
 */
@Data
public class BookDetailVO {

    /** 图书编号 */
    private Long bookNo;

    /** 书名 */
    private String bookName;

    /** 作者 */
    private String author;

    /** 图书分类名称 */
    private String categoryName;

    /** 出版社 */
    private String publisher;

    /** 出版日期 */
    private LocalDateTime publishDate;

    /** 剩余可借数量 */
    private Integer availableCount;

    /** 图书简介 */
    private String description;

    /** 是否可借 */
    private Boolean canBorrow;
}

2.4 service 包：业务逻辑实现

借阅服务是整个系统里最核心的一块。这里要做的事情看起来不复杂，但细节不少：先确认学生身份，再检查图书是否存在和是否有库存，接着判断借阅天数是否超限，最后才是扣库存、写借阅记录。

package com.student.library.service.impl;

import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.student.library.dto.BorrowBookDTO;
import com.student.library.entity.Book;
import com.student.library.entity.BorrowRecord;
import com.student.library.entity.User;
import com.student.library.mapper.BookMapper;
import com.student.library.mapper.BorrowRecordMapper;
import com.student.library.mapper.UserMapper;
import com.student.library.service.BorrowService;
import com.student.library.vo.BorrowRecordVO;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.BeanUtils;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;

import java.time.LocalDate;
import java.time.temporal.ChronoUnit;
import java.util.List;
import java.util.stream.Collectors;

/**
 * 借阅服务实现类：处理图书借阅、续借、归还等核心业务
 */
@Slf4j
@Service
@RequiredArgsConstructor
public class BorrowServiceImpl extends ServiceImpl<BorrowRecordMapper, BorrowRecord> implements BorrowService {

    private final BorrowRecordMapper borrowRecordMapper;
    private final BookMapper bookMapper;
    private final UserMapper userMapper;

    /** 学生借阅图书 */
    @Override
    @Transactional
    public BorrowRecord borrowBook(BorrowBookDTO borrowBookDTO) {
        log.info("学生借阅图书：学生ID={}，图书编号={}，借阅天数={}",
                borrowBookDTO.getStudentId(), borrowBookDTO.getBookNo(), borrowBookDTO.getBorrowDays());

        // 1. 校验学生身份
        User student = userMapper.selectById(borrowBookDTO.getStudentId());
        if (student == null || student.getRole() != 0) {
            throw new RuntimeException("无效的学生账号，无法借阅图书");
        }

        // 2. 校验图书状态
        Book book = bookMapper.selectById(borrowBookDTO.getBookNo());
        if (book == null) {
            throw new RuntimeException("该图书不存在");
        }
        if (book.getAvailableCount() <= 0) {
            throw new RuntimeException("该图书已无库存，可尝试预约");
        }

        // 3. 校验借阅天数
        if (borrowBookDTO.getBorrowDays() > 60) {
            throw new RuntimeException("单次借阅最多60天，请调整借阅天数");
        }

        // 4. 生成借阅记录
        BorrowRecord borrowRecord = new BorrowRecord();
        borrowRecord.setStudentId(borrowBookDTO.getStudentId());
        borrowRecord.setBookNo(borrowBookDTO.getBookNo());
        borrowRecord.setBorrowDate(LocalDate.now());
        borrowRecord.setDueDate(LocalDate.now().plusDays(borrowBookDTO.getBorrowDays()));
        borrowRecord.setReturnStatus(0);

        // 5. 扣减库存
        book.setAvailableCount(book.getAvailableCount() - 1);
        bookMapper.updateById(book);

        // 6. 保存借阅记录
        save(borrowRecord);
        log.info("图书借阅成功：借阅记录ID={}，到期时间={}", borrowRecord.getId(), borrowRecord.getDueDate());
        return borrowRecord;
    }

    /** 学生续借图书 */
    @Override
    @Transactional
    public BorrowRecord renewBook(Long recordId) {
        log.info("学生续借图书：借阅记录ID={}", recordId);

        BorrowRecord record = getById(recordId);
        if (record == null) {
            throw new RuntimeException("借阅记录不存在");
        }
        if (record.getReturnStatus() == 1) {
            throw new RuntimeException("该图书已归还，无需续借");
        }
        if (LocalDate.now().isAfter(record.getDueDate())) {
            throw new RuntimeException("图书已超期，请先归还并处理罚款");
        }
        if (record.getRenewCount() >= 1) {
            throw new RuntimeException("该图书已续借1次，无法再次续借");
        }

        record.setDueDate(record.getDueDate().plusDays(30));
        record.setRenewCount(record.getRenewCount() + 1);
        updateById(record);

        log.info("图书续借成功：借阅记录ID={}，新到期时间={}", recordId, record.getDueDate());
        return record;
    }

    /** 查询学生的借阅记录（含超期提醒） */
    @Override
    public List<BorrowRecordVO> getStudentBorrowRecords(Long studentId) {
        List<BorrowRecord> recordList = lambdaQuery()
                .eq(BorrowRecord::getStudentId, studentId)
                .eq(BorrowRecord::getReturnStatus, 0)
                .list();

        return recordList.stream().map(record -> {
            BorrowRecordVO vo = new BorrowRecordVO();
            BeanUtils.copyProperties(record, vo);

            Book book = bookMapper.selectById(record.getBookNo());
            vo.setBookName(book.getBookName());
            vo.setAuthor(book.getAuthor());

            long daysLeft = ChronoUnit.DAYS.between(LocalDate.now(), record.getDueDate());
            vo.setDaysLeft((int) daysLeft);
            if (daysLeft < 0) {
                vo.setOverdueReminder("已超期" + (-daysLeft) + "天，请尽快归还");
            } else if (daysLeft <= 3) {
                vo.setOverdueReminder("即将超期，剩余" + daysLeft + "天");
            } else {
                vo.setOverdueReminder("正常借阅中");
            }
            return vo;
        }).collect(Collectors.toList());
    }
}

四、网页展示

前端我采用了 Bootstrap 做响应式布局，界面不追求花哨，但要够清楚，尤其是图书馆这种偏功能型场景，用户最在意的是信息能不能一眼看明白。

1. 图书查询页

这个页面的重点是'快速找到书'。顶部提供搜索框，左侧按分类筛选，中间显示图书卡片。库存为 0 时会直接标红，减少学生白跑一趟的情况。

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>图书查询 - 校园图书馆系统</title>
    <link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet">
    <link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/font-awesome.min.css" rel="stylesheet">
</head>
<body>
<!-- 页面内容省略 -->
</body>
</html>

2. 借阅记录页

借阅记录页主要解决两个问题：一是让学生知道自己借了什么，二是及时提醒快到期或已超期的图书。对实际使用来说，这个页面的价值比'看起来好看'更重要。

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>借阅记录 - 校园图书馆系统</title>
    <link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet">
    <link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/font-awesome.min.css" rel="stylesheet">
</head>
<body>
<!-- 页面内容省略 -->
</body>
</html>

3. 图书管理页

管理员端更偏操作效率。这里放了添加、编辑、下架这些功能，库存不足时也会给出提醒，方便及时补充馆藏。

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>图书管理 - 校园图书馆系统</title>
    <link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet">
    <link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/font-awesome.min.css" rel="stylesheet">
</head>
<body>
<!-- 页面内容省略 -->
</body>
</html>

五、优化与调试

源码生成后，我又根据课程设计要求做了几处补充，也顺手处理了两个调试中很常见的问题。

1. 核心优化点

• 密码加密：注册时不再直接保存明文密码，而是使用 BCrypt 加密后再写入数据库，登录时通过 matches() 校验。
• 超期提醒：在借阅记录查询里加入剩余天数计算，剩余 3 天以内做醒目提示，超期后禁止续借。
• 图书分类管理：补上分类增删改查，方便后续扩展'考研类''小说类'这类更细的分类。

2. 调试中遇到的问题及解决

• 数据库连接失败：原因通常是 application.yml 里的数据库密码或地址不对，改成本地 MySQL 的实际配置后即可恢复。
• 借阅后库存未变化：检查后发现是更新图书库存的代码漏写了，补上 bookMapper.updateById(book) 后问题解决。

六、自我感想

这次做完之后，我最大的感受不是'终于交作业了'，而是对项目开发这件事有了更完整的认识。

一方面，需求拆解真的比我想象中更重要。以前我总觉得'做一个借阅平台'就是一句话，真正动手才发现，背后要拆成注册登录、图书查询、借阅归还、权限控制、库存处理、超期提醒这些很具体的动作。飞算 JavaAI 在需求拆解上帮了我不少，它把我模糊的想法拉成了能执行的功能点。

另一方面，重复性工作被明显压缩后，我终于能把注意力放在真正需要思考的地方，比如业务规则、异常处理和页面交互。对学生来说，这种体验很难得，因为它不是单纯'省时间'，而是让你更早进入项目开发的正常节奏。

七、总结

这次在线图书借阅平台的开发，让我很直观地感受到飞算 JavaAI 的价值：它不是替你写完一切，而是把开发中最耗神的基础环节先铺好，让你能更专注地处理业务逻辑和课程设计的关键部分。

当然，这个系统还可以继续扩展，比如增加图书预约、罚款计算、消息通知这些功能，让它更接近真实的图书馆业务。后面如果继续迭代，我大概率还会沿着'先描述需求，再让工具拆解'的方式往下做，这种开发路径对新手确实友好。