目次
1.WebSocketとは何ですか
WebSocket は、単一のTCP 接続を介した全二重通信用のプロトコルです。WebSocket を使用すると、クライアントとサーバー間のデータ交換が容易になり、サーバーがアクティブにデータをクライアントにプッシュできるようになります。WebSocket APIでは、ブラウザとサーバーがハンドシェイクを完了するだけで、両者間で直接永続的な接続を確立し、双方向のデータ送信を行うことができます。
2. WebSocket は何に使用できますか?
双方向データ送信の特性を利用すると、フロントエンドのポーリングを行わずにリソースを無駄にせずに、多くの機能を完了できます。例えば:
-
リアルタイム チャット アプリケーション: WebSocket はリアルタイム チャット機能を実装でき、ユーザーはメッセージを即座に送受信し、高速かつリアルタイムのコミュニケーションを実現できます。
-
リアルタイム データ更新: 株価や天気予報など、データをリアルタイムで更新する必要があるアプリケーションの場合、WebSocket はリアルタイム プッシュ メカニズムを提供できるため、データをリアルタイムで更新して表示できます。ユーザーをタイムリーにサポートします。
-
マルチプレイヤー オンライン ゲーム: WebSocket は、リアルタイム カード ゲーム、ボード ゲームなどのマルチプレイヤー オンライン ゲームのリアルタイム戦闘シナリオに適した双方向通信機能を提供します。
-
コラボレーション ツール: WebSocket を使用すると、チーム タスク管理ツール、共同編集ツールなどのリアルタイム コラボレーション ツールを実装でき、チーム メンバーが作業内容をリアルタイムで更新および同期できるようになります。
-
リアルタイム地図交通監視:WebSocketをリアルタイム地図交通監視システムに利用することで、道路状況や渋滞などの情報をリアルタイムに取得できます。
-
オンライン カスタマー サービスとカスタマー サポート: WebSocket を通じて、カスタマー サービス担当者はリアルタイムで顧客と通信し、質問に対するタイムリーな回答やサポート サービスを提供できます。
-
リアルタイムの投票とアンケート: WebSocket を使用すると、リアルタイムの投票とアンケート システムを実装し、投票結果をリアルタイムで表示し、ユーザーの投票を受信して集計できます。等......
3.webSocketプロトコル
このプロトコルには、ハンドシェイクとデータ転送の 2 つの部分があります。ハンドシェイクは http プロトコルに基づいています。
- クライアントからのハンドシェイクは次のようになります。
GET ws://localhost/chat HTTP/1.1
Host: localhost
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Key:dGhlIHNhbXBsZSBub25jZQ==
Sec-WebSocket-Protocol: chat,superchat
Sec-WebSocket-Version: 13
- サーバーからのハンドシェイクは次のようになります。
HTTP/1.1 101 Switching Protocols
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Accept:s3pPLMBiTxaQ9kYGzzhZRbK+xOo=
Sec-WebSocket-Protocol: chat
4. サーバー側
- pom.xml の依存関係
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-websocket</artifactId>
</dependency>
- WebSocketConfig構成クラス (構成パッケージ ディレクトリ)
package com.jmh.demo03.websocket.config;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.socket.server.standard.ServerEndpointExporter;
@Configuration
public class WebSocketConfig {
/**
* 注入ServerEndpointExporter,
* 这个bean会自动注册使用了@ServerEndpoint注解声明的Websocket endpoint
*/
@Bean
public ServerEndpointExporter serverEndpointExporter() {
return new ServerEndpointExporter();
}
}
- WebSocket操作クラス(configパッケージディレクトリ)
package com.jmh.demo03.websocket.config;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
import java.util.concurrent.CopyOnWriteArraySet;
import javax.websocket.*;
import javax.websocket.server.PathParam;
import javax.websocket.server.ServerEndpoint;
import org.springframework.stereotype.Component;
import lombok.extern.slf4j.Slf4j;
@Component
@Slf4j
//接口路径 ws://localhost:8087/webSocket/userId;
@ServerEndpoint("/websocket/{userId}")
public class WebSocket {
/**
* 与某个客户端的连接会话,需要通过它来给客户端发送数据
*/
private Session session;
/**
* 用户ID
*/
private String userId;
//concurrent包的线程安全Set,用来存放每个客户端对应的MyWebSocket对象。
//虽然@Component默认是单例模式的,但springboot还是会为每个websocket连接初始化一个bean,所以可以用一个静态set保存起来。
// 注:底下WebSocket是当前类名
private static CopyOnWriteArraySet<WebSocket> webSockets =new CopyOnWriteArraySet<>();
/**
* 用来存在线连接用户信息
*/
private static ConcurrentHashMap<String,Session> sessionPool = new ConcurrentHashMap<String,Session>();
/**
* 链接成功调用的方法
*/
@OnOpen
public void onOpen(Session session, @PathParam(value="userId")String userId) {
try {
this.session = session;
this.userId = userId;
webSockets.add(this);
sessionPool.put(userId, session);
log.info("【websocket消息】用户{}连接成功,在线人数为{}",userId,webSockets.size());
} catch (Exception e) {
e.printStackTrace();
}
}
/**
* 链接关闭调用的方法
*/
@OnClose
public void onClose() {
try {
webSockets.remove(this);
sessionPool.remove(this.userId);
log.info("【websocket消息】用户{}连接断开,在线人数为{}",userId,webSockets.size());
} catch (Exception e) {
e.printStackTrace();
}
}
/**
* 收到客户端消息后调用的方法
* @param message 消息
*/
@OnMessage
public void onMessage(String message) {
log.info("【websocket消息】收到客户端用户{},消息:{}",userId,message);
}
/**
* 发送错误时的处理
* @param session 会话
* @param error 错误
*/
@OnError
public void onError(Session session, Throwable error) {
log.error("用户错误,原因:"+error.getMessage());
error.printStackTrace();
}
/**
* 此为广播消息
* @param message 消息内容
*/
public void sendAllMessage(String message) {
log.info("【websocket消息】广播消息:"+message);
for(WebSocket webSocket : webSockets) {
try {
if(webSocket.session.isOpen()) {
webSocket.session.getAsyncRemote().sendText(message);
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
/**
* 此为单点消息
* @param userId 用户编号
* @param message 消息内容
*/
public void sendOneMessage(String userId, String message) {
Session session = sessionPool.get(userId);
if (session != null&&session.isOpen()) {
try {
log.info("【websocket消息】 单点消息:"+message);
session.getAsyncRemote().sendText(message);
} catch (Exception e) {
e.printStackTrace();
}
}
}
/**
* 此为单点消息(多人)
* @param userIds 用户编号组
* @param message 消息内容
*/
public void sendMoreMessage(String[] userIds, String message) {
for(String userId:userIds) {
Session session = sessionPool.get(userId);
if (session != null&&session.isOpen()) {
try {
log.info("【websocket消息】 单点消息:"+message);
session.getAsyncRemote().sendText(message);
} catch (Exception e) {
e.printStackTrace();
}
}
}
}
}
- SendMessageController はインスタンス クラス (コントローラー パッケージ ディレクトリ) を呼び出します
package com.jmh.demo03.websocket.controller;
import com.alibaba.fastjson2.JSONObject;
import com.jmh.demo03.websocket.config.WebSocket;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.annotation.Resource;
import java.util.Arrays;
import java.util.Collections;
import java.util.List;
/**
* @author 蒋明辉
* @data 2023/8/7 14:43
*/
@RestController
@RequestMapping("/ws")
public class SendMessageController {
@Autowired
private WebSocket webSocket;
/**
* 广播消息
*/
@PostMapping("/sendAllMessage")
public void sendAllMessage(){
//发送内容
JSONObject jsonObject=new JSONObject();
String message="【今日话题】:早睡早起,多喝开水,要爱自己多一点~";
jsonObject.put("message",message);
//全体发送
webSocket.sendAllMessage(jsonObject.toString());
}
/**
* 单个用户发送
*/
@PostMapping("/sendOneMessage")
public void sendOneMessage(){
//发送内容
JSONObject jsonObject=new JSONObject();
String message="【今日话题】:早睡早起,多喝开水,要爱自己多一点~";
jsonObject.put("abc",message);
//单个用户发送 (userId为用户id)
webSocket.sendOneMessage("1", jsonObject.toString());
}
/**
* 多个用户发送
*/
@PostMapping("/sendMoreMessage")
public void sendMoreMessage(){
//发送内容
JSONObject jsonObject=new JSONObject();
String message="【今日话题】:早睡早起,多喝开水,要爱自己多一点~";
jsonObject.put("message",message);
//多个用户发送 (userIds为多个用户id,逗号‘,’分隔)
String str="1,2,3";
String[] split = str.split(",");
webSocket.sendMoreMessage(split, jsonObject.toString());
}
}
5. クライアント
- vue.jsコード
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title></title>
<script src="https://cdn.bootcdn.net/ajax/libs/jquery/3.6.4/jquery.min.js"></script>
<script src="https://cdn.bootcss.com/vue/2.6.10/vue.js"></script>
<script src="https://cdn.bootcdn.net/ajax/libs/axios/1.3.4/axios.js"></script>
</head>
<body>
<div id="demo">
<h1>Web Socket 正式发版</h1>
<hr/>
<button @click="sendKh()">发送消息(客户端)</button>
<button @click="sendFwq()">发送消息(服务器端)</button>
</div>
</body>
<script>
new Vue({
el: '#demo',
data() {
return {
}
},
mounted() {
//初始化websocket
this.initWebSocket()
},
destroyed: function () { // 离开页面生命周期函数
this.websocketclose();
},
methods: {
initWebSocket: function () { // 建立连接
// WebSocket与普通的请求所用协议有所不同,ws等同于http,wss等同于https
this.websock = new WebSocket("ws://127.0.0.1:8080/websocket/1");
this.websock.onopen = this.websocketonopen;
//this.websock.send = this.websocketsend;
this.websock.onerror = this.websocketonerror;
this.websock.onmessage = this.websocketonmessage;
this.websock.onclose = this.websocketclose;
},
// 连接成功后调用
websocketonopen: function () {
console.log("WebSocket连接成功");
},
// 发生错误时调用
websocketonerror: function (e) {
console.log("WebSocket连接发生错误");
},
// 给后端发消息时调用
websocketsend: function (e) {
console.log("WebSocket连接发生错误");
},
// 接收后端消息(服务器端发送)
// vue 客户端根据返回的cmd类型处理不同的业务响应
websocketonmessage: function (e) {
console.info(e)
var data = eval("(" + e.data + ")");
console.info(data)
},
// 关闭连接时调用
websocketclose: function (e) {
console.log("connection closed (" + e.code + ")");
},
//向服务器发送消息(客户端发送)
sendKh(){
let data={
message: '小明你好!我想和你成为朋友~',
sendData: new Date()
}
this.websock.send("尊嘟假嘟")
},
//向客户端发送消息(服务器端发送)
sendFwq(){
axios.post('http://localhost:8080/ws/sendOneMessage').then((resp)=>{
console.info(resp)
})
}
}
})
</script>
</html>
6. テスト通信
1. 通信に接続します (フロントエンドおよびバックエンドのアクセス サービスを開いて通信に接続します)
2. クライアントはサーバーにメッセージを送信します
- クライアントはサーバーにメッセージを送信します
- サーバーが受信したメッセージ
3. サーバーはクライアントにメッセージを送信します
- サーバーはクライアントにメッセージを送信します
- クライアントが受け取ったメッセージ
- サーバー側のメッセージを表示する