在springboot项目中封装WebSocket成工具类

Spring Boot 中的 WebSocket 是一种在客户端和服务器之间建立双向通信的技术,允许实时传递数据。

WebSocket 的优势

  1. 双向通信:WebSocket 允许客户端和服务器之间进行双向通信,实时传递数据。
  2. 实时更新:WebSocket 可以实时更新客户端的数据,无需客户端手动刷新页面。
  3. 低延迟:WebSocket 的延迟比传统的 HTTP 请求低得多。

处理器的使用场景和选择

  • 文本消息:使用TextWebSocketHandler,适用于处理字符串或JSON消息。
  • 二进制消息:使用BinaryWebSocketHandler,适用于处理图像、文件等二进制数据。
  • Pong消息:使用PongWebSocketHandler,适用于心跳检测和保持连接。
  • 复杂需求:直接实现WebSocketHandler接口,提供自定义的消息处理逻辑。
  • 子协议:使用SubProtocolWebSocketHandler,适用于需要支持STOMP等子协议的应用(通常搭配消息队列一起使用)。

本文封装的是处理字符串消息。

1.引入依赖

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

2.配置webSocket配置类

import com.ruoyi.framework.handler.AlertWebSocketHandler;
import lombok.RequiredArgsConstructor;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.socket.config.annotation.EnableWebSocket;
import org.springframework.web.socket.config.annotation.WebSocketConfigurer;
import org.springframework.web.socket.config.annotation.WebSocketHandlerRegistry;
import org.springframework.web.socket.server.support.HttpSessionHandshakeInterceptor;

@Configuration
@EnableWebSocket
@RequiredArgsConstructor
public class WebSocketConfig implements WebSocketConfigurer {

    private final AlertWebSocketHandler webSocketHandler;

    @Override
    public void registerWebSocketHandlers(WebSocketHandlerRegistry registry) {
        //配置websocket客户端请求入口
        registry.addHandler(webSocketHandler, "/wms/websocket")
            .addInterceptors(new HttpSessionHandshakeInterceptor())
            .setAllowedOrigins("*");
    }
}

3.封装工具类(Handle处理类)


import org.springframework.web.socket.WebSocketSession;
import org.springframework.web.socket.handler.TextWebSocketHandler;
import org.springframework.web.socket.TextMessage;
import org.springframework.web.socket.CloseStatus;
import org.springframework.stereotype.Component;

import java.util.concurrent.ConcurrentHashMap;

@Component
public class WebSocketHandler extends TextWebSocketHandler {

    private ConcurrentHashMap<String, WebSocketSession> sessions = new ConcurrentHashMap<>();
       
    //建立连接后调用
    @Override
    public void afterConnectionEstablished(WebSocketSession session) throws Exception {
        sessions.put(session.getId(), session);
    }

    @Override
    protected void handleTextMessage(WebSocketSession session, TextMessage message) throws Exception {
        // 处理收到的消息
        session.sendMessage(new TextMessage("你好!" + session.getId() + ":" + message.getPayload()));
    }

    @Override
    public void afterConnectionClosed(WebSocketSession session, CloseStatus status) throws Exception {
        sessions.remove(session.getId());
    }
    
    //给所有客户端发送消息
    public void sendMessageToAll(String message) throws Exception {
        for (WebSocketSession session : sessions.values()) {
            if (session.isOpen()) {
                session.sendMessage(new TextMessage(message));
            }
        }
    }

    //给指定客户端发送消息
    public void sendMessageToClient(String sessionId, String message) throws Exception {
        WebSocketSession session = sessions.get(sessionId);
        if (session != null && session.isOpen()) {
            session.sendMessage(new TextMessage(message));
        }
    }
}

### 关于Spring BootWebSocket工具类封装 在构建基于Spring Boot的应用程序时,为了简化WebSocket的操作流程以及提高代码复用率,通常会创建一些辅助性的工具类来处理常见的操作。下面展示了一个简单的WebSocket工具类的设计思路及其部分核心功能实现。 #### WebSocket配置器定义 首先需要自定义一个`WebSocketConfig`类用于注册服务器端点和其他必要的组件: ```java import org.springframework.context.annotation.Configuration; import org.springframework.web.socket.config.annotation.EnableWebSocket; import org.springframework.web.socket.config.annotation.WebSocketConfigurer; import org.springframework.web.socket.config.annotation.WebSocketHandlerRegistry; @Configuration @EnableWebSocket public class WebSocketConfig implements WebSocketConfigurer { @Override public void registerWebSocketHandlers(WebSocketHandlerRegistry registry) { // 注册handler并指定路径前缀 registry.addHandler(new MyWebSocketHandler(), "/ws").setAllowedOrigins("*"); } } ``` 此段代码实现了基本的WebSocket服务端口映射设置[^2]。 #### 自定义消息处理器 接着可以编写专门负责接收客户端发送过来的数据包,并对其进行解析和响应的消息处理器——`MyWebSocketHandler`: ```java import org.springframework.web.socket.CloseStatus; import org.springframework.web.socket.TextMessage; import org.springframework.web.socket.WebSocketSession; import org.springframework.web.socket.handler.TextWebSocketHandler; public class MyWebSocketHandler extends TextWebSocketHandler { @Override protected void handleTextMessage(WebSocketSession session, TextMessage message) throws Exception { System.out.println("Received Message:" + message.getPayload()); // 发送回执给客户端 String response = "Echo: " + message.getPayload(); session.sendMessage(new TextMessage(response)); } @Override public void afterConnectionClosed(WebSocketSession session, CloseStatus status) throws Exception { super.afterConnectionClosed(session, status); System.out.println("Client disconnected."); } } ``` 上述示例展示了如何继承`TextWebSocketHandler`来自定义行为逻辑[^3]。 #### 构建通用工具函数 最后,在实际开发过程还可以进一步抽象出更多实用的方法供其他模块调用,比如建立连接、断开连接或是广播信息等功能都可以被提取出来形独立的服务层接口或静态方法集合。这里给出一段可能存在的工具类片段作为参考: ```java import java.util.concurrent.CopyOnWriteArraySet; import javax.websocket.OnClose; import javax.websocket.OnError; import javax.websocket.OnMessage; import javax.websocket.OnOpen; import javax.websocket.Session; import javax.websocket.server.ServerEndpoint; @ServerEndpoint("/chat") public class ChatRoomUtil { private static final CopyOnWriteArraySet<ChatRoomUtil> chatRooms = new CopyOnWriteArraySet<>(); @OnOpen public void onOpen(Session userSession){ chatRooms.add(this); broadcast("New User Joined!"); } @OnMessage public void handleMessage(String message, Session userSession){ broadcast(message); } @OnClose public void onClose(){ chatRooms.remove(this); broadcast("User Left..."); } @OnError public void onError(Throwable error){ error.printStackTrace(); } private static synchronized void broadcast(String msg){ for(ChatRoomUtil room : chatRooms){ try{ room.session.getBasicRemote().sendText(msg); }catch(Exception e){ e.printStackTrace(); } } } // 假设存在session属性存储当前用户的会话对象... } ``` 这段Java EE风格的Websocket编程模式同样适用于某些场景下的需求满足[^4]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值