要实现 java 的 websocket 服务端,可使用原生 api 或 spring boot。1. 使用原生 api 需创建继承 endpoint 的类并重写 onopen、onmessage、onclose 方法,再配置 serverendpointconfig 启动服务;2. 使用 spring boot 则需添加 websocket 依赖,配置 websocketconfigurer 并注册自定义处理器;3. 实际开发中应注意跨域问题、连接保持、并发处理、消息格式及异常处理。两种方式均可搭建基础 websocket 服务端,应根据项目需求选择合适方案。

WebSocket 是一种基于 TCP 的通信协议,允许客户端和服务器之间进行全双工通信。在 Java 中实现 WebSocket 服务端,可以使用标准的 Java API(比如 JSR-356)或者 Spring 框架提供的封装支持。下面是一个简单实用的教程,帮助你快速搭建一个基于 Java 的 WebSocket 实时通信服务端。

1. 使用原生 Java WebSocket API 实现
Java EE 提供了 javax.websocket 包来支持 WebSocket 协议。这种方式适用于嵌入式服务器或简单的服务端开发。
步骤如下:
立即学习“Java免费学习笔记(深入)”;

- 创建一个继承自
Endpoint的类,重写onOpen、onMessage、onClose方法。 - 配置
ServerEndpointConfig并启动 WebSocket 服务器。
public class SimpleWebSocket extends Endpoint {
@Override
public void onOpen(Session session, EndpointConfig config) {
session.addMessageHandler(new MessageHandler.Whole() {
@Override
public void onMessage(String message) {
System.out.println("收到消息:" + message);
try {
session.getBasicRemote().sendText("服务器回复:" + message);
} catch (IOException e) {
e.printStackTrace();
}
}
});
}
} 然后通过 ServerContainer 启动服务:
ServerSocketChannel ssc = ServerSocketChannel.open();
ssc.bind(new InetSocketAddress(8080));
WsServerContainer container = new WsServerContainer();
container.start();
container.addEndpoint("/ws", SimpleWebSocket.class);注意:原生 API 较为底层,适合对 WebSocket 协议有较深理解的开发者。
2. 使用 Spring Boot 快速构建 WebSocket 服务端
如果你已经使用 Spring Boot 开发项目,那么集成 WebSocket 就非常方便了。
步骤如下:
- 添加依赖(Maven):
org.springframework.boot spring-boot-starter-websocket
- 配置 WebSocket 支持:
@Configuration
@EnableWebSocket
public class WebSocketConfig implements WebSocketConfigurer {
@Override
public void registerWebSocketHandlers(WebSocketHandlerRegistry registry) {
registry.addHandler(new MyWebSocketHandler(), "/ws")
.setAllowedOrigins("*");
}
}- 自定义处理器:
public class MyWebSocketHandler extends TextWebSocketHandler {
@Override
public void handleTextMessage(WebSocketSession session, TextMessage message) {
String payload = message.getPayload();
System.out.println("收到消息:" + payload);
try {
session.sendMessage(new TextMessage("服务器回应:" + payload));
} catch (IOException e) {
e.printStackTrace();
}
}
}这样就完成了一个基础的 WebSocket 服务端搭建。你可以通过浏览器或 WebSocket 客户端连接 /ws 路径进行测试。
3. 常见问题与注意事项
在实际开发中,可能会遇到一些常见问题,需要注意以下几点:
-
跨域问题:默认情况下浏览器会阻止跨域 WebSocket 请求,可以通过配置
setAllowedOrigins("*")来解决。 - 连接保持:WebSocket 是长连接,需要处理好心跳机制和断开重连逻辑。
- 并发处理:多个用户同时连接时,建议使用线程安全的结构保存会话信息。
- 消息格式:建议统一使用 JSON 格式传输数据,便于前后端解析。
- 异常处理:在发送消息或接收消息时可能发生异常,务必做好 try-catch 处理。
基本上就这些内容了。无论是使用原生 Java 还是结合 Spring Boot,都可以比较轻松地搭建一个 WebSocket 服务端。关键在于根据项目需求选择合适的方式,并注意连接管理与消息处理的细节。










