WebSocketHandler 是 Spring Framework 中用于处理 WebSocket 通信的接口

WebSocketHandler 是 Spring Framework 中用于处理 WebSocket 通信的接口，其主要作用是定义了如何处理 WebSocket 的各种事件和消息。以下是 WebSocketHandler 的主要作用和功能：

### 1. 处理 WebSocket 生命周期事件
WebSocketHandler 定义了多个方法来处理 WebSocket 的生命周期事件，包括：
- **连接建立**：`afterConnectionEstablished(WebSocketSession session)` 方法在 WebSocket 连接建立后被调用，可以用于初始化会话或记录日志等操作。
- **消息处理**：`handleMessage(WebSocketSession session, WebSocketMessage<?> message)` 方法用于处理从客户端接收到的消息。
- **连接关闭**：`afterConnectionClosed(WebSocketSession session, CloseStatus status)` 方法在 WebSocket 连接关闭时被调用，可以用于清理资源或记录日志等操作。
- **传输错误处理**：`handleTransportError(WebSocketSession session, Throwable exception)` 方法在 WebSocket 传输过程中发生错误时被调用，可以用于处理异常或记录错误日志等操作。

### 2. 消息收发
WebSocketHandler 可以用于发送和接收消息。通过实现 `handleMessage` 方法，可以处理从客户端接收到的消息，并通过 `WebSocketSession` 对象发送消息回客户端。例如，在一个聊天应用中，可以使用 WebSocketHandler 来接收用户发送的消息，并将消息广播给其他在线用户。

### 3. 会话管理
WebSocketHandler 可以管理 WebSocket 会话。通过 `WebSocketSession` 对象，可以获取会话的详细信息，如会话 ID、远程地址等，并可以发送消息给特定的客户端。例如，在一个实时聊天系统中，可以使用 WebSocketHandler 来管理用户的在线状态，并在用户上线或下线时通知其他用户。

### 4. 支持多种消息类型
WebSocketHandler 支持多种消息类型，包括文本消息、二进制消息等。通过实现 `handleMessage` 方法，可以根据消息类型进行不同的处理。例如，在一个文件传输应用中，可以使用 WebSocketHandler 来处理二进制消息，实现文件的上传和下载。

### 5. 与 Spring 框架集成
WebSocketHandler 与 Spring 框架紧密集成，可以方便地与其他 Spring 组件进行交互。例如，可以通过 Spring 的依赖注入机制获取其他服务或组件，并在 WebSocketHandler 中使用它们。此外，Spring 提供了多种扩展点和工具类，可以帮助开发者更方便地实现 WebSocket 功能。

### 示例代码
以下是一个简单的 WebSocketHandler 示例，用于处理文本消息并将其广播给所有连接的客户端：
```java
import org.springframework.web.socket.TextMessage;
import org.springframework.web.socket.WebSocketHandler;
import org.springframework.web.socket.WebSocketSession;

import java.io.IOException;
import java.util.Collections;
import java.util.HashSet;
import java.util.Set;

public class CustomWebSocketHandler implements WebSocketHandler {
    private final Set<WebSocketSession> sessions = Collections.synchronizedSet(new HashSet<>());

    @Override
    public void afterConnectionEstablished(WebSocketSession session) throws Exception {
        sessions.add(session);
        System.out.println("WebSocket连接建立: " + session.getId());
    }

    @Override
    public void handleMessage(WebSocketSession session, TextMessage message) throws Exception {
        String payload = message.getPayload();
        System.out.println("收到消息: " + payload);

        // 广播消息给所有连接的客户端
        for (WebSocketSession webSocketSession : sessions) {
            if (webSocketSession.isOpen()) {
                webSocketSession.sendMessage(new TextMessage("服务器收到消息: " + payload));
            }
        }
    }

    @Override
    public void handleTransportError(WebSocketSession session, Throwable exception) throws Exception {
        System.err.println("WebSocket传输错误: " + exception.getMessage());
        sessions.remove(session);
    }

    @Override
    public void afterConnectionClosed(WebSocketSession session, CloseStatus status) throws Exception {
        sessions.remove(session);
        System.out.println("WebSocket连接关闭: " + session.getId());
    }

    @Override
    public boolean supportsPartialMessages() {
        return false;
    }
}
```
在这个示例中，`CustomWebSocketHandler` 实现了 `WebSocketHandler` 接口，并在 `afterConnectionEstablished` 方法中将新建立的 WebSocket 会话添加到 `sessions` 集合中。在 `handleMessage` 方法中，接收到的消息被广播给所有连接的客户端。在 `handleTransportError` 和 `afterConnectionClosed` 方法中，处理了会话的移除和关闭操作。