WebSocket简介
Spring Boot对WebSocket提供了非常友好的支持,可以方便开发者在项目中快速集成WebSocket功能
添加依赖:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-websocket</artifactId>
</dependency>
<dependency>
<groupId>org.webjars</groupId>
<artifactId>webjars-locator-core</artifactId>
</dependency>
<dependency>
<groupId>org.webjars</groupId>
<artifactId>sockjs-client</artifactId>
<version>1.1.2</version>
</dependency>
<dependency>
<groupId>org.webjars</groupId>
<artifactId>stomp-websocket</artifactId>
<version>2.3.3</version>
</dependency>
<dependency>
<groupId>org.webjars</groupId>
<artifactId>jquery</artifactId>
<version>3.3.1</version>
</dependency>
spring-boot-starter-websocket依赖是Web Socket相关依赖,
其他的都是前端库,使用jar包的形式对这些前端库进行统一管理,使用webjar添加到项目中的前端库,在Spring Boot项目中已经默认添加了静态资源过滤,因此可以直接使用。
配置WebSocket:
Spring框架提供了基于WebSocket的STOMP支持,STOMP是一个简单的可互操作的协议,通常被用于通过中间服务器在客户端之间进行异步消息传递。WebSocket配置如下:
// 自定义类WebSocketConfig继承自WebSocketMessageBrokerConfigurer进行WebSocket配置
@Configuration
@EnableWebSocketMessageBroker // 开启WebSocket消息代理
public class WebSocketConfig implements WebSocketMessageBrokerConfigurer {
@Override
public void configureMessageBroker(MessageBrokerRegistry config) {
/*
* 表示设置消息代理的前缀,即如果消息的前缀是“/topic”,就会将消息转发给消息代理(broker),再由消息代理将消息广播给当前连接的客户端。
*/
config.enableSimpleBroker("/topic", "/queue");
/*
* 表示配置一个或多个前缀,通过这些前缀过滤出需要被注解方法处理的消息
* 例如,前缀为“/app”的destination可以通过@MessageMapping注解的方法处理,
* 而其他destination(例如“/ topic”“/ queue”)将被直接交给broker处理。
*/
config.setApplicationDestinationPrefixes("/app");
}
@Override
public void registerStompEndpoints(StompEndpointRegistry registry) {
/*
* 表示定义一个前缀为“/chat”的endPoint,并开启sockjs支持,
* sockjs可以解决浏览器对WebSocket的兼容性问题,
* 客户端将通过这里配置的URL来建立WebSocket连接。
*/
registry.addEndpoint("/chat").withSockJS();
}
}
定义Controller:
定义一个Controller用来实现对消息的处理,代码如下
@Controller
public class GreetingController {
@Autowired
SimpMessagingTemplate messagingTemplate;
@MessageMapping("/hello") // 用来接收“/app/hello”路径发送来的消息 在注解方法中对消息进行处理后,再将消息转发到@SendTo定义的路径上
@SendTo("/topic/greetings") // @SendTo路径是一个前缀为“/topic”的路径,因此该消息将被交给消息代理broker,再由broker进行广播。
public Message greeting(Message message) {
return message;
}
@MessageMapping("/chat")
public void chat(Principal principal, Chat chat) {
String from = principal.getName();
chat.setFrom(from);
messagingTemplate.convertAndSendToUser(chat.getTo(), "/queue/chat", chat);
}
}
构建聊天页面:
在resources/static目录下创建chat.html页面作为聊天页面,代码如下
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>群聊</title>
<script src="/webjars/jquery/jquery.min.js"></script>
<script src="/webjars/sockjs-client/sockjs.min.js"></script>
<script src="/webjars/stomp-websocket/stomp.min.js"></script>
<script src="/app.js"></script>
</head>
<body>
<div>
<label for="name">请输入用户名:</label>
<input type="text" id="name" placeholder="用户名">
</div>
<div>
<button id="connect" type="button">连接</button>
<button id="disconnect" type="button" disabled="disabled">断开连接</button>
</div>
<div id="chat" style="display: none;">
<div>
<label for="name">请输入聊天内容:</label>
<input type="text" id="content" placeholder="聊天内容">
</div>
<button id="send" type="button">发送</button>
<div id="greetings">
<div id="conversation" style="display: none">群聊进行中...</div>
</div>
</div>
</body>
</html>
app.js是一个自定义JS,代码如下
var stompClient = null;
function setConnected(connected) {
$("#connect").prop("disabled", connected);
$("#disconnect").prop("disabled", !connected);
if (connected) {
$("#conversation").show();
$("#chat").show();
} else {
$("#conversation").hide();
$("#chat").hide();
}
$("#greetings").html("");
}
/**
* connect方法表示建立一个WebSocket连接
*/
function connect() {
// 在建立WebSocket连接时,用户必须先输入用户名,然后才能建立连接
if (!$("#name").val()) {
return;
}
var socket = new SockJS('/chat');// 首先使用SockJS建立连接
stompClient = Stomp.over(socket); // 然后创建一个STOMP实例发起连接请求
stompClient.connect({}, function (frame) {
setConnected(true);// 在连接成功的回调方法中,首先调用setConnected(true);方法进行页面的设置
//然后调用STOMP中的subscribe方法订阅服务端发送回来的消息,
stompClient.subscribe('/topic/greetings', function (greeting) {
showGreeting(JSON.parse(greeting.body));// 并将服务端发送来的消息展示出来(使用showGreeting方法)。
});
});
}
function disconnect() {
if (stompClient !== null) {
// 调用STOMP中的disconnect方法可以断开一个WebSocket连接。
stompClient.disconnect();
}
setConnected(false);
}
function sendName() {
stompClient.send(
"/app/hello",
{},
JSON.stringify(
{
'name': $("#name").val(),
'content': $("#content").val()
}
));
}
function showGreeting(message) {
$("#greetings").append("<div>" + message.name + ":" + message.content + "</div>");
}
$(function () {
$("#connect").click(function () {
connect();
});
$("#disconnect").click(function () {
disconnect();
});
$("#send").click(function () {
sendName();
});
});
测试:
接下来启动Spring Boot项目进行测试,在浏览器中输入http://localhost:8081/chat.html
文章来源: Spring Boot+Vue全栈开发实战 - 11.3 Spring Boot整合WebSocket