黑马苍穹外卖项目笔记10_订单状态定时处理、来单提醒和客户催单

---

一.订单状态定时处理

1.Spring Task

Spring Task 是Spring框架提供的任务调度工具，可以按照约定的时间自动执行某个代码逻辑.有了这个技术,当用户状态处于待支付时,等待时间超过15分钟就可以自动取消订单;商家端显示订单一直在配送但其实已经完成了,也可以借助Spring Task实现自动完成订单的功能

作用：定时自动执行某段Java代码

2.cron表达式

cron表达式其实就是一个字符串，通过cron表达式可以定义任务触发的时间

构成规则：分为6或7个域，由空格分隔开，每个域代表一个含义

每个域的含义分别为：秒、分钟、小时、日、月、周、年(可选)

3.Spring Task使用步骤

1.导入maven坐标 spring-context
2.启动类添加注解 @EnableScheduling 开启任务调度
3.自定义定时任务类

4.需求分析

用户下单后可能存在的情况：
1.下单后未支付，订单一直处于“待支付”状态

2.用户收货后管理端未点击完成按钮，订单一直处于“派送中”状态

对于上面两种情况需要通过定时任务来修改订单状态，具体逻辑为：
1.通过定时任务每分钟检查一次是否存在支付超时订单（下单后超过15分钟仍未支付则判定为支付超时订单），如果存在则修改订单状态为“已取消”

2.通过定时任务每天凌晨1点检查一次是否存在“派送中”的订单，如果存在则修改订单状态为“已完成”

5.代码开发

自定义定时任务类OrderTask

@Component
@Slf4j
public class OrderTask {

    @Autowired
    private OrderMapper orderMapper;

    /**
     * 支付超时订单处理
     * 对于下单后超过15分钟仍未支付的订单自动修改状态为 [已取消]
     */
    @Scheduled(cron = "0 * * * * ?")// 每分钟执行一次
    public void processTimeoutOrder() {
        log.info("处理支付超时订单：{}", new Date());

        LocalDateTime time = LocalDateTime.now().plusMinutes(-15);
        List<Orders> ordersList = orderMapper.getByStatusAndOrdertimeLT(Orders.PENDING_PAYMENT, time);

        if (ordersList != null && ordersList.size() > 0) {
            ordersList.forEach(order -> {
                order.setStatus(Orders.CANCELLED);
                order.setCancelReason("支付超时,自动取消");
                order.setCancelTime(LocalDateTime.now());
                orderMapper.update(order);
            });
        }
    }

    /**
     * 派送中状态的订单处理
     * 对于一直处于派送中状态的订单，自动修改状态为 [已完成]
     */
    @Scheduled(cron = "0 0 1 * * ?")
    public void processDeliveryOrder() {
        log.info("处理派送中订单：{}", new Date());

        LocalDateTime time = LocalDateTime.now().plusMinutes(-60);
        List<Orders> ordersList = orderMapper.getByStatusAndOrdertimeLT(Orders.DELIVERY_IN_PROGRESS, time);

        if (ordersList != null && ordersList.size() > 0) {
            ordersList.forEach(order -> {
                order.setStatus(Orders.COMPLETED);
                orderMapper.update(order);
            });
        }
    }
}

在OrderMapper接口中扩展方法

/**
     * 根据订单状态和下单时间查询订单
     * @param status
     * @param orderTime
     * @return
     */
    @Select("select * from orders where status=#{status} and order_time < #{orderTime}")
    List<Orders> getByStatusAndOrdertimeLT(Integer status, LocalDateTime orderTime);

二.来单提醒和客户催单

1.WebSocket

WebSocket 是基于 TCP 的一种新的网络协议。它实现了浏览器与服务器全双工通信——浏览器和服务器只需要完成一次握手，两者之间就可以创建持久性的连接， 并进行双向数据传输。

HTTP协议和WebSocket协议对比：
1.HTTP是短连接
2.WebSocket是长连接
3.HTTP通信是单向的，基于请求响应模式
4.WebSocket支持双向通信
5.HTTP和WebSocket底层都是TCP连接

想要使用WebSocket,需要有以下步骤:
1.导入WebSocket的maven坐标
2.导入WebSocket服务端组件WebSocketServer，用于和客户端通信
3.导入配置类WebSocketConfiguration，注册WebSocket的服务端组件

思考:既然WebSocket支持双向通信，功能看似比HTTP强大，那么我们是不是可以基于WebSocket开发所有的业务功能？

WebSocket缺点：
1.服务器长期维护长连接需要一定的成本
2.各个浏览器支持程度不一
3.WebSocket 是长连接，受网络限制比较大，需要处理好重连

结论：WebSocket并不能完全取代HTTP，它只适合在特定的场景下使用

2.来单提醒

需求分析和设计

用户下单并且支付成功后，需要第一时间通知外卖商家。通知的形式有如下两种：
1.语音播报
2.弹出提示框

设计：
1.通过WebSocket实现管理端页面和服务端保持长连接状态
2.当客户支付后，调用WebSocket的相关API实现服务端向客户端推送消息
3.客户端浏览器解析服务端推送的消息，判断是来单提醒还是客户催单，进行相应的消息提示和语音播报
4.约定服务端发送给客户端浏览器的数据格式为JSON，字段包括：type，orderId，content

• type 为消息类型，1为来单提醒 2为客户催单
• orderId 为订单id
• content 为消息内容

代码开发:
在OrderServiceImpl中注入WebSocketServer对象，修改paySuccess方法，加入如下代码：

Map map = new HashMap();
        map.put("type", 1);
        map.put("orderId", ordersDB.getId());
        map.put("content", "订单号:" + outTradeNo);

        webSocketServer.sendToAllClient(JSON.toJSONString(map));

3.客户催单

需求分析和设计:

用户在小程序中点击催单按钮后，需要第一时间通知外卖商家。通知的形式有如下两种：
1.语音播报
2.弹出提示框

设计：
1.通过WebSocket实现管理端页面和服务端保持长连接状态
2.当用户点击催单按钮后，调用WebSocket的相关API实现服务端向客户端推送消息
3.客户端浏览器解析服务端推送的消息，判断是来单提醒还是客户催单，进行相应的消息提示和语音播报
4.约定服务端发送给客户端浏览器的数据格式为JSON，字段包括：type，orderId，content

• type 为消息类型，1为来单提醒 2为客户催单
• orderId 为订单id
• content 为消息内容

接口设计(用户点击催单按钮,调用表现层的API接口请求服务器,实现对商家端的客户端响应):

代码开发:
根据用户催单的接口定义，在user/OrderController中创建催单方法：

	/**
     * 用户催单
     * @param id
     * @return
     */
    @GetMapping("/reminder/{id}")
    @ApiOperation("用户催单")
    public Result<String> reminder(@PathVariable Long id){
        orderService.reminder(id);

        return Result.success();
    }

在OrderService接口中声明reminder方法：

	/**
     * 用户催单
     * @param id
     */
    void reminder(Long id);

在OrderServiceImpl中实现reminder方法：

	/**
     * 用户催单
     *
     * @param id
     */
    public void reminder(Long id) {
        Orders orders = orderMapper.getById(id);

        if (orders == null) {
            throw new OrderBusinessException(MessageConstant.ORDER_NOT_FOUND);
        }

        Map map = new HashMap();
        map.put("type", 2);//2代表用户催单
        map.put("orderId", id);
        map.put("content", "订单号：" + orders.getNumber());

        webSocketServer.sendToAllClient(JSON.toJSONString(map));
    }

功能测试:
前后端联调测试即可