图书借还、逾期罚款核心业务逻辑完整代码讲解

一、前言
上一篇完成了环境配置与事务踩坑总结，本篇进入核心业务开发，包含图书借阅、图书归还、逾期罚款计算三大核心功能，提供完整可运行代码，覆盖参数校验、事务控制、边界处理，直接适配毕设 / 实训项目。
二、通用实体与 DTO

1. 借阅 DTO（接收前端参数）
   java
   运行
   @Data
   public class BorrowDTO {
   @NotNull(message = “用户ID不能为空”)
   private Long userId;
   @NotNull(message = “图书ID不能为空”)
   private Long bookId;
   }

2. 统一返回结果
   java
   运行
   @Data
   @AllArgsConstructor
   @NoArgsConstructor
   public class Result {
   private Integer code;
   private String msg;
   private T data;

   public static Result success(T data) {
   return new Result<>(200, “操作成功”, data);
   }
   public static Result error(String msg) {
   return new Result<>(500, msg, null);
   }
   }
   三、核心业务代码实现

3. 图书借阅（核心：库存扣减 + 记录插入 + 事务控制）
   java
   运行
   @Service
   @Slf4j
   public class BorrowServiceImpl implements BorrowService {

   @Autowired
   private BookMapper bookMapper;
   @Autowired
   private BorrowRecordMapper borrowRecordMapper;

   @Override
   @Transactional(rollbackFor = Exception.class)
   public Result borrowBook(BorrowDTO dto) {
   // 1. 校验参数
   if(dto.getUserId() == null || dto.getBookId() == null) {
   return Result.error(“参数不能为空”);
   }
   // 2. 加锁查询图书（防止超卖）
   Book book = bookMapper.getBookByIdLock(dto.getBookId());
   if(book == null) {
   return Result.error(“图书不存在”);
   }
   if(book.getStock() <= 0) {
   return Result.error(“图书库存不足”);
   }
   // 3. 校验是否已借阅（未归还）
   Integer count = borrowRecordMapper.selectNoReturn(dto.getUserId(), dto.getBookId());
   if(count > 0) {
   return Result.error(“该图书已借阅，未归还”);
   }
   // 4. 扣减库存
   bookMapper.updateStock(dto.getBookId(), -1);
   // 5. 插入借阅记录
   BorrowRecord record = new BorrowRecord();
   record.setUserId(dto.getUserId());
   record.setBookId(dto.getBookId());
   record.setBorrowTime(new Date());
   record.setStatus(1); // 1-借阅中
   record.setFine(BigDecimal.ZERO);
   borrowRecordMapper.insert(record);

   log.info("用户{}借阅图书{}成功", dto.getUserId(), dto.getBookName()); return Result.success("借阅成功");

   }
   }

4. 图书归还（核心：库存归还 + 状态更新 + 逾期计算）
   java
   运行
   @Override
   @Transactional(rollbackFor = Exception.class)
   public Result returnBook(Long recordId) {
   // 1. 查询借阅记录
   BorrowRecord record = borrowRecordMapper.selectById(recordId);
   if(record == null) {
   return Result.error(“借阅记录不存在”);
   }
   if(record.getStatus() == 2) {
   return Result.error(“该图书已归还”);
   }
   // 2. 计算逾期罚款
   BigDecimal fine = calculateFine(record.getBorrowTime());
   // 3. 更新归还信息
   record.setReturnTime(new Date());
   record.setStatus(fine.compareTo(BigDecimal.ZERO) > 0 ? 3 : 2); // 3-逾期 2-正常归还
   record.setFine(fine);
   borrowRecordMapper.updateById(record);
   // 4. 增加库存
   bookMapper.updateStock(record.getBookId(), 1);

   log.info(“图书归还成功，罚款金额：{}”, fine);
   return Result.success(fine);
   }

5. 逾期罚款计算逻辑（通用规则：逾期 1 天罚 1 元）
   java
   运行
   /**

• 计算逾期罚款
• @param borrowTime 借阅时间（默认借阅期限7天）
  */
  private BigDecimal calculateFine(Date borrowTime) {
  // 借阅期限：7天
  long expireTime = borrowTime.getTime() + 7L * 24 * 60 * 60 * 1000;
  long now = System.currentTimeMillis();
  // 未逾期
  if(now <= expireTime) {
  return BigDecimal.ZERO;
  }
  // 计算逾期天数
  long days = (now - expireTime) / (1000 * 60 * 60 * 24);
  // 每天罚款1元
  return new BigDecimal(days).multiply(new BigDecimal(“1.00”));
  }
  四、Mapper 层代码（关键 SQL）

1. BookMapper
   java
   运行
   public interface BookMapper {
   // 加锁查询图书
   Book getBookByIdLock(Long id);
   // 更新库存（num=+1归还，-1借阅）
   int updateStock(@Param(“id”) Long id, @Param(“num”) Integer num);
   }
   xml
   
   update book set stock = stock + #{num} where id = #{id}
   
2. BorrowRecordMapper
   java
   运行
   public interface BorrowRecordMapper {
   // 查询未归还记录
   Integer selectNoReturn(@Param(“userId”) Long userId, @Param(“bookId”) Long bookId);
   }
   五、边界情况处理
   图书不存在 / 已删除：直接返回错误；
   库存不足：禁止借阅；
   重复借阅：校验未归还记录；
   重复归还：判断状态拦截；
   逾期 0 天：罚款为 0，标记正常归还。
   六、总结
   本篇实现了图书借阅、归还、逾期罚款三大核心业务，代码完整可直接运行，严格遵循事务控制、并发安全、边界校验原则。所有逻辑贴合真实业务，无冗余代码，适配 SpringBoot 项目，下一篇将总结复杂业务中事务一致性的深度解决方案与实训心得。