springboot項(xiàng)目如何接入websocket

這篇文章將為大家詳細(xì)講解有關(guān)springboot項(xiàng)目如何接入websocket，小編覺得挺實(shí)用的，因此分享給大家做個(gè)參考，希望大家閱讀完這篇文章后可以有所收獲。

springboot是什么

springboot一種全新的編程規(guī)范，其設(shè)計(jì)目的是用來簡化新Spring應(yīng)用的初始搭建以及開發(fā)過程，SpringBoot也是一個(gè)服務(wù)于框架的框架，服務(wù)范圍是簡化配置文件。

序

最近一個(gè)項(xiàng)目又重啟了，之前支付了要手動(dòng)點(diǎn)擊已付款，所以這次想把這個(gè)不友好體驗(yàn)干掉。另外以后的掃碼登錄什么的都需要這個(gè)服務(wù)支持。之前掃碼登錄這塊用的mqtt，時(shí)間上是直接把mqtt的連接信息返回給前端。前端連接mqtt服務(wù)，消費(fèi)信息。這次不想這樣弄了，準(zhǔn)備接入websocket。

一、環(huán)境說明

我這里是springBoot2.4.5 + springCloud2020.1.2，這里先從springBoot對(duì)接開始，逐步再增加深度，不過可能時(shí)間不夠，就簡單接入能滿足現(xiàn)在業(yè)務(wù)場(chǎng)景就stop。沒辦法，從入職就開始的一個(gè)項(xiàng)目到現(xiàn)在，要死不活的，沒有客戶就不投入，有客戶就催命，真不知道還能堅(jiān)持多久。。。。。。

二、引包

<!-- websocket支持 -->
<dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter-websocket</artifactId>
</dependency>

現(xiàn)在springboot對(duì)接websocket就值需要這么簡單的一個(gè)包了。

三、配置類

import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.socket.server.standard.ServerEndpointExporter;

/**
 * websocket配置類
 *
 * @author zhengwen
 **/
@Slf4j
@Configuration
public class WebSocketConfig {
    @Bean
    public ServerEndpointExporter serverEndpointExporter(){
        return new ServerEndpointExporter();
    }
}

就這一個(gè)，里面的bean是用來掃描Endpoint注解的類的。
配置文件都沒什么好說的，簡單對(duì)接用不上，也不用什么調(diào)優(yōu)。

四、websocketServer

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.lang3.StringUtils;
import org.springframework.stereotype.Component;

import javax.websocket.*;
import javax.websocket.server.PathParam;
import javax.websocket.server.ServerEndpoint;
import java.io.IOException;
import java.util.concurrent.ConcurrentHashMap;


/**
 * @author zhengwen
 **/
@Slf4j
@Component
@ServerEndpoint("/wsPushMessage/{wsUserId}")
public class MyWebSocketSever {
    /**
     * 靜態(tài)變量，用來記錄當(dāng)前在線連接數(shù)。應(yīng)該把它設(shè)計(jì)成線程安全的。
     */
    private static int onlineCount = 0;
    /**
     * concurrent包的線程安全Set，用來存放每個(gè)客戶端對(duì)應(yīng)的WebSocket對(duì)象。
     */
    private static ConcurrentHashMap<String, MyWebSocketSever> webSocketMap = new ConcurrentHashMap<>();
    /**
     * 與某個(gè)客戶端的連接會(huì)話，需要通過它來給客戶端發(fā)送數(shù)據(jù)
     */
    private Session session;
    /**
     * 接收wsUserId
     */
    private String wsUserId = "";

    /**
     * 連接建立成
     * 功調(diào)用的方法
     */
    @OnOpen
    public void onOpen(Session session, @PathParam("wsUserId") String userId) {
        this.session = session;
        this.wsUserId = userId;
        if (webSocketMap.containsKey(userId)) {
            webSocketMap.remove(userId);
            //加入set中
            webSocketMap.put(userId, this);
        } else {
            //加入set中
            webSocketMap.put(userId, this);
            //在線數(shù)加1
            addOnlineCount();
        }
        log.info("用戶連接:" + userId + ",當(dāng)前在線人數(shù)為:" + getOnlineCount());
        sendMessage("連接成功");
    }

