SpringBoot如何集成WebSocket

在Spring Boot中集成WebSocket有多种方式,以下是三种常见的集成方式及其配置步骤:

一、使用Javax.websocket原生注解

  1. 添加依赖:

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

    xml 复制代码
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-websocket</artifactId>
    </dependency>
  2. 配置服务端点:

    使用@ServerEndpoint注解来标记WebSocket服务端点,并配置路径。在类中添加处理连接打开、关闭、接收消息和异常的方法,分别使用@OnOpen、@OnClose、@OnMessage和@OnError注解来标记。

    java 复制代码
    @Component
    @ServerEndpoint("/websocket/{type}")
    public class JavaxWebSocketServerEndpoint {
    
        @OnOpen
        public void onOpen(Session session, EndpointConfig config, @PathParam("type") String type) {
            // 连接建立
        }
    
        @OnClose
        public void onClose(Session session, CloseReason reason) {
            // 连接关闭
        }
    
        @OnMessage
        public void onMessage(Session session, String message) {
            // 接收文本信息
        }
    
        @OnMessage
        public void onMessage(Session session, PongMessage message) {
            // 接收pong信息
        }
    
        @OnMessage
        public void onMessage(Session session, ByteBuffer message) {
            // 接收二进制信息
        }
    
        @OnError
        public void onError(Session session, Throwable e) {
            // 异常处理
        }
    }
  3. 配置Spring Boot以支持Javax.websocket:

    创建一个配置类,并手动注入ServerEndpointExporter,以便Spring Boot能够扫描到WebSocket的注解。

    java 复制代码
    @Configuration(proxyBeanMethods = false)
    public class JavaxWebSocketConfiguration {
    
        @Bean
        public ServerEndpointExporter serverEndpointExporter() {
            return new ServerEndpointExporter();
        }
    }

二、使用Spring封装的WebSocket

  1. 添加依赖:

    同样在pom.xml文件中添加Spring Boot WebSocket的依赖。

  2. 配置WebSocket处理器:

    实现WebSocketHandler接口,并在配置类中注册该处理器。,并在配置类中注册该处理器。

    java 复制代码
    @Component
    public class MyWebSocketHandler implements WebSocketHandler {
    
        @Override
        public void handleTextMessage(WebSocketSession session, TextMessage {
    
        @Override
        public void handleTextMessage(WebSocketSession session, TextMessage message) throws Exception {
            // 处理文本消息
            String payload = message.getPayload();
            session.sendMessage(new TextMessage("服务器收到:" + payload));
        }
        // 其他方法如afterConnectionEstablished, afterConnectionClosed, handleTransportError等也需要实现
    }
    
    
    
    @EnableWebSocket
    @Configuration
    public class WebSocketConfig implements WebSocketConfigurer {
        @Autowired
        private MyWebSocketHandler webSocketHandler;
        @Override
        public void registerWebSocketHandlers(WebSocketHandlerRegistry registry) {
            registry.addHandler(webSocketHandler, "/testWs").setAllowedOrigins("*");
        }
    }

三、使用Spring封装的STOMP协议

STOMP(Simple Text Oriented Messaging Protocol)是一个简单的文本协议,用于在客户端和服务器之间进行消息传递。虽然它提供了更多的功能,但相对来说也更加复杂。

  1. 添加依赖:

    除了Spring Boot WebSocket的依赖外,还需要添加Spring Messaging的依赖。

  2. 配置STOMP端点和消息代理:

    在配置类中配置STOMP端点和消息代理,如RabbitMQ或ActiveMQ等。

  3. 实现消息处理器:

    使用@MessageMapping注解来标记处理客户端发送消息的方法。

  4. 客户端配置:

    客户端需要使用STOMP协议的客户端库来连接服务器,并发送和接收消息。

总结

以上三种方式都可以在Spring Boot中集成WebSocket,选择哪种方式取决于具体的需求和项目的复杂度。对于简单的WebSocket应用,使用Javax.websocket原生注解或Spring封装的WebSocket已经足够;而对于需要更复杂消息传递和路由的应用,可以考虑使用Spring封装的STOMP协议。

相关推荐
Csvn18 小时前
安装、升级与目录结构
后端·nginx
皮皮林55118 小时前
万能通用!权限系统就该这么设计
后端
RuoyiOffice19 小时前
SpringBoot+Vue3 凭证生命周期设计:审核、过账、冲销与反过账怎样保持账目一致
java·spring boot·事务·springboot3·财务系统·会计凭证·ruoyi office
GoAI19 小时前
DeepSeek Harness Memory (一)主流记忆插件总结
后端·算法·面试
橙子家20 小时前
RESTful 接口:它并非标准或协议,而是一种【架构风格】
后端
RuoyiOffice20 小时前
KubeSphere 容器云实践:从管理 K8s 到建设企业 PaaS,还需要哪些能力
spring boot·kubernetes·kubesphere·jenkins·paas·微服务部署·ruoyi office
小兔子21 小时前
dict.get 的默认值每次都会求值,哪怕键本来就在
后端
斯维赤21 小时前
限流、熔断、降级,你真的分得清吗?
java·后端·架构
肌肉娃子21 小时前
红队攻防测试报告 — wechat-e.cfd
后端
陈随易21 小时前
Cmder 停更 17 个月,2.0 支持 Windows Terminal
前端·后端·程序员