继续上一节的内容,本节是作业课,要求独立完成:用户端历史订单模块、商家端订单管理模块相关业务新功能开发和已有功能优化。
目录
- 作业要求
- 用户端历史订单模块
- 查询历史订单
- 查询订单详情
- 取消订单
- 再来一单
- 商家端订单管理模块
- 订单搜索
- 各个状态的订单数量统计
- 查询订单详情
- 接单
- 拒单
- 取消订单
- 派送订单
- 完成订单
- 校验收货地址是否超出配送范围 基于百度地图开放平台实现
作业要求
1.用户端历史订单模块:
- 查询历史订单
- 查询订单详情
- 取消订单
- 再来一单
商家端订单管理模块:
- 订单搜索
- 各个状态的订单数量统计
- 查询订单详情
- 接单
- 拒单
- 取消订单
- 派送订单
- 完成订单
2.已有功能优化
优化用户下单功能,加入校验逻辑,如果用户的收货地址距离商家门店超出配送范围(配送范围为5公里内),则下单失败。
提示:
1. 基于百度地图开放平台实现
2. 注册账号—>创建应用获取AK(服务端应用)—>调用接口
3.相关接口1,相关接口2
4.商家门店地址可以配置在配置文件中,例如:
sky:shop:address: 北京市海淀区上地十街10号
实战要求:
根据产品原型进行需求分析和接口设计
根据接口设计进行代码实现
分别通过swagger接口文档和前后端联调进行功能测试
用户端历史订单模块
查询历史订单
user/OrderController
/*** 查询历史订单** @param page* @param pageSize* @param status 订单状态 1待付款 2待接单 3已接单 4派送中 5已完成 6已取消* @return*/
@GetMapping("/historyOrders")
@ApiOperation("用户查询历史订单")
public Result<PageResult> page(int page, int pageSize, Integer status) { // status可缺省 使用包装类log.info("用户历史订单分页查询,page:{},pageSize:{},status:{}", page, pageSize, status);PageResult pageResult = orderService.pageQuery(page, pageSize, status);return Result.success(pageResult);
}
OrderServiceImpl
/*** 查询历史订单** @param page* @param pageSize* @param status 订单状态 1待付款 2待接单 3已接单 4派送中 5已完成 6已取消* @return*/
public PageResult pageQuery(int page, int pageSize, Integer status) {PageHelper.startPage(page,pageSize);Long userId = BaseContext.getCurrentId();OrdersPageQueryDTO ordersPageQueryDTO = new OrdersPageQueryDTO();ordersPageQueryDTO.setStatus(status);ordersPageQueryDTO.setUserId(userId);Page<Orders> pageResult = orderMapper.pagerQuery(ordersPageQueryDTO);// 查找出所有的order之后 还需要根据order的id去order_detail表中查找出相应的订单菜品List<OrderVO> records = new ArrayList<>();if(pageResult!=null && pageResult.size()>0){for (Orders order : pageResult) {Long orderId = order.getId();// 查询订单明细List<OrderDetail> orderDetailList = orderDetailMapper.getByOrderId(orderId);OrderVO orderVO = new OrderVO();BeanUtils.copyProperties(order,orderVO);orderVO.setOrderDetailList(orderDetailList);records.add(orderVO);}}return new PageResult(pageResult.getTotal(),records);
}
OrderMapper
/*** 分页条件查询并按下单时间排序* @param ordersPageQueryDTO*/
Page<Orders> pageQuery(OrdersPageQueryDTO ordersPageQueryDTO);
OrderMapper.xml
<select id="pageQuery" resultType="Orders">select * from orders<where><if test="number != null and number!=''">and number like concat('%',#{number},'%')</if><if test="phone != null and phone!=''">and phone like concat('%',#{phone},'%')</if><if test="userId != null">and user_id = #{userId}</if><if test="status != null">and status = #{status}</if><if test="beginTime != null">and order_time >= #{beginTime}</if><if test="endTime != null">and order_time <= #{endTime}</if></where>order by order_time desc
</select>
OrderDetailMapper
/*** 根据订单id查询订单明细* @param orderId* @return*/
@Select("select * from order_detail where order_id = #{orderId}")
List<OrderDetail> getByOrderId(Long orderId);
测试:
查询订单详情
user/OrderController
/*** 查询订单详情** @param id 订单id* @return*/
@GetMapping("/orderDetail/{id}")
@ApiOperation("用户查询订单详情")
public Result<OrderVO> details(@PathVariable Long id) {log.info("用户查询订单详情,订单id:{}", id);OrderVO orderVO = orderService.details(id);return Result.success(orderVO);
}
OrderServiceImpl
/*** 查询订单详情** @param id 订单id* @return*/
public OrderVO details(Long id) {Orders orders = orderMapper.getById(id); // 根据订单id查询订单OrderVO orderVO = new OrderVO();BeanUtils.copyProperties(orders,orderVO);// 查询该订单对应的菜品/套餐明细List<OrderDetail> orderDetailList = orderDetailMapper.getByOrderId(id);orderVO.setOrderDetailList(orderDetailList);return orderVO;
}
OrderMapper
/*** 根据id查询订单* @param id*/
@Select("select * from orders where id=#{id}")
Orders getById(Long id);
测试:
取消订单
user/OrderController
/*** 取消订单** @param id 订单id* @return*/
@PutMapping("/cancel/{id}")
@ApiOperation("用户取消订单")
public Result cancel(@PathVariable Long id){log.info("用户取消订单,订单id:{}", id);orderService.userCancelById(id);return Result.success();
}
OrderServiceImpl
@Overridepublic void userCancelById(Long id) {
// 业务规则:
// 待支付和待接单状态下,用户可直接取消订单
// 商家已接单状态下,用户取消订单需电话沟通商家
// 派送中状态下,用户取消订单需电话沟通商家
// 如果在待接单状态下取消订单,需要给用户退款
// 取消订单后需要将订单状态修改为“已取消”// 根据id查询订单Orders ordersDB = orderMapper.getById(id);// 校验订单是否存在if (ordersDB == null) {throw new OrderBusinessException(MessageConstant.ORDER_NOT_FOUND);}//订单状态 1待付款 2待接单 3已接单 4派送中 5已完成 6已取消if (ordersDB.getStatus() > 2) { // 状态大于2时取消订单抛出订单状态错误异常throw new OrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);}Orders orders = new Orders();orders.setId(ordersDB.getId());// 订单处于待接单状态下取消,需要进行退款if (ordersDB.getStatus().equals(Orders.TO_BE_CONFIRMED)) {//调用微信支付退款接口//由于我们绕开了微信支付 固这段代码注释掉
// weChatPayUtil.refund(
// ordersDB.getNumber(), //商户订单号
// ordersDB.getNumber(), //商户退款单号
// new BigDecimal(0.01),//退款金额,单位 元
// new BigDecimal(0.01));//原订单金额//支付状态修改为 退款orders.setPayStatus(Orders.REFUND);}// 更新订单状态、取消原因、取消时间orders.setStatus(Orders.CANCELLED);orders.setCancelReason("用户取消");orders.setCancelTime(LocalDateTime.now());orderMapper.update(orders);}
测试:
再来一单
user/OrderController
/*** 再来一单** @param id 订单id* @return*/
@PostMapping("/repetition/{id}")
@ApiOperation("用户再来一单")
public Result repetition(@PathVariable Long id){log.info("用户再来一单,订单id:{}", id);orderService.repetition(id);return Result.success();
}
OrderServiceImpl
/*** 再来一单** @param id 订单id*/
public void repetition(Long id) { // 再来一单就是将原订单中的商品重新加入到购物车中Long userId = BaseContext.getCurrentId();//1.根据id查到订单详情表List<OrderDetail> orderDetailList = orderDetailMapper.getByOrderId(id);//2.根据订单详情表生成购物车对象数据List<ShoppingCart> shoppingCart = new ArrayList<>();for (OrderDetail orderDetail : orderDetailList) {ShoppingCart shoppingCart1 = new ShoppingCart();BeanUtils.copyProperties(orderDetail,shoppingCart1, "id"); // 拷贝属性时忽略id属性!shoppingCart1.setUserId(userId);shoppingCart1.setCreateTime(LocalDateTime.now());shoppingCart.add(shoppingCart1);}//经过测试,前端在调用再来一单前会调用清空购物车接口,所以无需我们在这里清空购物车//3.批量插入购物车数据到购物车表shoppingCartMapper.insertBatch(shoppingCart);
}
ShoppingCartMapper
/*** 批量插入购物车数据** @param shoppingCart*/
void insertBatch(List<ShoppingCart> shoppingCart);
ShoppingCartMapper.xml
<insert id="insertBatch" parameterType="list">insert into shopping_cart(name, image, user_id, dish_id, setmeal_id, dish_flavor, number, amount, create_time)values<foreach collection="shoppingCart" item="sc" separator=",">(#{sc.name},#{sc.image},#{sc.userId},#{sc.dishId},#{sc.setmealId},#{sc.dishFlavor},#{sc.number},#{sc.amount},#{sc.createTime})</foreach>
</insert>
测试略
商家端订单管理模块
订单搜索
admin/OrderController
/*** 订单管理*/
@RestController("adminOrderController")
@RequestMapping("/admin/order")
@Slf4j
@Api(tags = "后端订单管理相关接口") //描述类的作用
public class OrderController {@Autowiredprivate OrderService orderService;/*** 订单搜索** @param ordersPageQueryDTO* @return*/@GetMapping("/conditionSearch")@ApiOperation("历史订单搜索")public Result<PageResult> conditionSearch(OrdersPageQueryDTO ordersPageQueryDTO) {log.info("历史订单搜索,OrdersPageQueryDTO:{}", ordersPageQueryDTO);PageResult pageResult = orderService.conditionSearch(ordersPageQueryDTO);return Result.success(pageResult);}}
OrderServiceImpl
/*** 订单搜索** @param ordersPageQueryDTO* @return*/
public PageResult conditionSearch(OrdersPageQueryDTO ordersPageQueryDTO) {PageHelper.startPage(ordersPageQueryDTO.getPage(), ordersPageQueryDTO.getPageSize());Page<Orders> page = orderMapper.pageQuery(ordersPageQueryDTO);// 部分订单状态,需要额外返回订单菜品信息,将Orders转化为OrderVOList<OrderVO> orderVOList = getOrderVOList(page);return new PageResult(page.getTotal(), orderVOList);
}//订单状态,需要额外返回订单菜品信息,将Orders转化为OrderVO
private List<OrderVO> getOrderVOList(Page<Orders> page) {// 需要返回订单菜品信息,自定义OrderVO响应结果List<OrderVO> orderVOList = new ArrayList<>();List<Orders> ordersList = page.getResult();if (!CollectionUtils.isEmpty(ordersList)) {for (Orders orders : ordersList) {// 将共同字段复制到OrderVOOrderVO orderVO = new OrderVO();BeanUtils.copyProperties(orders, orderVO);String orderDishes = getOrderDishesStr(orders);// 将订单菜品信息封装到orderVO中,并添加到orderVOListorderVO.setOrderDishes(orderDishes);orderVOList.add(orderVO);}}return orderVOList;
}/*** 根据订单id获取菜品信息字符串** @param orders* @return*/
private String getOrderDishesStr(Orders orders) {// 查询订单菜品详情信息(订单中的菜品和数量)List<OrderDetail> orderDetailList = orderDetailMapper.getByOrderId(orders.getId());// 将每一条订单菜品信息拼接为字符串(格式:宫保鸡丁*3;)List<String> orderDishList = orderDetailList.stream().map(x -> {String orderDish = x.getName() + "*" + x.getNumber() + ";";return orderDish;}).collect(Collectors.toList());// 将该订单对应的所有菜品信息拼接在一起return String.join("", orderDishList);
}
测试:
各个状态的订单数量统计
admin/OrderController
/*** 各个状态的订单数量统计** @return*/
@GetMapping("/statistics")
@ApiOperation("各个状态的订单数量统计")
public Result<OrderStatisticsVO> statistics() {log.info("各个状态的订单数量统计");OrderStatisticsVO orderStatisticsVO = orderService.statistics();return Result.success(orderStatisticsVO);
}
OrderServiceImpl
/*** 各个状态的订单数量统计** @return*/
public OrderStatisticsVO statistics() {// 根据状态,分别查询出待接单、待派送、派送中的订单数量Integer toBeConfirmed = orderMapper.countStatus(Orders.TO_BE_CONFIRMED); // 2待接单Integer confirmed = orderMapper.countStatus(Orders.CONFIRMED); //3已接单Integer deliveryInProgress = orderMapper.countStatus(Orders.DELIVERY_IN_PROGRESS); //4派送中// 将查询出的数据封装到orderStatisticsVO中响应OrderStatisticsVO orderStatisticsVO = new OrderStatisticsVO();orderStatisticsVO.setToBeConfirmed(toBeConfirmed);orderStatisticsVO.setConfirmed(confirmed);orderStatisticsVO.setDeliveryInProgress(deliveryInProgress);return orderStatisticsVO;
}
OrderMapper
/*** 根据状态统计订单数量* @param status*/
@Select("select count(id) from orders where status = #{status}")
Integer countStatus(Integer status);
测试:
查询订单详情
admin/OrderController
/*** 查询订单详情** @param id 订单id* @return*/
@GetMapping("/details/{id}")
@ApiOperation("商家端查询订单详情")
public Result<OrderVO> details(@PathVariable Long id) {log.info("商家查询订单详情,订单id:{}", id);OrderVO orderVO = orderService.details(id); // 复用用户端的接口就行return Result.success(orderVO);
}
测试:
接单
商家接单其实就是将订单的状态修改为“已接单”
admin/OrderController
/*** 接单** @return*/
@PutMapping("/confirm")
@ApiOperation("接单")
public Result confirm(@RequestBody OrdersConfirmDTO ordersConfirmDTO) {log.info("商家接单,订单id:{}", ordersConfirmDTO.getId());orderService.confirm(ordersConfirmDTO);return Result.success();
}
OrderServiceImpl
/*** 接单** @param ordersConfirmDTO*/
public void confirm(OrdersConfirmDTO ordersConfirmDTO) {Orders orders = Orders.builder().id(ordersConfirmDTO.getId()).status(Orders.CONFIRMED).build();orderMapper.update(orders);
}
测试略
拒单
商家拒单其实就是将订单状态修改为“已取消”、只有订单处于“待接单”状态时可以执行拒单操作、商家拒单时需要指定拒单原因
商家拒单时如果用户已经完成了支付,需要为用户退款,因为我们跳过了微信支付这步省略
admin/OrderController
/*** 拒单** @return*/
@PutMapping("/rejection")
@ApiOperation("拒单")
public Result rejection(@RequestBody OrdersRejectionDTO ordersRejectionDTO) throws Exception {log.info("商家拒单,订单id:{}", ordersRejectionDTO.getId());orderService.rejection(ordersRejectionDTO);return Result.success();
}
OrderServiceImpl
/*** 拒单** @param ordersRejectionDTO*/
public void rejection(OrdersRejectionDTO ordersRejectionDTO) throws Exception {// 根据id查询订单Orders ordersDB = orderMapper.getById(ordersRejectionDTO.getId());// 订单只有存在且状态为2(待接单)才可以拒单if (ordersDB == null || !ordersDB.getStatus().equals(Orders.TO_BE_CONFIRMED)) {throw new OrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);}//支付状态
// Integer payStatus = ordersDB.getPayStatus();
// if (payStatus == Orders.PAID) {
// //用户已支付,需要退款 我们由于绕开了微信支付 所以注释掉这些
// String refund = weChatPayUtil.refund(
// ordersDB.getNumber(),
// ordersDB.getNumber(),
// new BigDecimal(0.01),
// new BigDecimal(0.01));
// log.info("申请退款:{}", refund);
// }// 拒单需要退款,根据订单id更新订单状态、拒单原因、取消时间Orders orders = new Orders();orders.setId(ordersDB.getId());orders.setStatus(Orders.CANCELLED);orders.setRejectionReason(ordersRejectionDTO.getRejectionReason());orders.setCancelTime(LocalDateTime.now());orderMapper.update(orders);
}
测试略
取消订单
取消订单其实就是将订单状态修改为“已取消”、商家取消订单时需要指定取消原因
商家取消订单时,如果用户已经完成了支付,需要为用户退款,因为我们跳过了微信支付这步省略
admin/OrderController
/*** 取消订单** @return*/
@PutMapping("/cancel")
@ApiOperation("取消订单")
public Result cancel(@RequestBody OrdersCancelDTO ordersCancelDTO) throws Exception {log.info("商家取消订单,订单id:{}", ordersCancelDTO.getId());orderService.cancel(ordersCancelDTO);return Result.success();
}
OrderServiceImpl
/*** 取消订单** @param ordersCancelDTO*/
public void cancel(OrdersCancelDTO ordersCancelDTO) throws Exception {// 根据id查询订单Orders ordersDB = orderMapper.getById(ordersCancelDTO.getId());//支付状态
// Integer payStatus = ordersDB.getPayStatus();
// if (payStatus == 1) {
// //用户已支付,需要退款 我们由于绕开了微信支付 所以注释掉这些
// String refund = weChatPayUtil.refund(
// ordersDB.getNumber(),
// ordersDB.getNumber(),
// new BigDecimal(0.01),
// new BigDecimal(0.01));
// log.info("申请退款:{}", refund);
// }// 管理端取消订单需要退款,根据订单id更新订单状态、取消原因、取消时间Orders orders = new Orders();orders.setId(ordersCancelDTO.getId());orders.setStatus(Orders.CANCELLED);orders.setCancelReason(ordersCancelDTO.getCancelReason());orders.setCancelTime(LocalDateTime.now());orderMapper.update(orders);
}
测试略
派送订单
派送订单其实就是将订单状态修改为“派送中”、只有状态为“待派送”的订单可以执行派送订单操作
admin/OrderController
/*** 派送订单** @return*/
@PutMapping("/delivery/{id}")
@ApiOperation("派送订单")
public Result delivery(@PathVariable("id") Long id) {log.info("商家派送订单,订单id:{}", id);orderService.delivery(id);return Result.success();
}
OrderServiceImpl
/*** 派送订单** @param id*/
public void delivery(Long id) {// 根据id查询订单Orders ordersDB = orderMapper.getById(id);// 校验订单是否存在,并且状态为3if (ordersDB == null || !ordersDB.getStatus().equals(Orders.CONFIRMED)) {throw new OrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);}Orders orders = new Orders();orders.setId(ordersDB.getId());// 更新订单状态,状态转为派送中orders.setStatus(Orders.DELIVERY_IN_PROGRESS);orderMapper.update(orders);
}
测试略
完成订单
完成订单其实就是将订单状态修改为“已完成”、只有状态为“派送中”的订单可以执行订单完成操作
admin/OrderController
/*** 完成订单** @return*/
@PutMapping("/complete/{id}")
@ApiOperation("完成订单")
public Result complete(@PathVariable("id") Long id) {log.info("商家完成订单,订单id:{}", id);orderService.complete(id);return Result.success();
}
OrderServiceImpl
/*** 完成订单** @param id*/
public void complete(Long id) {// 根据id查询订单Orders ordersDB = orderMapper.getById(id);// 校验订单是否存在,并且状态为4if (ordersDB == null || !ordersDB.getStatus().equals(Orders.DELIVERY_IN_PROGRESS)) {throw new OrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);}Orders orders = new Orders();orders.setId(ordersDB.getId());// 更新订单状态,状态转为完成orders.setStatus(Orders.COMPLETED);orders.setDeliveryTime(LocalDateTime.now());orderMapper.update(orders);
}
测试略
校验收货地址是否超出配送范围 基于百度地图开放平台实现
注册登录百度地图开放平台,完成认证,进入控制台,创建应用,获取AK:
我们需要使用地理编码服务来计算商家地址和收货地址的经纬度,然后通过驾车路线规划服务来计算两个经纬度的距离。下面是代码
application.yml配置外卖商家店铺地址和百度地图的AK:
OrderServiceImpl
改造OrderServiceImpl,通过@Value注入上面的配置项,@Value若忘记了可以参考这篇博客的配置文件部分。
@Value("${sky.shop.address}")
private String shopAddress;@Value("${sky.baidu.ak}")
private String ak;
在OrderServiceImpl中提供校验方法:
/*** 检查客户的收货地址是否超出配送范围* @param address*/
private void checkOutOfRange(String address) {Map map = new HashMap();map.put("address",shopAddress);map.put("output","json");map.put("ak",ak);//获取店铺的经纬度坐标String shopCoordinate = HttpClientUtil.doGet("https://api.map.baidu.com/geocoding/v3", map);JSONObject jsonObject = JSON.parseObject(shopCoordinate);if(!jsonObject.getString("status").equals("0")){throw new OrderBusinessException("店铺地址解析失败");}//数据解析JSONObject location = jsonObject.getJSONObject("result").getJSONObject("location");String lat = location.getString("lat");String lng = location.getString("lng");//店铺经纬度坐标String shopLngLat = lat + "," + lng;map.put("address",address);//获取用户收货地址的经纬度坐标String userCoordinate = HttpClientUtil.doGet("https://api.map.baidu.com/geocoding/v3", map);jsonObject = JSON.parseObject(userCoordinate);if(!jsonObject.getString("status").equals("0")){throw new OrderBusinessException("收货地址解析失败");}//数据解析location = jsonObject.getJSONObject("result").getJSONObject("location");lat = location.getString("lat");lng = location.getString("lng");//用户收货地址经纬度坐标String userLngLat = lat + "," + lng;map.put("origin",shopLngLat);map.put("destination",userLngLat);map.put("steps_info","0");//路线规划String json = HttpClientUtil.doGet("https://api.map.baidu.com/directionlite/v1/driving", map);jsonObject = JSON.parseObject(json);if(!jsonObject.getString("status").equals("0")){throw new OrderBusinessException("配送路线规划失败");}//数据解析JSONObject result = jsonObject.getJSONObject("result");JSONArray jsonArray = (JSONArray) result.get("routes");Integer distance = (Integer) ((JSONObject) jsonArray.get(0)).get("distance");if(distance > 5000){//配送距离超过5000米throw new OrderBusinessException("超出配送范围");}
}
PS:这里的代码使用到了HttpClientUtil,可以参考这篇博客,另外这里使用到了大量的com.alibaba.fastjson中的api来解析json,稍微有点代码理解能力还是能看得懂的,看不懂可以网上搜一下fastjson的用法,这里的代码如果能看懂,也就基本学会了fastjson的常用方法。
在OrderServiceImpl的submitOrder方法中调用上面的校验方法:
测试当配送地址超过5km时: