基于SpringBoot+Redis的前后端分离外卖项目-苍穹外卖(十六)

商家端订单管理模块

1. 订单搜索

1.1 需求分析和设计

产品原型：

业务规则：

• 输入订单号/手机号进行搜索，支持模糊搜索
• 根据订单状态进行筛选
• 下单时间进行时间筛选
• 搜索内容为空，提示未找到相关订单
• 搜索结果页，展示包含搜索关键词的内容
• 分页展示搜索到的订单数据

接口设计：参见接口文档

1.2 代码实现

1.2.1 admin/OrderController

在admin包下创建OrderController

/**
 * 订单管理
 */@RestController("adminOrderController")@RequestMapping("/admin/order")@Slf4j@Api(tags ="订单管理接口")publicclassOrderController{@AutowiredprivateOrderService orderService;/**
     * 订单搜索
     *
     * @param ordersPageQueryDTO
     * @return
     */@GetMapping("/conditionSearch")@ApiOperation("订单搜索")publicResult<PageResult>conditionSearch(OrdersPageQueryDTO ordersPageQueryDTO){PageResult pageResult = orderService.conditionSearch(ordersPageQueryDTO);returnResult.success(pageResult);}}

1.2.2 OrderService

/**
     * 条件搜索订单
     * @param ordersPageQueryDTO
     * @return
     */PageResultconditionSearch(OrdersPageQueryDTO ordersPageQueryDTO);

1.2.3 OrderServiceImpl

/**
     * 订单搜索
     *
     * @param ordersPageQueryDTO
     * @return
     */publicPageResultconditionSearch(OrdersPageQueryDTO ordersPageQueryDTO){PageHelper.startPage(ordersPageQueryDTO.getPage(), ordersPageQueryDTO.getPageSize());Page<Orders> page = orderMapper.pageQuery(ordersPageQueryDTO);// 部分订单状态，需要额外返回订单菜品信息，将Orders转化为OrderVOList<OrderVO> orderVOList =getOrderVOList(page);returnnewPageResult(page.getTotal(), orderVOList);}privateList<OrderVO>getOrderVOList(Page<Orders> page){// 需要返回订单菜品信息，自定义OrderVO响应结果List<OrderVO> orderVOList =newArrayList<>();List<Orders> ordersList = page.getResult();if(!CollectionUtils.isEmpty(ordersList)){for(Orders orders : ordersList){// 将共同字段复制到OrderVOOrderVO orderVO =newOrderVO();BeanUtils.copyProperties(orders, orderVO);String orderDishes =getOrderDishesStr(orders);// 将订单菜品信息封装到orderVO中，并添加到orderVOList
                orderVO.setOrderDishes(orderDishes);
                orderVOList.add(orderVO);}}return orderVOList;}/**
     * 根据订单id获取菜品信息字符串
     *
     * @param orders
     * @return
     */privateStringgetOrderDishesStr(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());// 将该订单对应的所有菜品信息拼接在一起returnString.join("", orderDishList);}

2. 各个状态的订单数量统计

2.1 需求分析和设计

接口设计：参见接口文档

2.2 代码实现

2.2.1 admin/OrderController

/**
     * 各个状态的订单数量统计
     *
     * @return
     */@GetMapping("/statistics")@ApiOperation("各个状态的订单数量统计")publicResult<OrderStatisticsVO>statistics(){OrderStatisticsVO orderStatisticsVO = orderService.statistics();returnResult.success(orderStatisticsVO);}

2.2.2 OrderService

/**
     * 各个状态的订单数量统计
     * @return
     */OrderStatisticsVOstatistics();

2.2.3 OrderServiceImpl

/**
     * 各个状态的订单数量统计
     *
     * @return
     */publicOrderStatisticsVOstatistics(){// 根据状态，分别查询出待接单、待派送、派送中的订单数量Integer toBeConfirmed = orderMapper.countStatus(Orders.TO_BE_CONFIRMED);Integer confirmed = orderMapper.countStatus(Orders.CONFIRMED);Integer deliveryInProgress = orderMapper.countStatus(Orders.DELIVERY_IN_PROGRESS);// 将查询出的数据封装到orderStatisticsVO中响应OrderStatisticsVO orderStatisticsVO =newOrderStatisticsVO();
        orderStatisticsVO.setToBeConfirmed(toBeConfirmed);
        orderStatisticsVO.setConfirmed(confirmed);
        orderStatisticsVO.setDeliveryInProgress(deliveryInProgress);return orderStatisticsVO;}

2.2.4 OrderMapper

/**
     * 根据状态统计订单数量
     * @param status
     */@Select("select count(id) from orders where status = #{status}")IntegercountStatus(Integer status);

3. 查询订单详情

3.1 需求分析和设计

产品原型：

业务规则：

• 订单详情页面需要展示订单基本信息（状态、订单号、下单时间、收货人、电话、收货地址、金额等）
• 订单详情页面需要展示订单明细数据（商品名称、数量、单价）

接口设计：参见接口文档

3.2 代码实现

3.2.1 admin/OrderController

/**
     * 订单详情
     *
     * @param id
     * @return
     */@GetMapping("/details/{id}")@ApiOperation("查询订单详情")publicResult<OrderVO>details(@PathVariable("id")Long id){OrderVO orderVO = orderService.details(id);returnResult.success(orderVO);}

4. 接单

4.1 需求分析和设计

产品原型：

业务规则：

• 商家接单其实就是将订单的状态修改为“已接单”

接口设计：参见接口文档

4.2 代码实现

4.2.1 admin/OrderController

/**
     * 接单
     *
     * @return
     */@PutMapping("/confirm")@ApiOperation("接单")publicResultconfirm(@RequestBodyOrdersConfirmDTO ordersConfirmDTO){
        orderService.confirm(ordersConfirmDTO);returnResult.success();}

4.2.2 OrderService

/**
     * 接单
     *
     * @param ordersConfirmDTO
     */voidconfirm(OrdersConfirmDTO ordersConfirmDTO);

4.2.3 OrderServiceImpl

/**
     * 接单
     *
     * @param ordersConfirmDTO
     */publicvoidconfirm(OrdersConfirmDTO ordersConfirmDTO){Orders orders =Orders.builder().id(ordersConfirmDTO.getId()).status(Orders.CONFIRMED).build();

        orderMapper.update(orders);}

5. 拒单

5.1 需求分析和设计

业务规则：

• 商家拒单其实就是将订单状态修改为“已取消”
• 只有订单处于“待接单”状态时可以执行拒单操作
• 商家拒单时需要指定拒单原因
• 商家拒单时，如果用户已经完成了支付，需要为用户退款

接口设计：参见接口文档

5.2 代码实现

5.2.1 admin/OrderController

/**
     * 拒单
     *
     * @return
     */@PutMapping("/rejection")@ApiOperation("拒单")publicResultrejection(@RequestBodyOrdersRejectionDTO ordersRejectionDTO)throwsException{
        orderService.rejection(ordersRejectionDTO);returnResult.success();}

5.2.2 OrderService

/**
     * 拒单
     *
     * @param ordersRejectionDTO
     */voidrejection(OrdersRejectionDTO ordersRejectionDTO)throwsException;

5.2.3 OrderServiceImpl

/**
     * 拒单
     *
     * @param ordersRejectionDTO
     */publicvoidrejection(OrdersRejectionDTO ordersRejectionDTO)throwsException{// 根据id查询订单Orders ordersDB = orderMapper.getById(ordersRejectionDTO.getId());// 订单只有存在且状态为2（待接单）才可以拒单if(ordersDB ==null||!ordersDB.getStatus().equals(Orders.TO_BE_CONFIRMED)){thrownewOrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);}//支付状态Integer payStatus = ordersDB.getPayStatus();if(payStatus ==Orders.PAID){//用户已支付，需要退款String refund = weChatPayUtil.refund(
                    ordersDB.getNumber(),
                    ordersDB.getNumber(),newBigDecimal(0.01),newBigDecimal(0.01));
            log.info("申请退款：{}", refund);}// 拒单需要退款，根据订单id更新订单状态、拒单原因、取消时间Orders orders =newOrders();
        orders.setId(ordersDB.getId());
        orders.setStatus(Orders.CANCELLED);
        orders.setRejectionReason(ordersRejectionDTO.getRejectionReason());
        orders.setCancelTime(LocalDateTime.now());

        orderMapper.update(orders);}

6. 取消订单

6.1 需求分析和设计

业务规则：

• 取消订单其实就是将订单状态修改为“已取消”
• 商家取消订单时需要指定取消原因
• 商家取消订单时，如果用户已经完成了支付，需要为用户退款

接口设计：参见接口文档

6.2 代码实现

6.2.1 admin/OrderController

/**
     * 取消订单
     *
     * @return
     */@PutMapping("/cancel")@ApiOperation("取消订单")publicResultcancel(@RequestBodyOrdersCancelDTO ordersCancelDTO)throwsException{
        orderService.cancel(ordersCancelDTO);returnResult.success();}

6.2.2 OrderService

/**
     * 商家取消订单
     *
     * @param ordersCancelDTO
     */voidcancel(OrdersCancelDTO ordersCancelDTO)throwsException;

6.2.3 OrderServiceImpl

/**
     * 取消订单
     *
     * @param ordersCancelDTO
     */publicvoidcancel(OrdersCancelDTO ordersCancelDTO)throwsException{// 根据id查询订单Orders ordersDB = orderMapper.getById(ordersCancelDTO.getId());//支付状态Integer payStatus = ordersDB.getPayStatus();if(payStatus ==1){//用户已支付，需要退款String refund = weChatPayUtil.refund(
                    ordersDB.getNumber(),
                    ordersDB.getNumber(),newBigDecimal(0.01),newBigDecimal(0.01));
            log.info("申请退款：{}", refund);}// 管理端取消订单需要退款，根据订单id更新订单状态、取消原因、取消时间Orders orders =newOrders();
        orders.setId(ordersCancelDTO.getId());
        orders.setStatus(Orders.CANCELLED);
        orders.setCancelReason(ordersCancelDTO.getCancelReason());
        orders.setCancelTime(LocalDateTime.now());
        orderMapper.update(orders);}