    /**
     * 連接關(guān)閉
     * 調(diào)用的方法
     */
    @OnClose
    public void onClose() {
        if (webSocketMap.containsKey(wsUserId)) {
            webSocketMap.remove(wsUserId);
            //從set中刪除
            subOnlineCount();
        }
        log.info("用戶退出:" + wsUserId + ",當(dāng)前在線人數(shù)為:" + getOnlineCount());
    }

    /**
     * 收到客戶端消
     * 息后調(diào)用的方法
     *
     * @param message 客戶端發(fā)送過來的消息
     **/
    @OnMessage
    public void onMessage(String message, Session session) {
        log.info("用戶消息:" + wsUserId + ",報(bào)文:" + message);
        //可以群發(fā)消息
        //消息保存到數(shù)據(jù)庫、redis
        if (StringUtils.isNotBlank(message)) {
            try {
                //解析發(fā)送的報(bào)文
                JSONObject jsonObject = JSON.parseObject(message);
                //追加發(fā)送人(防止串改)
                jsonObject.put("fromUserId", this.wsUserId);
                String toUserId = jsonObject.getString("toUserId");
                //傳送給對(duì)應(yīng)toUserId用戶的websocket
                if (StringUtils.isNotBlank(toUserId) && webSocketMap.containsKey(toUserId)) {
                    webSocketMap.get(toUserId).sendMessage(message);
                } else {
                    //否則不在這個(gè)服務(wù)器上，發(fā)送到mysql或者redis
                    log.error("請(qǐng)求的userId:" + toUserId + "不在該服務(wù)器上");
                }
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }


    /**
     * @param session
     * @param error
     */
    @OnError
    public void onError(Session session, Throwable error) {

        log.error("用戶錯(cuò)誤:" + this.wsUserId + ",原因:" + error.getMessage());
        error.printStackTrace();
    }

}

核心方法就這么幾個(gè)，這里面的細(xì)節(jié)可以自行根據(jù)業(yè)務(wù)場(chǎng)景處理，比如給信息增加一個(gè)類型，然后搞個(gè)公用方法，根據(jù)信息類型走不同業(yè)務(wù)邏輯，存庫等等都可以的。

五、前端測(cè)試js

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>websocket通訊</title>
</head>
<script src="https://cdn.bootcss.com/jquery/3.3.1/jquery.js"></script>
<script>
    let socket;
    function openSocket() {

        const socketUrl = "ws://localhost:8810/wsPushMessage/" + $("#userId").val();
        console.log(socketUrl);
        if(socket!=null){
            socket.close();
            socket=null;
        }
        socket = new WebSocket(socketUrl);
        //打開事件
        socket.onopen = function() {
            console.log("websocket已打開");
        };
        //獲得消息事件
        socket.onmessage = function(msg) {
            console.log(msg.data);
            //發(fā)現(xiàn)消息進(jìn)入,開始處理前端觸發(fā)邏輯
        };
        //關(guān)閉事件
        socket.onclose = function() {
            console.log("websocket已關(guān)閉");
        };
        //發(fā)生了錯(cuò)誤事件
        socket.onerror = function() {
            console.log("websocket發(fā)生了錯(cuò)誤");
        }
    }
    function sendMessage() {

        socket.send('{"toUserId":"'+$("#toUserId").val()+'","contentText":"'+$("#contentText").val()+'"}');
        console.log('{"toUserId":"'+$("#toUserId").val()+'","contentText":"'+$("#contentText").val()+'"}');
    }
	function closeSocket(){
		socket.close();
	}
</script>
<body>
<p>【socket開啟者的ID信息】：<div><input id="userId" name="userId" type="text" value="10"></div>
<p>【客戶端向服務(wù)器發(fā)送的內(nèi)容】：<div><input id="toUserId" name="toUserId" type="text" value="20">
    <input id="contentText" name="contentText" type="text" value="hello websocket"></div>
<p>【開啟連接】：<div><a onclick="openSocket()">開啟socket</a></div>
<p>【發(fā)送信息】：<div><a onclick="sendMessage()">發(fā)送消息</a></div>
<p>【關(guān)閉連接】：<div><a onclick="closeSocket()">關(guān)閉socket</a></div>
</body>

</html>

六、測(cè)試效果

關(guān)于“springboot項(xiàng)目如何接入websocket”這篇文章就分享到這里了，希望以上內(nèi)容可以對(duì)大家有一定的幫助，使各位可以學(xué)到更多知識(shí)，如果覺得文章不錯(cuò)，請(qǐng)把它分享出去讓更多的人看到。