• Java实战:Spring Boot实现WebSocket实时通信


    本文将详细介绍如何在Spring Boot应用程序中实现WebSocket实时通信。我们将探讨WebSocket的基本概念,以及如何使用Spring Boot和Spring WebSocket模块来实现WebSocket服务器和客户端。此外,我们将通过具体的示例来展示如何在Spring Boot应用程序中配置和使用WebSocket,以及如何实现实时消息传递和群发消息等功能。本文适合希望使用WebSocket技术实现实时通信的Spring Boot开发者阅读。

    一、引言

    在现代Web应用程序中,实时通信是一个关键需求,用于实现即时消息传递、在线聊天、实时数据同步等功能。WebSocket是一种网络通信协议,它提供了一种全双工通信渠道,允许服务器和客户端之间进行实时数据交换。Spring Boot提供了一种简便的方式来集成WebSocket技术,以实现实时通信功能。本文将介绍如何在Spring Boot应用程序中实现WebSocket实时通信。

    二、WebSocket的基本概念

    1. 什么是WebSocket?
    WebSocket是一种网络通信协议,它提供了一种全双工通信渠道,允许服务器和客户端之间进行实时数据交换。WebSocket协议基于TCP协议,通过WebSocket连接,服务器和客户端可以相互发送消息,实现实时通信。
    2. WebSocket的特点

    • 全双工通信:WebSocket协议支持服务器和客户端之间的全双工通信,客户端和服务器可以同时发送消息。
    • 持久连接:WebSocket连接一旦建立,将持续保持打开状态,直到客户端或服务器关闭连接。
    • 跨域通信:WebSocket协议支持跨域通信,允许不同域的服务器与客户端建立连接。

    三、在Spring Boot中实现WebSocket实时通信

    1. 添加Spring WebSocket依赖
    在项目的pom.xml文件中,添加Spring Boot的Spring WebSocket依赖:

    <dependencies>
        
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-webartifactId>
        dependency>
        
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-websocketartifactId>
        dependency>
    dependencies>
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12

    2. 创建WebSocket配置类
    创建一个WebSocket配置类,用于配置WebSocket服务器端点。以下是一个简单的WebSocket配置类示例:

    package com.example.demo.config;
    import org.springframework.context.annotation.Configuration;
    import org.springframework.messaging.simp.config.MessageBrokerRegistry;
    import org.springframework.web.socket.config.annotation.*;
    @Configuration
    @EnableWebSocketMessageBroker
    public class WebSocketConfig implements WebSocketMessageBrokerConfigurer {
        @Override
        public void configureMessageBroker(MessageBrokerRegistry config) {
            config.enableSimpleBroker("/topic");
            config.setApplicationDestinationPrefixes("/app");
        }
        @Override
        public void registerStompEndpoints(StompEndpointRegistry registry) {
            registry.addEndpoint("/websocket-endpoint").withSockJS();
        }
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17

    在上面的代码中,我们创建了一个名为WebSocketConfig的配置类,它实现了WebSocketMessageBrokerConfigurer接口。这个类用于配置WebSocket消息代理和注册STOMP(Simple Text Oriented Messaging Protocol)端点。
    3. 创建消息模型
    创建一个简单的消息模型类,用于表示WebSocket消息。以下是一个简单的消息模型类示例:

    package com.example.demo.model;
    public class Message {
        private String content;
        private String sender;
        // getter和setter方法
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6

    在上面的代码中,我们创建了一个名为Message的模型类,它包含两个属性:contentsender
    4. 创建消息处理器
    创建一个消息处理器类,用于处理WebSocket消息。以下是一个简单的消息处理器类示例:

    package com.example.demo.handler;
    import org.springframework.messaging.handler.annotation.MessageMapping;
    import org.springframework.messaging.handler.annotation.SendTo
    import org.springframework.stereotype.Controller;
    @Controller
    public class MessageHandler {
        @MessageMapping("/send")
        @SendTo("/topic/messages")
        public Message sendMessage(Message message) {
            return new Message("Hello, WebSocket!", "System");
        }
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12

    在上面的代码中,我们创建了一个名为MessageHandler的控制器类,它包含一个名为sendMessage的方法。这个方法将处理发送到/send目的地的消息,并将消息发送到/topic/messages主题。
    5. 创建前端代码
    创建一个简单的HTML页面和JavaScript代码,用于连接到WebSocket服务器并发送消息。以下是一个简单的HTML页面示例:

    DOCTYPE html>
    <html>
    <head>
        <title>WebSocket Demotitle>
        <script src="https://cdn.jsdelivr.net/npm/sockjs-client/dist/sockjs.min.js">script>
        <script src="https://cdn.jsdelivr.net/npm/stompjs/lib/stomp.min.js">script>
    head>
    <body>
        <div>
            <input type="text" id="messageInput" placeholder="Type a message...">
            <button onclick="sendMessage()">Sendbutton>
        div>
        <ul id="messagesList">ul>
        <script>
            var socket = new SockJS('/websocket-endpoint');
            var stompClient = Stomp.over(socket);
            stompClient.connect({}, function (frame) {
                stompClient.subscribe('/topic/messages', function (message) {
                    var messagesList = document.getElementById('messagesList');
                    var listItem = document.createElement('li');
                    listItem.textContent = message.body;
                    messagesList.appendChild(listItem);
                });
            });
            function sendMessage() {
                var messageInput = document.getElementById('messageInput');
                stompClient.send('/app/send', {}, messageInput.value);
                messageInput.value = '';
            }
        script>
    body>
    html>
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32

    在上面的代码中,我们创建了一个简单的HTML页面,包含一个输入框和一个按钮。当用户点击按钮时,JavaScript代码会连接到WebSocket服务器,并订阅/topic/messages主题。当服务器发送消息到该主题时,JavaScript代码会将消息添加到页面上的消息列表。

    四、实现实时消息传递和群发消息

    1. 实时消息传递
    要实现实时消息传递,我们可以在MessageHandler类中创建一个方法,用于接收并处理从客户端发送的消息。以下是一个实现实时消息传递的示例:

    package com.example.demo.handler;
    import org.springframework.messaging.handler.annotation.MessageMapping;
    import org.springframework.messaging.handler.annotation.SendTo;
    import org.springframework.stereotype.Controller;
    @Controller
    public class MessageHandler {
        // 省略其他代码
        @MessageMapping("/receive")
        @SendTo("/topic/messages")
        public Message receiveMessage(Message message) {
            return new Message("Received your message: " + message.getContent(), "System");
        }
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13

    在上面的代码中,我们添加了一个名为receiveMessage的方法,用于接收并处理发送到/receive目的地的消息。这个方法会将接收到的消息发送到/topic/messages主题。
    2. 群发消息
    要实现群发消息,我们可以在WebSocketConfig类中配置一个广播代理。以下是一个实现群发消息的示例:

    package com.example.demo.config;
    import org.springframework.context.annotation.Configuration;
    import org.springframework.messaging.simp.config.MessageBrokerRegistry;
    import org.springframework.web.socket.config.annotation.*;
    @Configuration
    @EnableWebSocketMessageBroker
    public class WebSocketConfig implements WebSocketMessageBrokerConfigurer {
        // 省略其他代码
        @Override
        public void configureMessageBroker(MessageBrokerRegistry config) {
            config.enableSimpleBroker("/topic");
            config.setApplicationDestinationPrefixes("/app");
            config.setBrokerDeliveryMode(MessageBrokerRegistry.BrokerDeliveryMode.BROADCASTING);
        }
        // 省略其他代码
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16

    在上面的代码中,我们通过将setBrokerDeliveryMode方法的参数设置为BROADCASTING来启用广播代理。这意味着所有发送到/topic/messages主题的消息都会被广播到所有连接的客户端。

    五、总结

    本文详细介绍了如何在Spring Boot应用程序中实现WebSocket实时通信。我们首先了解了WebSocket的基本概念和特点,然后学习了如何使用Spring Boot和Spring WebSocket模块来实现WebSocket服务器和客户端。我们还通过具体的示例展示了如何在Spring Boot应用程序中配置和使用WebSocket,以及如何实现实时消息传递和群发消息等功能。
    通过本文,您应该已经掌握了如何使用Spring Boot实现WebSocket实时通信。您学会了如何添加Spring WebSocket依赖、创建WebSocket配置类、创建消息模型、创建消息处理器,以及如何实现实时消息传递和群发消息。希望本文能够帮助您在开发Spring Boot应用程序时更加得心应手。如果您有任何疑问或建议,请随时留言交流。

  • 相关阅读:
    操作系统 day11(进程调度时机、切换、调度方式)
    整流器制造5G智能工厂物联数字孪生平台,推进制造业数字化转型
    python毕业设计作品基于django框架 电影院购票选座系统毕设成品(7)中期检查报告
    nvm安装后node或npm不是内部或外部命令
    Text ‘10/03/2023 14:25:49‘ could not be parsed at index 0
    camx 主要接口
    油气田勘探数字化转型现状及展望
    springboot基础(34):Elasticsearch的基本操作
    首都博物京韵展,监测系统实现文物科技保护
    金仓数据库KingbaseES客户端编程接口指南-Gokb(2. 概述)
  • 原文地址:https://blog.csdn.net/oandy0/article/details/136280283