概述 web管理系統中可以對業務數據執行新增和刪除，現在需要當業務數據發生新增或刪除操作後，儘可能實時的反應到WPF客戶端上面。 web管理系統用VUE編寫，後端服務為SpringBoot，WPF客戶端基於.Netframework4.8編寫。整體架構 sequenceDiagram title: ...

概述

web管理系統中可以對業務數據執行新增和刪除，現在需要當業務數據發生新增或刪除操作後，儘可能實時的反應到WPF客戶端上面。

web管理系統用VUE編寫，後端服務為SpringBoot，WPF客戶端基於.Netframework4.8編寫。

整體架構

sequenceDiagram title: 交互時序圖 web前臺->>+web後端服務:新增數據 Note over web前臺,web後端服務:caremaId,labelInfo,...... web後端服務->>+WebSocketServer:創建websocker消息 Note over web後端服務,WebSocketServer:Must:cameraId=clientId WPF客戶端1-->>+WebSocketServer:創建監聽 Note over WPF客戶端1,WebSocketServer:clientId WPF客戶端2-->>+WebSocketServer:創建監聽 Note over WPF客戶端2,WebSocketServer:clientId WebSocketServer->>WPF客戶端1:分發websocker消息 Note over WebSocketServer,WPF客戶端1:依據：cameraId=clientId WebSocketServer->>WPF客戶端2:分發websocker消息 Note over WebSocketServer,WPF客戶端2:依據：cameraId=clientId

設計

流程設計

用戶在瀏覽器界面執行新增業務數據操作，調用後端新增介面
WPF客戶端在啟動的時候初始化websocket客戶端，並創建對server的監聽
後端新增介面先將數據落庫，而後調用websocket服務端產生消息，消息在產生後立馬被髮送到了正在監聽中的websocket-client
websocket-server和websocket-client是一對多的關係，如何保證業務數據被正確的分發？監聽的時候給server端傳遞一個全局唯一的clientId，業務數據在產生的時候關聯到一個BizId上面，只要保證clientId=BizId就可以了。
刪除流程和新增類似

程式設計

WebSocketServer

概述

WebSocketServer端採用SpringBoot框架實現，通過在springboot-web項目中集成 org.springframework.boot:spring-boot-starter-websocket
實現websocket的能力。

新增pom



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

新增配置類



import org.springframework.context.annotation.Bean;

import org.springframework.context.annotation.Configuration;

import org.springframework.web.socket.config.annotation.EnableWebSocket;

import org.springframework.web.socket.server.standard.ServerEndpointExporter;

@Configuration
@EnableWebSocket
public class WebSocketConfig {
    @Bean
    public ServerEndpointExporter serverEndpointExporter() {
        return new ServerEndpointExporter();
    }
}

創建websocket端點



import com.alibaba.fastjson.JSON;
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;

@ServerEndpoint("/ws/label/{clientId}")
@Component
public class LabelWebSocket {
    /**
     * session list
     */
    private static ConcurrentHashMap<String, Session> sessionList = new ConcurrentHashMap<>();
    /**
     * 當前 clientId
     */
    private String currentClientId = "";
    @OnOpen
    public void open(Session session, @PathParam("clientId") String clientId) throws IOException {
        if (sessionList.containsKey(clientId)) {
            sessionList.remove(clientId);
        }
        sessionList.put(clientId, session);
        currentClientId = clientId;
        this.sendMsg(session, "connectok");
    }
    @OnClose
    public void close(Session session) throws IOException {
        sessionList.remove(currentClientId);
        System.out.println("連接關閉，session=" + JSON.toJSONString(session.getId()));
    }
    @OnMessage
    public void receiveMsg(Session session, String msg) throws IOException {
        this.sendMsg(session, "接收到的消息為：" + msg);
//        throw new RuntimeException("主動拋異常");
    }
    @OnError
    public void error(Session session, Throwable e) throws IOException {
        System.out.println("連接異常，session=" + JSON.toJSONString(session.getId()) + ";currentClientId=" + currentClientId);
        this.sendMsg(session, "發生異常,e=" + e.getMessage());
        e.printStackTrace();
    }
    /**
     * @param clientId
     * @param msg
     */
    public boolean sendMsg(String clientId, String msg) throws IOException {
        if (sessionList.containsKey(clientId)) {
            Session session = sessionList.get(clientId);
            this.sendMsg(session, msg);
            return true;
        } else {
            return false;
        }
    }
    private void sendMsg(Session session, String msg) throws IOException {
        session.getBasicRemote().sendText(msg);
    }
}

