苍穹外卖day9(2) 商家端订单管理

---

前言

商家端订单管理很多方法在用户端历史订单管理中已实现，对于接单、拒单、取消订单、派送订单以及完成订单这些功能的业务逻辑相同，就是对订单的状态进行修改，拒单和取消订单时要设置原因。
（已有功能优化部分，我注册账号失败了，所以就没有去实现了）

---

商家端订单管理

1. 订单搜索

1.1 业务规则

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

1.2 接口设计

1.3 代码实现

1、在admin包下创建OrderController，在OrderController中定义conditionSearch方法用于订单搜索

@GetMapping("/conditionSearch")
@ApiOperation("订单搜索")
public Result<PageResult> conditionSearch(OrdersPageQueryDTO ordersPageQueryDTO){
    PageResult pageResult = orderService.conditionSearch(ordersPageQueryDTO);
    return Result.success(pageResult);
}

2、在OrderService中定义conditionSearch方法，在OrderServiceImpl中实现
通过ordersPageQueryDTO分页查询得到Orders，通过Orders得到订单菜品详情信息，并拼接成字符串的形式返回给OrderVO，最后返回OrderVO形式

public PageResult conditionSearch(OrdersPageQueryDTO ordersPageQueryDTO) {
     //分页查询
     PageHelper.startPage(ordersPageQueryDTO.getPage(), ordersPageQueryDTO.getPageSize());
     Page<Orders> page = orderMapper.pageQuery(ordersPageQueryDTO);
     // 部分订单状态，需要额外返回订单菜品信息，将Orders转化为OrderVO
     List<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) {
             // 将共同字段复制到OrderVO
             OrderVO orderVO = new OrderVO();
             BeanUtils.copyProperties(orders, orderVO);
             String orderDishes = getOrderDishesStr(orders);
             // 将订单菜品信息封装到orderVO中，并添加到orderVOList
             orderVO.setOrderDishes(orderDishes);
             orderVOList.add(orderVO);
         }
     }
     return orderVOList;
}
//根据订单id获取菜品信息字符串
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);
}

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

2.1 接口设计

2.2 代码实现

1、在OrderController定义statistics方法

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

2、在OrderService中定义statistics方法，在OrderServiceImpl中实现

public OrderStatisticsVO statistics() {
    // 根据状态，分别查询出待接单、待派送、派送中的订单数量
    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 = new OrderStatisticsVO();
    orderStatisticsVO.setToBeConfirmed(toBeConfirmed);
    orderStatisticsVO.setConfirmed(confirmed);
    orderStatisticsVO.setDeliveryInProgress(deliveryInProgress);
    return orderStatisticsVO;
}

3、在OrderMapper中定义countStatus方法，根据状态统计订单数量

@Select("select count(id) from orders where status = #{status}")
Integer countStatus(Integer status);

3. 查询订单详情

3.1 业务规则

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

3.2 接口设计

3.3 代码实现

1、在OrderController定义details方法查询订单详情

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

2、details方法在用户端已实现

4. 接单

4.1 业务规则

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

4.2 接口设计

4.3 代码实现

1、在OrderController定义confirm方法

@PutMapping("/confirm")
@ApiOperation("接单")
public Result confirm(@RequestBody OrdersConfirmDTO ordersConfirmDTO) {
    orderService.confirm(ordersConfirmDTO);
    return Result.success();
}

2、在OrderService中定义confirm方法，在OrderServiceImpl中实现

public void confirm(OrdersConfirmDTO ordersConfirmDTO) {
    Orders orders = Orders.builder()
            .id(ordersConfirmDTO.getId())
            .status(Orders.CONFIRMED)
            .build();
    orderMapper.update(orders);
}

3、update在OrderMapper中已实现。

5. 拒单

5.1 业务规则

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

5.2 接口设计

5.3 代码实现

1、在OrderController定义rejection方法

@PutMapping("/rejection")
@ApiOperation("拒单")
public Result rejection(@RequestBody OrdersRejectionDTO ordersRejectionDTO) throws Exception {
    orderService.rejection(ordersRejectionDTO);
    return Result.success();
}

2、在OrderService中定义confirm方法，在OrderServiceImpl中实现

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);
    }
    //根据订单id更新订单状态、拒单原因、取消时间
    Orders orders = new Orders();
    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.3 代码实现

1、在OrderController定义cancel方法

@PutMapping("/cancel")
@ApiOperation("取消订单")
public Result cancel(@RequestBody OrdersCancelDTO ordersCancelDTO) throws Exception {
    orderService.cancel(ordersCancelDTO);
    return Result.success();
}

2、在OrderService中定义cancel方法，在OrderServiceImpl中实现

public void cancel(OrdersCancelDTO ordersCancelDTO) throws Exception {
    // 根据id查询订单
    Orders ordersDB = orderMapper.getById(ordersCancelDTO.getId());
    // 管理端取消订单需要退款，根据订单id更新订单状态、取消原因、取消时间
    Orders orders = new Orders();
    orders.setId(ordersCancelDTO.getId());
    orders.setStatus(Orders.CANCELLED);
    orders.setCancelReason(ordersCancelDTO.getCancelReason());
    orders.setCancelTime(LocalDateTime.now());
    orderMapper.update(orders);
}

7.派送订单

7.1 业务规则

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

8.完成订单

8.1 业务规则

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

---