基于 Spring Boot 的在线图书借阅平台设计与实现

2.2 用户控制器

注册时校验用户名唯一性，登录成功后生成 Token。

// controller/UserController.java
@RestController
@RequestMapping("/api/user")
public class UserController {
    @Autowired
    private UserService userService;

    @PostMapping("/register")
    public Result register(@RequestBody UserRegisterDTO dto) {
        if (userService.checkUsernameExists(dto.getUsername())) {
            return Result.error("用户名已存在");
        }
        User user = new User();
        user.setUsername(dto.getUsername());
        user.setPassword(BCrypt.hashpw(dto.getPassword(), BCrypt.gensalt()));
        user.setEmail(dto.getEmail());
        user.setRole(0);
        user.setCreateTime(LocalDateTime.now());
        userService.save(user);
        return Result.success("注册成功");
    }

    @PostMapping("/login")
    public Result login(@RequestBody UserLoginDTO dto) {
        User user = userService.getByUsername(dto.getUsername());
        if (user == null || !BCrypt.checkpw(dto.getPassword(), user.getPassword())) {
            return Result.error("用户名或密码错误");
        }
        String token = JwtUtil.generateToken(user.getId(), user.getRole());
        return Result.success(token);
    }
}

2.3 图书服务逻辑

图书管理涉及复杂的库存校验。在添加或修改图书时，需确保 ISBN 唯一性及字段完整性。

// service/BookServiceImpl.java
@Service
public class BookServiceImpl implements BookService {
    @Autowired
    private BookRepository bookRepository;

    @Override
    @Transactional
    public RestResult addBook(BookDTO bookDTO) {
        if (bookDTO.getIsbn() == null || bookDTO.getTitle() == null) {
            return RestResult.failure("参数不完整");
        }
        if (bookRepository.existsByIsbn(bookDTO.getIsbn())) {
            return RestResult.failure("该图书已存在");
        }
        BookDO bookDO = new BookDO();
        BeanUtils.copyProperties(bookDTO, bookDO);
        bookRepository.save(bookDO);
        return RestResult.success("调用成功", bookDTO);
    }

    @Override
    public RestResult getBooksByCategory(BookQuery bookQuery) {
        List<BookDO> books;
        if (bookQuery.getCategory() != null && !bookQuery.getCategory().isEmpty()) {
            books = bookRepository.findByCategory(bookQuery.getCategory());
        } else {
            books = bookRepository.findAll();
        }
        List<BookDTO> bookDTOS = books.stream()
                .map(bookDO -> { BookDTO b = new BookDTO(); BeanUtils.copyProperties(bookDO, b); return b; })
                .collect(Collectors.toList());
        return RestResult.success("调用成功", bookDTOS);
    }
}

2.4 借阅事务处理

借阅是典型的事务场景，必须保证库存扣减与记录创建的一致性。

// controller/BorrowController.java
@PostMapping("/borrow")
@Transactional
public Result borrowBook(@RequestParam Integer userId, @RequestParam Integer bookId) {
    Book book = bookService.getById(bookId);
    if (book == null || book.getAvailableCount() <= 0) {
        return Result.error("该图书暂无库存");
    }
    // 减少可借库存
    book.setAvailableCount(book.getAvailableCount() - 1);
    bookService.updateById(book);

    // 生成借阅记录
    BorrowRecord record = new BorrowRecord();
    record.setUserId(userId);
    record.setBookId(bookId);
    record.setBorrowDate(LocalDateTime.now());
    record.setDueDate(LocalDateTime.now().plusDays(30));
    record.setStatus(0);
    borrowRecordService.save(record);
    return Result.success("借书成功，应还日期：" + record.getDueDate());
}

三、优化与调试心得

3.1 SQL 性能瓶颈

当图书总量超过 1 万条时，SELECT * FROM book WHERE available_count > 0 耗时显著增加。

• 解决方案：添加索引 ALTER TABLE book ADD INDEX idx_available (available_count);
• 查询优化：在 Controller 层限定返回字段，避免全表数据回传。
• 效果：查询时间从 2.1s 降至 120ms。

3.2 JWT 令牌过期处理

默认 30 分钟过期导致频繁登出。调整 JwtUtil 中的 expiration 参数为 2 小时，并在前端配合拦截器实现无感刷新。

3.3 代码规范性

AI 生成的初始代码虽功能完整，但命名可读性需人工介入。

• 统一响应格式 {code: 200, msg: "success", data: {...}}
• 关键业务方法（如借阅、归还）添加日志注解，记录操作流水以便追踪。

四、总结

本项目通过标准化分层架构实现了完整的图书借阅闭环。利用 AI 辅助工具快速搭建基础 CRUD 结构，将精力集中在业务逻辑优化与性能调优上。最终工程结构清晰，符合企业级开发规范，具备良好的可维护性与扩展性。对于类似管理系统，建议重点关注库存并发控制与定时任务的准确性。