Spring Boot电商项目60：订单模块九：【后台：订单发货】接口；

说明：

（1）本篇博客的主要内容是开发【后台：订单发货】接口；

（2）本篇博客的内容比较简单；唯一需要注意的是：订单的状态，以及，订单状态流转的说明；

目录

一：【后台：订单发货】接口说明；

1.【后台：订单发货】接口，接口文档；

2.订单状态说明；

3.【后台：订单发货】接口，在界面上的表现；

二：正式开发；

1.在OrderAdminController中，创建处理【后台：订单发货】接口的方法：delivered()方法；

2.在OrderServiceImpl中，创建发货的逻辑方法，deliver方法；

3.在OrderService中，反向生成deliver方法的方法声明；

三：测试；

---

一：【后台：订单发货】接口说明；

1.【后台：订单发货】接口，接口文档；

说明：

（1）发货接口，主要的作用是把已经付款的订单给发货；本质也就是，改变订单的状态，由20已付款改为30已发货；

2.订单状态说明；

          ● 用户刚下单时，订单状态是10未付款；

          ● 在未付款前（在本项目中，仅支持未付款的订单，去取消订单），用户可以取消订单，然后订单状态就变成了0；；；；但是，用户下单后，即订单状态是10时，用户也可以去付款，此后，订单状态就变成了20；

          ● 用户付款后，即订单状态变为20后，后台管理员才能够去发货；即，订单当前状态是20时，我们才能够修改订单状态为30；

          ● 当订单状态是30已发货后；前台用户和后台管理员，都可以调用【前后台通用：订单完结】接口，去完结订单，完结订单也就是订单状态是40；（【前后台通用：订单完结】接口，将在下篇博客介绍）

3.【后台：订单发货】接口，在界面上的表现；

---

二：正式开发；

1.在OrderAdminController中，创建处理【后台：订单发货】接口的方法：delivered()方法；

    /**
     * 后台管理员的，订单发货
     * @param orderNo
     * @return
     */
    @ApiOperation("后台管理员的，订单发货")
    @PostMapping("/admin/order/delivered")
    public ApiRestResponse delivered(@RequestParam("orderNo") String orderNo) {
        orderService.deliver(orderNo);
        return ApiRestResponse.success();
    }

说明：

（1）请求方式，url，参数要符合接口要求；

（2）我们在service层中编写了发货的逻辑方法：deliver()方法；这在下一部分介绍；

2.在OrderServiceImpl中，创建发货的逻辑方法，deliver方法；

   /**
     * 发货
     * @param orderNo
     */
    @Override
    public void deliver(String orderNo) {
        //先根据传入的orderNo，去尝试查询order
        Order order = orderMapper.selectByOrderNo(orderNo);
        //如果没有找到对应的订单，就抛出“订单不存在异常”
        if (order == null) {
            throw new ImoocMallException(ImoocMallExceptionEnum.NO_ORDER);
        }
        //如果订单存在，就进行接下来的操作；
        //如果，订单状态是已付款，那么我们就可以发货，我们就把订单状态改为已发货；
        if (order.getOrderStatus() == Constant.OrderStatusEnum.PAID.getCode()) {
            order.setOrderStatus(Constant.OrderStatusEnum.DELIVERED.getCode());//更改订单状态为已发货；
            order.setDeliveryTime(new Date());//设置一下发货时间；
            orderMapper.updateByPrimaryKeySelective(order);
        } else {
            //如果，当前订单状态不是已付款，就抛出“当前订单状态错误”异常；
            throw new ImoocMallException(ImoocMallExceptionEnum.WRONG_ORDER_STATUS);
        }
    }

说明：

（1）在订单发货的时候，也需要校验订单是否存在、订单的状态是否是已付款状态，如果不符合条件，就抛出对应的异常；；

3.在OrderService中，反向生成deliver方法的方法声明；

---

三：测试；

启动项目；

因为【后台：订单发货】接口，只有管理员才有权限，所以，我们先登录一个管理员用户；

PS：突然意识到，在实际的电商项目中，不同的管理员用户之间也需要做好横向越权的处理；而这需要在数据库设计、程序编码架构上，作修改；只是，本项目并没有这样做；