天空海搁浅的鲸 發表於 2025-10-26 00:03:00

WebSocket

<h1 id="maven坐标">maven坐标</h1>
<pre><code class="language-xml">&lt;!-- websocket: 提供了对 WebSocket 协议的支持 --&gt;
&lt;dependency&gt;
    &lt;groupId&gt;org.springframework.boot&lt;/groupId&gt;
    &lt;artifactId&gt;spring-boot-starter-websocket&lt;/artifactId&gt;
&lt;/dependency&gt;
</code></pre>
<h1 id="简单的前后端websocket连接示例">简单的前后端WebSocket连接示例</h1>
<h2 id="websocket-连接完整流程">WebSocket 连接完整流程</h2>
<h3 id="连接建立阶段">连接建立阶段</h3>
<p>前端初始化:</p>
<p>后端接收连接:</p>
<pre><code class="language-plain">@OnOpen
public void onOpen(Session session, @PathParam("sid") String sid) {
    System.out.println("客户端:" + sid + "建立连接");
    sessionMap.put(sid, session);
}
</code></pre>
<p>连接确认:</p>
<h3 id="消息交互阶段">消息交互阶段</h3>
<p>前端发送消息:</p>
<pre><code class="language-plain">function send(){
    var message = document.getElementById('text').value;
    websocket.send(message);
}
</code></pre>
<p>后端接收处理消息:</p>
<pre><code class="language-plain">@OnMessage
public void onMessage(String message, @PathParam("sid") String sid) {
    System.out.println("收到来自客户端:" + sid + "的信息:" + message);
}
</code></pre>
<p>后端主动推送消息:</p>
<pre><code class="language-plain">public void sendToAllClient(String message) {
    Collection&lt;Session&gt; sessions = sessionMap.values();
    for (Session session : sessions) {
      try {
            //服务器向客户端发送消息
            session.getBasicRemote().sendText(message);
      } catch (Exception e) {
            e.printStackTrace();
      }
    }
}
</code></pre>
<p>前端接收消息:</p>
<pre><code class="language-plain">websocket.onmessage = function(event){
    setMessageInnerHTML(event.data);
}
function setMessageInnerHTML(innerHTML){
    document.getElementById('message').innerHTML += innerHTML + '&lt;br/&gt;';
}
</code></pre>
<h3 id="连接关闭阶段">连接关闭阶段</h3>
<ol>
<li>
<p>主动关闭:</p>
<ul>
<li>
<p>用户点击 "关闭连接" 按钮,触发 <code>closeWebSocket()</code> 函数</p>
</li>
<li>
<p>调用 <code>websocket.close()</code> 方法关闭连接</p>
</li>
</ul>
</li>
</ol>
<pre><code class="language-plain">function closeWebSocket() {
    websocket.close();
}
</code></pre>
<ol>
<li>
<p>页面关闭时关闭连接:</p>
<ul>
<li>
<p>监听 <code>window.onbeforeunload</code> 事件,在页面关闭前主动关闭 WebSocket 连接</p>
</li>
<li>
<p>防止连接未断开就关闭页面导致服务器抛出异常</p>
</li>
</ul>
</li>
</ol>
<pre><code class="language-plain">window.onbeforeunload = function(){
    websocket.close();
}
</code></pre>
<p>后端处理关闭:</p>
<pre><code class="language-plain">@OnClose
public void onClose(@PathParam("sid") String sid) {
    System.out.println("连接断开:" + sid);
    sessionMap.remove(sid);
}
</code></pre>
<p>前端关闭回调</p>
<h1 id="简单的代码实现">简单的代码实现</h1>
<h2 id="注册websocket的serverendpointexporter"><em>注册WebSocket的ServerEndpointExporter</em></h2>
<pre><code class="language-typescript">@Configuration
public class WebSocketConfiguration {
    /**
   * 注册WebSocket的ServerEndpointExporter
   * 扫描带有@ServerEndpoint注解的类,并注册成websocket服务
   *
   * ServerEndpointExporter是Spring框架提供的一个用于支持WebSocket的核心组件,它的主要作用是:
   * 扫描并注册WebSocket端点:自动检测Spring容器中带有@ServerEndpoint注解的类,并将它们注册为WebSocket端点
   * 创建和管理WebSocket实例:负责为每个WebSocket连接创建对应的端点实例
   * 连接生命周期管理:处理WebSocket连接的建立、消息传输和关闭等生命周期事件
   *
   * @return
   */
    @Bean
    public ServerEndpointExporter serverEndpointExporter() {
      return new ServerEndpointExporter();
    }
}
</code></pre>
<h2 id="定义websocket服务端组件"><strong>定义WebSocket服务端组件</strong></h2>
<pre><code class="language-typescript">@Component
@ServerEndpoint("/ws/{sid}")
public class WebSocketServer {
    //存放会话对象
    private static Map&lt;String, Session&gt; 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&lt;Session&gt; sessions = sessionMap.values();
      for (Session session : sessions) {
            try {
                //服务器向客户端发送消息
                session.getBasicRemote().sendText(message);
            } catch (Exception e) {
                e.printStackTrace();
            }
      }
    }
}
</code></pre>
<h2 id="简单的前端">简单的前端</h2>
<pre><code class="language-html">&lt;!DOCTYPE HTML&gt;
&lt;html&gt;
&lt;head&gt;
    &lt;meta charset="UTF-8"&gt;
    &lt;title&gt;WebSocket Demo&lt;/title&gt;
&lt;/head&gt;
&lt;body&gt;
&lt;input id="text" type="text" /&gt;
&lt;button onclick="send()"&gt;发送消息&lt;/button&gt;
&lt;button onclick="closeWebSocket()"&gt;关闭连接&lt;/button&gt;
&lt;div id="message"&gt;
&lt;/div&gt;
&lt;/body&gt;
&lt;script type="text/javascript"&gt;
    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 + '&lt;br/&gt;';
    }

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

    //关闭连接
    function closeWebSocket() {
      websocket.close();
    }
&lt;/script&gt;
&lt;/html&gt;
</code></pre>


</div>
<div id="MySignature" role="contentinfo">
    <p>本文来自博客园,作者:Nobody_Cares,转载请注明原文链接:https://www.cnblogs.com/NobodyCares/p/19166168</p>
<span id="jinrishici-sentence">正在加载今日诗词....</span><br><br>
来源:https://www.cnblogs.com/NobodyCares/p/19166168
頁: [1]
查看完整版本: WebSocket