苍穹外卖学习笔记(十)

订单状态定时处理、来单提醒和客户催单

Spring Task

介绍

Spring Task 是 Spring 框架提供的任务调度工具,可以按照约定的时间自动执行某个代码逻辑。

应用场景:

  1. 信用卡每月还款提醒
  2. 银行贷款每月还款提醒
  3. 火车票售票系统处理未支付订单
  4. 入职纪念日为用户发送通知

cron 表达式

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

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

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

例如:

2024 年 10 月 17 日上午 10 点整 对应的 cron 表达式为:
0 0 10 17 10 ?2024
通常周跟日的位置会有一个问号一个日期

在线生成器:https://cron.ciding.cc/

入门案例

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

订单状态定时处理

处理超时订单

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
/**
* 定时任务:处理超时订单
*/
@Scheduled(cron = "0 * * * * ?")//每分钟触发一次
public void processTimeoutOrder() {
log.info("处理超时订单:{}", LocalDateTime.now());
LocalDateTime time = LocalDateTime.now().plusMinutes(-15);
List<Orders> ordersList = orderMapper.getByStatusAndOrderTimeLT(Orders.PENDING_PAYMENT, time);
if (ordersList != null && !ordersList.isEmpty()) {
for (Orders orders : ordersList) {
orders.setStatus(Orders.CANCELLED);
orders.setCancelReason("订单超时,自动取消");
orders.setCancelTime(LocalDateTime.now());
orderMapper.updateById(orders);
}
}
}

处理一直配送中的订单

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
/**
* 定时任务:处理一直配送中的订单
*/
@Scheduled(cron = "0 0 1 * * ?")
//每天凌晨1点触发
public void processDeliveryOrder(){
log.info("处理一直配送中的订单:{}",LocalDateTime.now());
List<Orders> ordersList = orderMapper.getByStatusAndOrderTimeLT(Orders.DELIVERY_IN_PROGRESS,LocalDateTime.now().plusDays(-1));
if (ordersList != null && !ordersList.isEmpty()) {
for (Orders orders : ordersList) {
orders.setStatus(Orders.COMPLETED);
orderMapper.updateById(orders);
}
}
}

OrderMapper

1
2
3
4
5
/**
* 根据状态和订单时间查询订单
*/
@Select("select * from orders where status = #{status} and order_time < #{orderTime}")
List<Orders> getByStatusAndOrderTimeLT(Integer status, LocalDateTime orderTime);

WebSocket

介绍

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

HTTP 协议和 WebSocket 协议对比

20241017170212

20241017170227

对比:

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

应用场景:

  1. 视频弹幕
  2. 网页聊天
  3. 体育实况更新
  4. 股票基金报价实时更新

入门案例

1. 使用 websocket.html 作为 WebSocket 客户端

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8" />
<title>WebSocket Demo</title>
</head>
<body>
<input id="text" type="text" />
<button onclick="send()">发送消息</button>
<button onclick="closeWebSocket()">关闭连接</button>
<div id="message"></div>
</body>
<script type="text/javascript">
var websocket = null;
var clientId = Math.random().toString(36).substr(2);

//判断当前浏览器是否支持WebSocket
if ("WebSocket" in window) {
//连接WebSocket节点
websocket = new WebSocket("ws://localhost:8080/ws/" + clientId);
} else {
alert("Not support websocket");
}

//连接发生错误的回调方法
websocket.onerror = function () {
setMessageInnerHTML("error");
};

//连接成功建立的回调方法
websocket.onopen = function () {
setMessageInnerHTML("连接成功");
};

//接收到消息的回调方法
websocket.onmessage = function (event) {
setMessageInnerHTML(event.data);
};

//连接关闭的回调方法
websocket.onclose = function () {
setMessageInnerHTML("close");
};

//监听窗口关闭事件,当窗口关闭时,主动去关闭websocket连接,防止连接还没断开就关闭窗口,server端会抛异常。
window.onbeforeunload = function () {
websocket.close();
};

//将消息显示在网页上
function setMessageInnerHTML(innerHTML) {
document.getElementById("message").innerHTML += innerHTML + "<br/>";
}

//发送消息
function send() {
var message = document.getElementById("text").value;
websocket.send(message);
}

//关闭连接
function closeWebSocket() {
websocket.close();
}
</script>
</html>

2. 导入 maven 坐标

1
2
3
4
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-websocket</artifactId>
</dependency>

3. 导入 WebSocket 服务端组件 WebSocketServer,用于和客户端通信

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
package com.sky.websocket;

import org.springframework.stereotype.Component;
import javax.websocket.OnClose;
import javax.websocket.OnMessage;
import javax.websocket.OnOpen;
import javax.websocket.Session;
import javax.websocket.server.PathParam;
import javax.websocket.server.ServerEndpoint;
import java.util.Collection;
import java.util.HashMap;
import java.util.Map;

