天机学堂-优惠券功能-day09(七)

day09 接口

一 优惠券管理

1.新增优惠券

CouponController.java

/** * 新增优惠券 * * @param coupon * @return */@ApiOperation("新增优惠券")@PostMappingpublicvoidsaveCoupon(@RequestBody@ValidCouponFormDTOcoupon){couponService.saveCoupon(coupon);}

ICouponService.java

voidsaveCoupon(@ValidCouponFormDTOcoupon);

CouponServiceImpl.java

测试时注意：添加优惠券时优惠券名称需要不少于4

@Override@TransactionalpublicvoidsaveCoupon(CouponFormDTOcoupon){// 1.拷贝优惠券相关信息Couponcoupon1=BeanUtils.copyProperties(coupon,Coupon.class);// 2.保存优惠券save(coupon1);// 3.保存限定范围（指定的课程或者分类生效）if(!coupon.getSpecific()){//没有范围限定return;}//4.有的话就需要去存储该获取优惠券的使用范围List<Long>scopes=coupon.getScopes();List<CouponScope>list=newArrayList<>();for(Longscope:scopes){//保存优惠券和课程或者分类的关系// 1.创建对象（三个属性：范围限定的类型，业务的id，优惠券的id）CouponScopescope1=newCouponScope();// 2.设置属性scope1.setCouponId(coupon1.getId());scope1.setBizId(scope);scope1.setType(1);list.add(scope1);}couponScopeService.saveBatch(list);}

2.修改优惠券

• 请求方式：PUT
• 请求路径：/coupons/{id}
• 请求参数：与新增类似，参考新增接口。
• 返回值：无

CouponController.java

/** * 修改优惠券 * * @param coupon * @return */@ApiOperation("修改优惠券")@PutMapping("{id}")publicvoidupdateCoupon(@RequestBodyCouponFormDTOcoupon){couponService.updateById(BeanUtils.copyProperties(coupon,Coupon.class));}

分页查询优惠券

CouponController.java

/** * 分页查询优惠券 * * @param query * @return */@ApiOperation("分页查询优惠券")@GetMapping("/page")publicPageDTO<CouponPageVO>queryCoupons(CouponQueryquery){returncouponService.queryCoupons(query);}

ICouponService.java

PageDTO<CouponPageVO>queryCoupons(CouponQueryquery);

CouponServiceImpl.java

@OverridepublicPageDTO<CouponPageVO>queryCoupons(CouponQueryquery){Integerstatus=query.getStatus();Stringname=query.getName();Integertype=query.getType();Page<Coupon>page=lambdaQuery().eq(status!=null,Coupon::getDiscountType,type).eq(status!=null,Coupon::getStatus,status).like(name!=null,Coupon::getName,name).page(query.toMpPageDefaultSortByCreateTimeDesc());List<Coupon>records=page.getRecords();if(CollUtils.isEmpty(records)){returnPageDTO.empty(page);}ArrayList<CouponPageVO>couponPageVOS=newArrayList<>();for(Couponrecord:records){CouponPageVOvo=BeanUtils.copyProperties(record,CouponPageVO.class);couponPageVOS.add(vo);}returnPageDTO.of(page,couponPageVOS);}

3.根据id查询优惠券

CouponController.java

/** * 根据id查询优惠券 * * @param id * @return */@ApiOperation("根据id查询优惠券")@GetMapping("{id}")publicCouponDetailVOgetById(@PathVariable("id")Longid){returncouponService.queryById(id);}

ICouponService.java

CouponDetailVOqueryById(Longid);

CouponServiceImpl.java

@Override public CouponDetailVO queryById(Long id) { Coupon coupon = getById(id); CouponDetailVO couponDetailVO = BeanUtils.copyBean(coupon, CouponDetailVO.class); if (couponDetailVO == null || !coupon.getSpecific()) { // 数据不存在，或者没有限定范围，直接结束 return couponDetailVO; } LambdaQueryWrapper<CouponScope> queryWrapper = new LambdaQueryWrapper<>(); queryWrapper.eq(CouponScope::getCouponId, id); List<CouponScope> couponScopes = couponScopeMapper.selectList(queryWrapper); if (CollUtils.isEmpty(couponScopes)) { return couponDetailVO; } List<CouponScopeVO> scopeVOS = couponScopes.stream() .map(CouponScope::getBizId) .map(cateId -> new CouponScopeVO(cateId, categoryCache.getNameByLv3Id(cateId))) .collect(Collectors.toList()); couponDetailVO.setScopes(scopeVOS); return couponDetailVO; }

4.删除优惠券

• 请求方式：DELETE
• 请求路径：/coupons/{id}
• 请求参数：与新增类似，参考新增接口。
• 返回值：无

CouponController.java

/** * 删除优惠券 * * @param id * @return */@ApiOperation("删除优惠券")@DeleteMapping("{id}")publicvoiddeleteById(@PathVariable("id")Longid){couponService.deleteById(id);}

ICouponService.java

voiddeleteById(Longid);

CouponServiceImpl.java

@Override public void deleteById(Long id) { // 1.查询 Coupon coupon = getById(id); if (coupon == null || coupon.getStatus() != DRAFT) { throw new BadRequestException("优惠券不存在或者优惠券正在使用中"); } // 2.删除优惠券 boolean success = remove(new LambdaQueryWrapper<Coupon>() .eq(Coupon::getId, id) .eq(Coupon::getStatus, DRAFT) ); if (!success) { throw new BadRequestException("优惠券不存在或者优惠券正在使用中"); } // 3.删除优惠券对应限定范围 if (!coupon.getSpecific()) { return; } couponScopeService.remove(new LambdaQueryWrapper<CouponScope>().eq(CouponScope::getCouponId, id)); }

二 优惠券发放

1.发放优惠券（版本1）

CouponController.java

/** * 发放优惠券 * * @param dto * @return */@ApiOperation("发放优惠券")@PutMapping("{id}/issue")publicvoidbeginIssue(@RequestBody@ValidCouponIssueFormDTOdto){couponService.beginIssue(dto);}

ICouponService.java

voidbeginIssue(@ValidCouponIssueFormDTOdto);

CouponServiceImpl.java

@OverridepublicvoidbeginIssue(CouponIssueFormDTOdto){//1.查询优惠券CouponbyId=this.getById(dto.getId());//2.判断优惠券的状态，是否是暂停或者待发放if(byId.getStatus()!=DRAFT&&byId.getStatus()!=PAUSE){thrownewBadRequestException("优惠券状态错误");}//3.判断是否是立刻发放(当前时间为null或者发放时间已经过了，都代表立即发放)LocalDateTimeissueBeginTime=dto.getIssueBeginTime();booleanisBegin=issueBeginTime==null||!issueBeginTime.isAfter(LocalDateTime.now());//4.更新优惠券Couponcoupon=BeanUtils.copyProperties(dto,Coupon.class);if(isBegin){coupon.setStatus(CouponStatus.ISSUING);coupon.setIssueBeginTime(issueBeginTime);}else{coupon.setStatus(CouponStatus.UN_ISSUE);}this.updateById(coupon);}

2.发放优惠券（版本2）

兑换码算法

3.暂停发放

• 请求方式：PUT
• 请求路径：/coupons/{id}/pause
• 请求参数：路径占位符id
• 返回值：无

CouponController.java

@ApiOperation("停发优惠券")@PutMapping("/{id}/pause")publicvoidpauseIssue(@ApiParam("优惠券id")@PathVariable("id")longid){couponService.pauseIssue(id);}

ICouponService.java

voidpauseIssue(longid);

CouponServiceImpl.java

@OverridepublicvoidpauseIssue(longid){this.lambdaUpdate().eq(Coupon::getId,id).set(Coupon::getStatus,CouponStatus.PAUSE).update();}