SpringBoot使用WebSocket

本文详细介绍了如何在SpringBoot项目中使用WebSocket实现前后端实时通信。包括在pom.xml中添加依赖、配置websocketConf.java文件以支持跨域,以及如何在Controller中使用SimpMessagingTemplate进行消息推送。前端部分则通过SockJS和STOMP实现与后端的连接和消息订阅。

SpringBoot使用WebSocket quickStart

后台步骤

1.maven 配置,在pom.xml文件中依赖项添加如下依赖。

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

2.springboot配置,添加websocketConf.java文件。其中"/test/Socket"为前端订阅地址,前端以http请求方式访问该地址即可连接socket。当做前后端分离,需要跨域时,需要添加setAllowedOrigins("*")容许跨域。

@Configuration
@EnableWebSocketMessageBroker
public class WebSocketConfig extends AbstractWebSocketMessageBrokerConfigurer {

    @Override
    public void registerStompEndpoints(StompEndpointRegistry registry) {
        registry.addEndpoint("/test/Socket").setAllowedOrigins("*").withSockJS();
    }

    @Override
    public void configureMessageBroker(MessageBrokerRegistry registry) {
        registry.enableSimpleBroker("/topic");
        registry.setApplicationDestinationPrefixes("/app");
    }
}

3.声明SimpMessagingTemplate (或者使用@SendTo和@SendToUser注解)
在需要用到推送的地方如Controller,service,Component等地方声明SimpMessagingTemplate

    @Resource
    private SimpMessagingTemplate messagingTemplate;

当需要向客户端推送消息时,调用convertAndSend方法,即可推送消息,此处“/topic/send”可随意设置,所有前端订阅该url的客户端都可以收到推送的消息。

    messagingTemplate.convertAndSend("/topic/send", result);

前端步骤

1.导入sockjs.min.js,stomp.min.js,下载地址
3.定义socket对象(可替换成函数)

  function Socket(url) {
      this.stompClient = null;
      this.connect = function(obj, socketUrl, subscribeUrl, uid){
          var _this = this;
          var socket = new SockJS(socketUrl);
          this.stompClient = Stomp.over(socket);
          this.stompClient.connect({}, function (frame) {
              _this.subscribe(obj, subscribeUrl, uid);
          });
      }
      this.disconnect = function(){
        if (this.stompClient != null) {
            this.stompClient.disconnect();
        }
        console.log("Disconnected");
      }
      this.subscribe = function(obj, subscribeUrl, uid){
          this.stompClient.subscribe(subscribeUrl, function(message){
          });
      }
  }

