文章目录

• • 概要
  • 整体架构流程
  • 技术细节
  • 小结

概要

发放优惠券

处于暂停状态，或者待发放状态的优惠券，在优惠券列表中才会出现发放按钮，可以被发放：

需求分析以及接口设计

需要我们选择发放方式，使用期限。

发放方式分为两种：立刻发放和定时发放；使用期限也分两种：固定天数、固定时间段。如图：

 

因此，在提交这个表单时，参数包括：

• 发放（领用）开始时间：如果为空说明是立刻发放，开始时间就是当前时间

• 发放（领用）结束时间

• 有效期天数：如果为空说明是固定有效期

• 使用期限开始时间：如果为空说明是固定天数有效期

• 使用期限结束时间：如果为空说明是固定天数有效期

最后，肯定要带上优惠券id，我们才知道发放的是哪张券，当然这个可以通过路径占位符传参。

技术细节

1.Controller层

@ApiOperation("发放优惠券接口")
@PutMapping("/{id}/issue")
public void beginIssue(@RequestBody @Valid CouponIssueFormDTO dto) {
    couponService.beginIssue(dto);
}

2.Service层:

@Transactional
@Override
public void beginIssue(CouponIssueFormDTO dto) {
    // 1.查询优惠券
    Coupon coupon = getById(dto.getId());
    if (coupon == null) {
        throw new BadRequestException("优惠券不存在！");
    }
    // 2.判断优惠券状态，是否是暂停或待发放
    if(coupon.getStatus() != CouponStatus.DRAFT && coupon.getStatus() != PAUSE){
        throw new BizIllegalException("优惠券状态错误！");
    }
    // 3.判断是否是立刻发放
    LocalDateTime issueBeginTime = dto.getIssueBeginTime();
    LocalDateTime now = LocalDateTime.now();
    boolean isBegin = issueBeginTime == null || !issueBeginTime.isAfter(now);
    // 4.更新优惠券
    // 4.1.拷贝属性到PO
    Coupon c = BeanUtils.copyBean(dto, Coupon.class);
    // 4.2.更新状态
    if (isBegin) {
        c.setStatus(ISSUING);
        c.setIssueBeginTime(now);
    }else{
        c.setStatus(UN_ISSUE);
    }
    // 4.3.写入数据库
    updateById(c);

    // TODO 兑换码生成
}