/**
* WebSocket服务
*/
@Component
@ServerEndpoint("/ws/{sid}")
public class WebSocketServer {

//存放会话对象
private static Map<String, Session> sessionMap = new HashMap();

/**
* 连接建立成功调用的方法
*/
@OnOpen
public void onOpen(Session session, @PathParam("sid") String sid) {
System.out.println("客户端:" + sid + "建立连接");
sessionMap.put(sid, session);
}

/**
* 收到客户端消息后调用的方法
*
* @param message 客户端发送过来的消息
*/
@OnMessage
public void onMessage(String message, @PathParam("sid") String sid) {
System.out.println("收到来自客户端:" + sid + "的信息:" + message);
}

/**
* 连接关闭调用的方法
*
* @param sid
*/
@OnClose
public void onClose(@PathParam("sid") String sid) {
System.out.println("连接断开:" + sid);
sessionMap.remove(sid);
}

/**
* 群发
*
* @param message
*/
public void sendToAllClient(String message) {
Collection<Session> sessions = sessionMap.values();
for (Session session : sessions) {
try {
//服务器向客户端发送消息
session.getBasicRemote().sendText(message);
} catch (Exception e) {
e.printStackTrace();
}
}
}

}

4. 导入配置类 WebSocketConfiguration,注册 WebSocket 的服务端组件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
package com.sky.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.socket.server.standard.ServerEndpointExporter;

/**
* WebSocket配置类,用于注册WebSocket的Bean
*/
@Configuration
public class WebSocketConfiguration {

@Bean
public ServerEndpointExporter serverEndpointExporter() {
return new ServerEndpointExporter();
}

}

5. 导入定时任务类 WebSocketTask,定时向客户端推送数据

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
package com.sky.task;

import com.sky.websocket.WebSocketServer;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;

@Component
public class WebSocketTask {
@Autowired
private WebSocketServer webSocketServer;

/**
* 通过WebSocket每隔5秒向客户端发送消息
*/
@Scheduled(cron = "0/5 * * * * ?")
public void sendMessageToClient() {
webSocketServer.sendToAllClient("这是来自服务端的消息:" + DateTimeFormatter.ofPattern("HH:mm:ss").format(LocalDateTime.now()));
}
}

来电提醒与客户催单

用户下单并且支付成功后,需要第一时间通知外卖商家。通知方式有:

  1. 语音播报
  2. 弹出提示框

实现步骤:

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

来电提醒

OrderServerImpl

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
@Autowired
private WebSocketServer webSocketServer;
/**
* 支付成功,修改订单状态
*/
@Override
@Transactional
public void paySuccess(String outTradeNo) {

// 根据订单号查询订单
LambdaQueryWrapper<Orders> queryWrapper = new LambdaQueryWrapper<>();
queryWrapper.eq(Orders::getNumber, outTradeNo);
Orders ordersDB = orderMapper.selectOne(queryWrapper);

// 根据订单id更新订单的状态、支付方式、支付状态、结账时间
Orders orders = Orders.builder()
.id(ordersDB.getId())
.status(Orders.TO_BE_CONFIRMED)
.payStatus(Orders.PAID)
.checkoutTime(LocalDateTime.now())
.build();
orderMapper.updateById(orders);

//通过WebSocket向客户端发送消息 type , orderId ,content
Map map = new HashMap();
map.put("type", 1);//1表示来单提醒
map.put("orderId", ordersDB.getId());
map.put("content", "订单号: " + outTradeNo + " 有新订单,请及时处理!");

String json = JSON.toJSONString(map);
webSocketServer.sendToAllClient(json);
}

客户催单

OrderController

1
2
3
4
5
6
7
8
9
/**
* 催单
*/
@GetMapping("/reminder/{id}")
@ApiOperation("催单")
public Result reminder(@PathVariable("id") Long id) {
orderService.reminder(id);
return Result.success();
}

OrderServer

1
2
3
4
/**
* 催单
*/
void reminder(Long id);

OrderServerImpl

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
/**
* 催单
*/
@Override
public void reminder(Long id) {
Orders ordersDB = orderMapper.selectById(id);

if (ordersDB == null) {
throw new OrderBusinessException(MessageConstant.ORDER_NOT_FOUND);
}
Map map = new HashMap();
map.put("type", 2);//2表示催单提醒
map.put("orderId", ordersDB.getId());
map.put("content", "订单号: " + ordersDB.getNumber() + " 有催单,请及时处理!");
String json = JSON.toJSONString(map);
webSocketServer.sendToAllClient(json);
}