在线图书借阅平台的设计与实现：AI 辅助开发实践

2.2 图书资源管理

图书服务层实现了增删改查及按分类查询的逻辑。在新增和更新时，需校验 ISBN 是否存在以避免重复录入。

package com.library.service.impl;

import com.library.dto.BookDTO;
import com.library.dto.BookQuery;
import com.library.entity.BookDO;
import com.library.repository.BookRepository;
import com.library.service.BookService;
import org.springframework.beans.BeanUtils;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;

@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 bookDTO = new BookDTO(); BeanUtils.copyProperties(bookDO, bookDTO); return bookDTO; })
                .collect(Collectors.toList());
        return RestResult.success("调用成功", bookDTOS);
    }
}

2.3 借阅与事务控制

借阅操作涉及库存扣减和记录生成，必须保证原子性。使用 @Transactional 注解确保数据一致性，若任一环节失败则回滚。

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

2.4 逾期管理与定时任务

系统需每日凌晨检查逾期未还记录，计算违约金并更新用户状态。超过一定期限的用户将被标记为黑名单。

@Component
public class OverdueTask {
    @Autowired
    private BorrowRecordService borrowRecordService;
    @Autowired
    private UserService userService;

    @Scheduled(cron = "0 0 0 * * ?")
    public void checkOverdue() {
        LocalDateTime now = LocalDateTime.now();
        List<BorrowRecord> overdueRecords = borrowRecordService.list(
            new LambdaQueryWrapper<BorrowRecord>()
                .lt(BorrowRecord::getDueDate, now)
                .eq(BorrowRecord::getStatus, 0)
        );
        overdueRecords.forEach(record -> {
            long daysOverdue = ChronoUnit.DAYS.between(record.getDueDate(), now);
            User user = userService.getById(record.getUserId());
            user.setFineAmount(user.getFineAmount() + (int) daysOverdue);
            if (daysOverdue > 30) {
                user.setRole(1); // 标记为黑名单
            }
            userService.updateById(user);
            record.setStatus(1);
            borrowRecordService.updateById(record);
        });
    }
}

三、优化与调试心得

3.1 SQL 性能瓶颈

当图书总量超过 1 万条时，库存查询耗时可能增加。解决方案包括添加索引和优化查询字段。

• 添加索引：ALTER TABLE book ADD INDEX idx_available (available_count);
• 优化查询：仅返回必要字段（如 id, title, available_count），避免全表扫描。 优化后查询时间可从 2 秒以上降至 120ms 左右。

3.2 JWT 令牌过期处理

默认令牌有效期较短可能导致频繁登录。调整 JwtUtil 中的过期时间配置至 2 小时，并在前端配合拦截器实现自动刷新机制。

3.3 代码规范性

初始生成的代码虽功能完整，但部分命名可读性不足。建议统一响应格式结构 {code: 200, msg: "success", data: {...}}，并在关键业务方法中添加日志注解，记录操作流水以便排查问题。

四、总结

本项目利用 AI 辅助工具加速了基础代码的生成，重点解决了业务逻辑中的事务一致性与性能问题。通过合理的分层设计与索引优化，系统能够稳定支撑日常借阅业务。对于复杂规则扩展，仍需结合具体场景进行人工逻辑补充。