SpringBoot+SSM项目实战 苍穹外卖(09) day9作业

继续上一节的内容，本节是作业课，要求独立完成：用户端历史订单模块、商家端订单管理模块相关业务新功能开发和已有功能优化。

作业要求

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 &gt;= #{beginTime}
        </if>
        <if test="endTime != null">
            and order_time &lt;= #{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

    @Override
    public 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 {
    @Autowired
    private 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转化为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获取菜品信息字符串
 *
 * @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);

    // 校验订单是否存在，并且状态为3
    if (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);

    // 校验订单是否存在，并且状态为4
    if (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时：