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

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;

/**
 * <p>
 * 图书实体类：映射 book 表，记录图书基本信息与库存状态
 * </p>
 */
@Data
@NoArgsConstructor
@AllArgsConstructor
@TableName("book")
public class Book {
    /**
     * 图书编号：主键，自增
     */
    @TableId(type = IdType.AUTO)
    private Long bookNo;

    /**
     * 书名：非空
     */
    private String bookName;

    /**
     * 作者：非空
     */
    private String author;

    /**
     * 图书分类：关联 category 表
     */
    private Long categoryId;

    /**
     * 出版社：图书出版机构
     */
    private String publisher;

    /**
     * 出版日期：图书出版时间
     */
    private LocalDateTime publishDate;

    /**
     * 馆藏总数：图书馆拥有的该图书总数量
     */
    private Integer totalCount;

    /**
     * 剩余可借数量：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;

/**
 * <p>
 * 图书借阅请求 DTO：接收学生借阅时的参数，含参数校验
 * </p>
 */
@Data
public class BorrowBookDTO {
    /**
     * 学生 ID：必填
     */
    @NotNull(message = "学生 ID 不能为空")
    private Long studentId;

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

    /**
     * 借阅天数：必填，默认 30 天
     */
    @NotNull(message = "借阅天数不能为空")
    private Integer borrowDays = 30;
}

（3）vo 包：视图对象（向前端隐藏敏感字段）

BookDetailVO.java（图书详情 VO，给学生展示）

package com.student.library.vo;

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

/**
 * <p>
 * 图书详情 VO：封装学生查看图书时需要的信息，隐藏敏感字段
 * </p>
 */
@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;

/**
 * <p>
 * 借阅服务实现类：处理图书借阅、续借、归还等核心业务
 * </p>
 */
@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. 生成借阅记录
        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;
    }

    /**
     * 学生续借图书（核心逻辑：校验是否超期、限制续借次数）
     */
    @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);
        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">
    <style>
        .category-item { transition: all 0.2s; }
        .category-item:hover, .category-item.active { background-color: #0d6efd; color: white !important; }
        .book-card { transition: transform 0.3s, box-shadow 0.3s; }
        .book-card:hover { transform: translateY(-5px); box-shadow: 0 10px 20px rgba(0,0,0,0.1); }
        .no-stock { position: absolute; top: 10px; right: 10px; }
    </style>
</head>
<body>
    <!-- 导航栏 -->
    <nav class="navbar navbar-expand-lg navbar-dark bg-primary mb-4">
        <div class="container">
            <a class="navbar-brand" href="#"><i class="fa fa-book mr-2"></i>校园图书馆</a>
            <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav">
                <span class="navbar-toggler-icon"></span>
            </button>
            <div class="collapse navbar-collapse" id="navbarNav">
                <ul class="navbar-nav ms-auto">
                    <li class="nav-item"><a class="nav-link active" href="book-search.html">图书查询</a></li>
                    <li class="nav-item"><a class="nav-link" href="borrowing-record.html">借阅记录</a></li>
                    <li class="nav-item"><a class="nav-link" href="#">个人中心</a></li>
                </ul>
            </div>
        </div>
    </nav>
    <div class="container">
        <h3 class="mb-4">图书查询</h3>
        <!-- 搜索栏 -->
        <div class="row mb-4">
            <div class="col-md-8 offset-md-2">
                <div class="input-group">
                    <input type="text" class="form-control" placeholder="请输入书名或作者进行搜索..." id="searchInput">
                    <button class="btn btn-primary" type="button" id="searchBtn"><i class="fa fa-search mr-1"></i>搜索</button>
                </div>
            </div>
        </div>
        <div class="row">
            <!-- 分类筛选栏 -->
            <div class="col-md-3 mb-4">
                <div class="card">
                    <div class="card-header bg-light"><h5 class="mb-0">图书分类</h5></div>
                    <div class="list-group list-group-flush">
                        <a href="#" class="list-group-item list-group-item-action category-item active">全部图书</a>
                        <a href="#" class="list-group-item list-group-item-action category-item">计算机类</a>
                        <a href="#" class="list-group-item list-group-item-action category-item">文学类</a>
                    </div>
                </div>
            </div>
            <!-- 图书列表 -->
            <div class="col-md-9">
                <div class="row">
                    <div class="col-md-4 mb-4">
                        <div class="card book-card h-100">
                            <img src="https://picsum.photos/id/24/300/400" class="card-img-top" alt="Java 编程思想">
                            <div class="card-body">
                                <h5 class="card-title">Java 编程思想</h5>
                                <p class="card-text text-muted">作者：Bruce Eckel</p>
                                <p class="card-text"><small>剩余可借：<span class="text-success">5</span>/10</small></p>
                                <a href="#" class="btn btn-primary btn-sm w-100">查看详情</a>
                            </div>
                        </div>
                    </div>
                </div>
            </div>
        </div>
    </div>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/js/bootstrap.bundle.min.js"></script>
</body>
</html>

2. 借阅记录页

• 布局：表格形式展示所有未归还的借阅记录；
• 核心功能：剩余天数小于 3 天时显示红色字体；点击'续借'按钮完成续借；
• 细节设计：表格上方有'超期提醒'模块。

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>借阅记录 - 校园图书馆系统</title>
    <link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet">
    <style>
        .overdue-alert { border-left: 4px solid #dc3545; }
        .soon-expire { color: #dc3545; font-weight: bold; }
    </style>
</head>
<body>
    <div class="container">
        <h3 class="mb-4">借阅记录</h3>
        <!-- 超期提醒 -->
        <div class="alert alert-danger overdue-alert mb-4">
            <h5 class="alert-heading"><i class="fa fa-exclamation-circle mr-2"></i>超期提醒</h5>
            <p>您有 1 本图书已超期未还，请尽快归还。</p>
        </div>
        <!-- 借阅记录表格 -->
        <div class="card">
            <div class="card-body">
                <table class="table table-hover">
                    <thead class="table-light">
                        <tr><th>图书名称</th><th>作者</th><th>借阅时间</th><th>到期时间</th><th>剩余天数</th><th>操作</th></tr>
                    </thead>
                    <tbody>
                        <tr>
                            <td>Java 编程思想</td><td>Bruce Eckel</td><td>2023-05-10</td><td>2023-06-10</td>
                            <td class="soon-expire">2 天 <span class="badge bg-danger">即将超期</span></td>
                            <td><button class="btn btn-sm btn-primary">续借</button></td>
                        </tr>
                    </tbody>
                </table>
            </div>
        </div>
    </div>
</body>
</html>

3. 图书管理页

• 布局：顶部'添加图书'按钮，下方是图书管理表格；
• 核心功能：点击'编辑'修改图书信息，点击'下架'将图书设为不可借；
• 细节设计：剩余可借数量小于总数的 1/3 时，显示黄色字体提醒补充馆藏。

五、优化与调试

1. 核心优化点

• 密码加密：集成 Spring Security 的 BCrypt 加密，在注册方法中将明文密码转为加密字符串，登录时用 bCryptPasswordEncoder.matches() 校验。
• 超期提醒：在查询借阅记录方法中，添加'剩余天数计算'逻辑，当剩余天数≤3 天时，在前端显示红色提醒；超期后禁止续借。
• 图书分类管理：补充 CategoryController 和 CategoryService，支持管理员添加/编辑图书分类。

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

• 问题 1：启动项目提示'数据库连接失败'。原因：application.yml 中 MySQL 密码为默认值。解决：修改为本地数据库密码。
• 问题 2：借阅后'剩余可借数量'未减少。原因：忘记调用 bookMapper.updateById(book)。解决：补充该代码。

六、总结

本系统实现了基于 Spring Boot 的在线图书借阅平台，涵盖了用户管理、图书管理及借阅记录等核心功能。后端采用 Java 语言构建，前端使用 Thymeleaf 结合 Bootstrap 实现响应式布局。文章详细展示了实体类、数据传输对象、业务逻辑层代码以及关键页面的 HTML 结构，并涵盖了密码加密、库存校验及调试过程中的问题解决方案。后续可进一步扩展图书预约及罚款对接功能。