WebSocketClient

概述

WebSocketClient端集成在WPF應用客戶端中，通過前期調研，選中 WebSocketSharp 作為websocketclient工具，WebSocketSharp 是托管在Github的開源項目，MITLicense，目前4.9K的star。

安裝WebSocketSharp


//nuget

Install-Package WebSocketSharp -Pre

初始化client


WebSocket ws = new WebSocket("ws://127.0.0.1:8083/ws/xx/clientId");

創建連接



private void InitWebSocket()
{
    ws.OnOpen += (sender, e) =>
    {
        Console.WriteLine("onOpen");
    };
    //允許ping
    ws.EmitOnPing = true;
    //接收到xiaoxi
    ws.OnMessage += (sender, e) =>
    {
        ReceiveMessage(sender, e);
    };
    ws.Connect();
    //發送消息
    //ws.Send("BALUS")
    ;
}
private void ReceiveMessage(object sender, MessageEventArgs e)
{
    if (e.IsText)
    {
        // Do something with e.Data.like jsonstring
        Console.WriteLine(e.Data);
        return;
    }
    if (e.IsBinary)
    {
        // Do something with e.RawData. like  byte[]
        return;
    }
    if (e.IsPing)
    {
        // Do something to notify that a ping has been received.
        return;
    }
}

跨線程更新UI

由於 WebSocketSharp 會創建線程來處理 ReceiveMessage ，而WPF中子線程是無法更新UI的，所以需要引入 Dispatcher 來實現跨線程更新UI。

獲取當前線程名字


 //當前線程

string name = Thread.CurrentThread.ManagedThreadId.ToString();

示例代碼



private void ReceiveMessage(object sender, MessageEventArgs e)
{
    if (e.IsText)
    {
        // Do something with e.Data.like jsonstring
        Console.WriteLine(e.Data);
        //當前線程
        string name = Thread.CurrentThread.ManagedThreadId.ToString();
        App.Current.Dispatcher.Invoke((Action)(() =>
        {
            Image lab = new Image();
            lab.Uid = "123456";
            lab.Name = "labName";
            lab.Width = 50; lab.Height = 50;
            string url = "http://xxx:xxx/img/louyu.png";
            BitmapImage bitmapImage = HttpUtil.getImage(url);
            lab.Source = bitmapImage;
            lab.AddHandler(MouseLeftButtonDownEvent, new MouseButtonEventHandler(LabelClick));
            Canvas.SetTop(lab, 800);
            Canvas.SetLeft(lab, 600);
            this.cav.Children.Add(lab);
        }));
        return;
    }
}

介面設計

新增介面

概述

目前WebSocketServer和web後端服務是在同一個SpringBoot的工程中，所以只要將WebSocketServer托管到SpringContainer中，web後端服務可以通過 DI 的方式直接訪問 WebSocketEndPoint。

如果考慮程式的低耦合，可以在WebSocketServer和web後端服務之間架設一個MQ。

核心代碼


    @Autowired
    private LabelWebSocket ws;
    @GetMapping("/create")
    public boolean createLabel() throws IOException {
        String cameraId = "cml";
        //todo
        boolean result = ws.sendMsg(cameraId, "新增標簽");
        return result;
    }

風險

分散式風險

當前在 WebSocketServer 中，已經連接的client信息是記錄在當前進程的cache中，如果服務做橫向擴容，cache信息無法在多實例進程中傳遞，將導致無法正確的處理業務數據，並可能會發生意想不到的異常和bug，此問題在併發越高的情況下造成的影響越大

資源風險

web後端服務為基於java語言的springboot程式，這種類型程式的特點是記憶體消耗特別嚴重。WebSocketServer服務在本項目中僅用作消息中間件，連通web後端服務和WPF客戶端。

首先WebSocketServer沒有太多的計算能力的消耗，記憶體消耗會隨著連接客戶端數量的增長而增長，網路將是最大的開銷，一方面需要轉發來自web後端服務的業務數據，並和WPF客戶端保持長連接；另一方面WebSocketServer和WPF客戶端的交互可能會走公網，而其和web後端服務必然是在區域網環境。

綜上，將web後端服務和WebSocketServer分開部署對於硬體資源成本和利用率來說是最好的選擇。

高可用風險

未引入重試機制，當某一個環節失敗之後，將導致異常情況發生。

郵箱：[email protected]
技術交流QQ群：1158377441

基於WebSocket的實時消息傳遞設計

概述