基于 AI 编程助手的在线图书借阅平台设计与实现

Book 实体则需记录馆藏总数与剩余可借数量，用于库存校验。

（2）数据传输对象（DTO）

DTO 用于接收前端请求参数，并配合参数校验注解确保数据合法性。例如 BorrowBookDTO 需校验学生 ID 和图书编号是否为空，借阅天数是否超出限制。

package com.student.library.dto;

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

@Data
public class BorrowBookDTO {
    @NotNull(message = "学生 ID 不能为空")
    private Long studentId;
    
    @NotNull(message = "图书编号不能为空")
    private Long bookNo;
    
    @NotNull(message = "借阅天数不能为空")
    private Integer borrowDays = 30;
}

（3）视图对象（VO）

VO 用于向前端返回数据，需隐藏敏感字段。例如 BookDetailVO 展示分类名称而非 ID，并计算是否可借状态。

（4）业务逻辑层（Service）

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 lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import java.time.LocalDate;

@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());
        
        // 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. 生成借阅记录
        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);

        // 4. 更新库存
        book.setAvailableCount(book.getAvailableCount() - 1);
        bookMapper.updateById(book);

        save(borrowRecord);
        return borrowRecord;
    }
}

网页展示

前端采用 Bootstrap 5 实现响应式布局，适配电脑端浏览场景。

1. 图书查询页

顶部设置搜索栏，左侧为分类筛选，中间以卡片形式展示图书列表。卡片显示书名、作者、剩余可借数量。当库存为 0 时，右上角显示红色'无库存'标签。支持分页加载，每页默认 12 条数据。

2. 借阅记录页

表格展示未归还记录，包含到期时间与剩余天数。若剩余天数小于 3 天，字体标红并提示'即将超期'。提供续借与归还预约按钮，超期后禁止续借。

3. 图书管理页

管理员专用页面，支持添加、编辑、下架图书。当剩余可借数量低于总藏量的 1/3 时，列内容高亮提醒补充馆藏。

优化与调试

1. 核心优化

• 密码安全：集成 Spring Security 的 BCrypt 加密，登录时校验哈希值，杜绝明文存储。
• 超期逻辑：在查询借阅记录时计算剩余天数，自动标记超期状态，并在前端展示提醒文案。
• 分类扩展：补充分类管理接口，支持动态维护图书分类体系。

2. 常见问题解决

• 数据库连接失败：检查 application.yml 中的数据库密码配置，确保与本地 MySQL 一致。
• 库存未扣减：排查事务方法中是否遗漏了 updateById 调用，确保借阅成功后同步更新图书表。

总结

本项目展示了如何利用 AI 编程助手快速搭建规范的 Spring Boot 应用。通过自动化生成基础代码，开发者可以将精力集中在业务逻辑与用户体验上。对于课程设计或小型系统开发而言，这种模式有效降低了门槛，提升了交付质量。后续可进一步拓展预约功能、罚款计算等模块，完善平台生态。