发放优惠券

文章目录

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

概要

发放优惠券

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

需求分析以及接口设计

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

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

 

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

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

• 发放（领用）结束时间

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

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

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

最后，肯定要带上优惠券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.拷贝属性到POCoupon 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 兑换码生成
}