在线图书借阅平台的设计与实现

Book.java（图书实体）

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;

@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）DTO 包：数据传输对象

BorrowBookDTO.java（借阅请求 DTO）

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 包：视图对象

BookDetailVO.java（图书详情 VO）

package com.student.library.vo;

import lombok.Data;
import java.time.LocalDateTime;

@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;
}

（4）Service 包：业务逻辑实现

BorrowServiceImpl.java（借阅服务）

这里展示了核心的借阅与续借逻辑，包含库存校验和事务控制。

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());
        
        // 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 || book.getAvailableCount() <= 0) {
            throw new RuntimeException("图书不存在或无库存");
        }
        
        // 3. 生成借阅记录
        BorrowRecord record = new BorrowRecord();
        record.setStudentId(borrowBookDTO.getStudentId());
        record.setBookNo(borrowBookDTO.getBookNo());
        record.setBorrowDate(LocalDate.now());
        record.setDueDate(LocalDate.now().plusDays(borrowBookDTO.getBorrowDays()));
        record.setReturnStatus(0);
        
        // 4. 更新库存
        book.setAvailableCount(book.getAvailableCount() - 1);
        bookMapper.updateById(book);
        
        save(record);
        return record;
    }

    @Override
    @Transactional
    public BorrowRecord renewBook(Long recordId) {
        BorrowRecord record = getById(recordId);
        if (record == null || record.getReturnStatus() == 1) {
            throw new RuntimeException("记录不存在或已归还");
        }
        if (LocalDate.now().isAfter(record.getDueDate())) {
            throw new RuntimeException("图书已超期，无法续借");
        }
        if (record.getRenewCount() >= 1) {
            throw new RuntimeException("已达续借上限");
        }
        
        record.setDueDate(record.getDueDate().plusDays(30));
        record.setRenewCount(record.getRenewCount() + 1);
        updateById(record);
        return record;
    }
}

网页展示

前端采用 Bootstrap 实现响应式布局，界面简洁清晰。

1. 图书查询页

顶部为搜索栏，左侧为分类筛选，中间以卡片形式展示图书列表。剩余可借数量为 0 时显示红色标签，支持分页浏览。

2. 借阅记录页

表格展示未归还记录，包含到期时间、剩余天数。即将超期（≤3 天）显示红色字体，超期后禁止续借。

3. 图书管理页

管理员端页面，支持添加、编辑、下架图书。低库存时会有颜色提示，方便补充馆藏。

优化与调试

1. 核心优化点

• 密码加密：集成 Spring Security 的 BCrypt 加密，避免明文存储。
• 超期提醒：在查询借阅记录时计算剩余天数，前端动态展示提醒信息。
• 分类管理：补充了图书分类的增删改查功能，提升灵活性。

2. 常见问题解决

• 数据库连接失败：检查 application.yml 中的密码配置，确保与本地数据库一致。
• 库存未减少：检查事务方法是否漏调 updateById，补充后恢复正常。

总结

本项目利用 AI 辅助工具降低了基础代码的编写门槛，让我们能更专注于核心业务逻辑的实现。通过规范的表结构设计、严谨的事务控制以及友好的前端交互，最终实现了功能完整的在线图书借阅系统。对于课程设计或小型项目开发，这种'AI 辅助 + 人工审核'的模式能有效提升开发效率与代码质量。