7. 派送订单

7.1 需求分析和设计

产品原型：

业务规则：

• 派送订单其实就是将订单状态修改为“派送中”
• 只有状态为“待派送”的订单可以执行派送订单操作

接口设计：参见接口文档

7.2 代码实现

7.2.1 admin/OrderController

/**
     * 派送订单
     *
     * @return
     */@PutMapping("/delivery/{id}")@ApiOperation("派送订单")publicResultdelivery(@PathVariable("id")Long id){
        orderService.delivery(id);returnResult.success();}

7.2.2 OrderService

/**
     * 派送订单
     *
     * @param id
     */voiddelivery(Long id);

7.2.3 OrderServiceImpl

/**
     * 派送订单
     *
     * @param id
     */publicvoiddelivery(Long id){// 根据id查询订单Orders ordersDB = orderMapper.getById(id);// 校验订单是否存在，并且状态为3if(ordersDB ==null||!ordersDB.getStatus().equals(Orders.CONFIRMED)){thrownewOrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);}Orders orders =newOrders();
        orders.setId(ordersDB.getId());// 更新订单状态,状态转为派送中
        orders.setStatus(Orders.DELIVERY_IN_PROGRESS);

        orderMapper.update(orders);}

8. 完成订单

8.1 需求分析和设计

业务规则：

• 完成订单其实就是将订单状态修改为“已完成”
• 只有状态为“派送中”的订单可以执行订单完成操作

接口设计：参见接口文档

8.2 代码实现

8.2.1 admin/OrderController

/**
     * 完成订单
     *
     * @return
     */@PutMapping("/complete/{id}")@ApiOperation("完成订单")publicResultcomplete(@PathVariable("id")Long id){
        orderService.complete(id);returnResult.success();}

8.2.2 OrderService

/**
     * 完成订单
     *
     * @param id
     */voidcomplete(Long id);

8.2.3 OrderServiceImpl

/**
     * 完成订单
     *
     * @param id
     */publicvoidcomplete(Long id){// 根据id查询订单Orders ordersDB = orderMapper.getById(id);// 校验订单是否存在，并且状态为4if(ordersDB ==null||!ordersDB.getStatus().equals(Orders.DELIVERY_IN_PROGRESS)){thrownewOrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);}Orders orders =newOrders();
        orders.setId(ordersDB.getId());// 更新订单状态,状态转为完成
        orders.setStatus(Orders.COMPLETED);
        orders.setDeliveryTime(LocalDateTime.now());

        orderMapper.update(orders);}

校验收货地址是否超出配送范围

1. 环境准备

注册账号：https://passport.baidu.com/v2/?reg&tt=1671699340600&overseas=&gid=CF954C2-A3D2-417F-9FE6-B0F249ED7E33&tpl=pp&u=https%3A%2F%2Flbsyun.baidu.com%2Findex.php%3Ftitle%3D%E9%A6%96%E9%A1%B5

登录百度地图开放平台：https://lbsyun.baidu.com/

进入控制台，创建应用，获取AK：

相关接口:

https://lbsyun.baidu.com/index.php?title=webapi/guide/webservice-geocoding

https://lbsyun.baidu.com/index.php?title=webapi/directionlite-v1

2. 代码开发

2.1 application.yml

配置外卖商家店铺地址和百度地图的AK：

2.2 OrderServiceImpl

改造OrderServiceImpl，注入上面的配置项：

@Value("${sky.shop.address}")privateString shopAddress;@Value("${sky.baidu.ak}")privateString ak;

在OrderServiceImpl中提供校验方法：

/**
     * 检查客户的收货地址是否超出配送范围
     * @param address
     */privatevoidcheckOutOfRange(String address){Map map =newHashMap();
        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")){thrownewOrderBusinessException("店铺地址解析失败");}//数据解析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")){thrownewOrderBusinessException("收货地址解析失败");}//数据解析
        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")){thrownewOrderBusinessException("配送路线规划失败");}//数据解析JSONObject result = jsonObject.getJSONObject("result");JSONArray jsonArray =(JSONArray) result.get("routes");Integer distance =(Integer)((JSONObject) jsonArray.get(0)).get("distance");if(distance >5000){//配送距离超过5000米thrownewOrderBusinessException("超出配送范围");}}

在OrderServiceImpl的submitOrder方法中调用上面的校验方法：

后记
👉👉💕💕美好的一天，到此结束，下次继续努力！欲知后续，请看下回分解，写作不易，感谢大家的支持！！ 🌹🌹🌹