4.连接socket

 var socket = new Socket();
 socket.connect(that, http://localhost:8080/test/Socket, "/topic/send", uid);
 //这里uid可以省略,加上uid是当后台推送消息时,前端做消息识别

5.断开socket

 socket.disconnect();
<think>首先,用户查询是关于Spring Boot中使用WebSocket的方法和示例。用户明确提到查找使用指南、案例等,所以我需要基于提供的引用来回答。 回顾引用: - [^1]: 这是一个概述,包括集成步骤、常用方法(消息收发、点对点消息、拦截、认证、基于注解的实现)。 - [^2]: 介绍了WebSocket的基本概念和在Spring Boot中构建实时应用的容易性。 - [^3]: 提供了详细的配置方法、工作原理、消息推送、文件上传下载、聊天室实现、部署和测试。 - [^4]: 展示了一种配置方法,使用@Bean ServerEndpointExporter。 系统级指令: - 所有行内数学表达式用$...$,但这里没有数学内容,所以忽略。 - 独立公式用$$...$$并单独成段,同样不适用。 - LaTeX语法正确:不涉及数学,所以确保代码块正确。 - 使用中文回答。 - 生成相关问题:在回答后添加相关问题。 - 引用段落末尾添加引用标识,例如[^1]。 回答结构: - 必须清晰、逐步解决问题。 - 尽量真实可靠,基于引用。 用户上一次问题:用户说“参考站内引用...我想查找Spring Boot使用WebSocket的相关内容”,所以我应基于这些引用构建回答。 关键点: - 集成步骤。 - 常用方法。 - 配置方法。 - 示例代码。 从引用中提取: - [^3]提到配置:WebSocket协议、Spring Boot配置、实现消息推送等。 - [^4]给出配置代码:使用@Bean ServerEndpointExporter。 - [^1]提到注解-based实现。 - 所有引用都强调实时应用如聊天室。 回答结构: 1. 介绍WebSocket在Spring Boot中的重要性(基于引用)。 2. 配置方法:参考[^4]和[^3]。 3. 常用方法:如消息收发、点对点(基于[^1])。 4. 提供示例代码:可能来自[^4]或一般知识,但引用中没有具体示例代码,只有配置片段。我需要推断或基于通用知识提供简单示例。引用[^4]有一段代码,我可以使用它。 5. 结束时添加相关问题。 引用标识:在引用的段落末尾添加,如[^1]。 生成相关问题:在回答后类似示例添加。 完整回答: - 开头简要介绍。 - 步骤或方法部分。 - 示例代码块。 - 结尾相关问题。 确保中文。 示例代码从引用[^4]: ```java @Configuration @ConditionalOnWebApplication public class WebSocketConfig { @Bean public ServerEndpointExporter serverEndpointExporter() { return new ServerEndpointExporter(); } } ``` 我可以扩展这个或添加更多。 基于[^1],提到基于注解的实现,所以我可以展示一个WebSocket端点示例。 标准Spring Boot WebSocket实现: - 使用@ServerEndpoint注解定义一个端点。 - 方法如@OnOpen, @OnMessage等。 提供一个简单聊天室示例。 回答大纲: 1. **介绍**:简述WebSocket和Spring Boot的支持(参考引用)。 2. **配置方法**:描述如何配置(引用[^4]代码)。 3. **实现步骤**: - 创建WebSocket端点类。 - 使用注解定义事件处理方法。 - 示例代码。 4. **常用功能**:如点对点消息、拦截(基于[^1])。 5. **相关问题**:生成几个相关的问题。 相关问题示例: 1. WebSocket在Spring Boot中如何进行认证? 2. 如何优化WebSocket性能? 3. 常见问题及解决方案? 引用添加:在描述时,如果有具体引用部分,末尾加[^n]。 最终回答结构: - 段落清晰。 - 代码块用 ``` 包裹。 - 结束有相关问题。 </think>### Spring Boot 使用 WebSocket 的方法和示例 在 Spring Boot 中集成 WebSocket 可以轻松构建实时应用程序,如在线聊天、实时通知等。WebSocket 协议支持全双工通信,允许服务器与客户端之间建立持久连接。Spring Boot 通过 Spring Framework 的 WebSocket 模块提供了简化支持,包括配置和注解方式实现。以下内容基于引用资料整理,逐步介绍使用方法和示例代码。 #### 1. **配置 WebSocket** Spring Boot 需要配置 `ServerEndpointExporter` Bean 来启用 WebSocket 服务端功能。这种方法基于引用[^4]中描述的配置方式,适用于大多数应用场景。配置类示例如下: ```java import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.boot.autoconfigure.condition.ConditionalOnWebApplication; import org.springframework.web.socket.server.standard.ServerEndpointExporter; @Configuration @ConditionalOnWebApplication public class WebSocketConfig { @Bean public ServerEndpointExporter serverEndpointExporter() { return new ServerEndpointExporter(); // 自动注册使用 @ServerEndpoint 注解的类 } } ``` - **说明**:此配置类在 Spring Boot 应用启动时自动扫描并注册 WebSocket 端点。`@ConditionalOnWebApplication` 确保只在 Web 环境中启用[^4]。 #### 2. **定义 WebSocket 端点** 基于引用[^1]和[^3],推荐使用注解方式实现 WebSocket 端点。例如,创建一个简单的消息收发端点: ```java import javax.websocket.OnMessage; import javax.websocket.OnOpen; import javax.websocket.Session; import javax.websocket.server.ServerEndpoint; import java.io.IOException; @ServerEndpoint("/chat") // 定义端点路径 public class ChatEndpoint { @OnOpen public void onOpen(Session session) { System.out.println("客户端连接成功: " + session.getId()); // 连接建立时触发 } @OnMessage public void onMessage(String message, Session session) throws IOException { System.out.println("收到消息: " + message); // 发送消息回客户端 session.getBasicRemote().sendText("服务器回复: " + message); } } ``` - **功能**:此端点处理客户端连接(`@OnOpen`)和消息接收(`@OnMessage`),实现简单的一对一消息收发[^1]。 - **使用方法**:客户端通过 WebSocket URL 如 `ws://localhost:8080/chat` 连接并发送消息。 #### 3. **常用方法扩展** 引用[^1]强调了进阶功能,如点对点消息发送和消息拦截: - **点对点消息**:通过会话 ID 指定接收者。 ```java @OnMessage public void onMessage(String message, Session sender) throws IOException { String recipientId = parseRecipient(message); // 解析接收者ID for (Session session : sender.getOpenSessions()) { if (session.getId().equals(recipientId)) { session.getBasicRemote().sendText("私信: " + message); } } } ``` - **消息拦截与认证**:使用 `HandshakeInterceptor` 或过滤器实现权限检查,防止未授权访问[^1]。 #### 4. **示例:简单聊天室** 基于引用[^3]中提到的聊天室实现,扩展为多人聊天应用: ```java import javax.websocket.*; import javax.websocket.server.ServerEndpoint; import java.util.Collections; import java.util.HashSet; import java.util.Set; @ServerEndpoint("/chat-room") public class ChatRoomEndpoint { private static final Set<Session> sessions = Collections.synchronizedSet(new HashSet<>()); @OnOpen public void onOpen(Session session) { sessions.add(session); broadcast("用户 " + session.getId() + " 加入聊天室"); } @OnMessage public void onMessage(String message, Session sender) { broadcast(sender.getId() + ": " + message); // 广播消息给所有用户 } @OnClose public void onClose(Session session) { sessions.remove(session); broadcast("用户 " + session.getId() + " 离开聊天室"); } private void broadcast(String message) { sessions.forEach(session -> { try { session.getBasicRemote().sendText(message); } catch (IOException e) { e.printStackTrace(); } }); } } ``` - **运行效果**:多个客户端连接后,消息实时广播,适合在线协作工具[^3]。 - **部署**:Spring Boot 应用可直接运行,或结合 Docker/Kubernetes 部署(参考引用[^3])。 #### 5. **最佳实践与注意事项** - **性能优化**:限制连接数、使用异步消息处理(如 `AsyncRemote`),避免阻塞线程[^1]。 - **错误处理**:添加 `@OnError` 方法处理异常,确保服务稳定性。 - **测试建议**:使用工具如 `WebSocketClient` 进行单元测试,验证消息链路[^3]。 以上方法基于 Spring Boot 的注解配置,简化了 WebSocket 开发。实际应用中,可以根据需求集成消息队列(如 RabbitMQ)提升扩展性[^1]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值