serverendpoint

基础概念： ServerEndpoint 是 Java 中用于实现 WebSocket 服务器端点的注解。WebSocket 是一种网络通信协议，它允许服务器和客户端之间进行全双工通信，即双方可以同时发送和接收消息。ServerEndpoint 注解用于标记一个类，使其成为一个 WebSocket 服务器端点，处理来自客户端的连接请求和消息。

优势：

实时性：WebSocket 提供了低延迟的双向通信，非常适合需要实时交互的应用场景。
减少网络开销：相比传统的 HTTP 轮询，WebSocket 连接一旦建立，后续的消息传输不需要每次都重新建立连接，减少了网络开销。
简化编程模型：通过 ServerEndpoint 注解，开发者可以方便地实现 WebSocket 服务端逻辑，无需手动管理底层连接细节。

类型：

简单文本消息：传输纯文本数据。
二进制消息：支持二进制数据的传输。
Pong 消息：用于心跳检测，保持连接活跃。
关闭帧：用于正常关闭 WebSocket 连接。

应用场景：

在线聊天系统：实时消息传递。
实时数据更新：如股票行情、新闻推送等。
多人协作工具：如在线白板、协同编辑器等。
游戏服务器：实时对战游戏的通信需求。

常见问题及解决方法：

连接超时：
- 原因：可能是由于网络不稳定或服务器配置不当导致的。
- 解决方法：检查服务器的网络设置，确保防火墙允许 WebSocket 端口通信；调整 WebSocket 的心跳间隔和超时时间。

消息丢失：
- 原因：网络波动或服务器处理能力不足可能导致消息丢失。
- 解决方法：实现消息确认机制，确保每条消息都被成功接收；优化服务器性能，提高并发处理能力。
跨域问题：
- 原因：浏览器的同源策略限制了不同源之间的 WebSocket 连接。
- 解决方法：在服务器端设置适当的 CORS（跨源资源共享）策略，允许特定的源访问 WebSocket 服务。

示例代码：

import javax.websocket.*;
import javax.websocket.server.ServerEndpoint;
import java.io.IOException;

@ServerEndpoint("/websocket")
public class MyWebSocketServer {

    @OnOpen
    public void onOpen(Session session) {
        System.out.println("Client connected: " + session.getId());
    }

    @OnMessage
    public void onMessage(String message, Session session) {
        System.out.println("Received message: " + message);
        try {
            session.getBasicRemote().sendText("Echo: " + message);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    @OnClose
    public void onClose(Session session, CloseReason closeReason) {
        System.out.println("Connection closed: " + closeReason);
    }

    @OnError
    public void onError(Session session, Throwable throwable) {
        System.err.println("Error occurred: " + throwable.getMessage());
        throwable.printStackTrace();
    }
}

在这个示例中，我们定义了一个简单的 WebSocket 服务器端点，它可以接收客户端的连接请求、消息，并在连接关闭或发生错误时进行处理。