首页 > 文章 > java教程

Java实现WebSocket实时通信方法

时间：2025-07-22 21:29:40 414浏览收藏

偷偷努力，悄无声息地变强，然后惊艳所有人！哈哈，小伙伴们又来学习啦~今天我将给大家介绍《Java连接WebSocket服务器实现实时通信》，这篇文章主要会讲到等等知识点，不知道大家对其都有多少了解，下面我们就一起来看一吧！当然，非常希望大家能多多评论，给出合理的建议，我们一起学习，一起进步！

要使用Java连接WebSocket服务器，需选择合适的库并编写代码建立连接、收发消息及处理状态。1. 选择Tyrus库并在pom.xml或build.gradle中添加依赖；2. 创建客户端类，使用@ClientEndpoint注解并实现@OnMessage方法接收消息；3. 使用WebSocketContainer连接服务器并通过session发送消息；4. 运行main方法确保服务器运行且地址正确；5. 排查连接失败时检查服务器状态、防火墙、协议版本、代理设置和服务器日志；6. 处理断开连接时通过@OnClose方法监听关闭事件并实现重连逻辑，建议使用线程或定时任务避免栈溢出；7. 收发二进制数据时可使用ByteBuffer或InputStream，分别通过@OnMessage和sendBinary方法处理。

如何使用Java连接WebSocket服务器 Java实现实时通信功能

要用Java连接WebSocket服务器，核心在于使用合适的WebSocket客户端库，并编写相应的代码来建立连接、发送和接收消息，以及处理连接状态。

解决方案

首先，你需要选择一个Java WebSocket客户端库。比较流行的选择包括：

Tyrus: Oracle官方的JSR 356 (Java API for WebSocket) 的参考实现。
Jetty WebSocket Client: Jetty服务器自带的WebSocket客户端，性能优秀。
OkHttp: Square公司开发的HTTP客户端，也支持WebSocket。

这里以Tyrus为例，演示如何连接WebSocket服务器。

添加依赖: 在你的pom.xml (如果使用Maven) 或 build.gradle (如果使用Gradle) 文件中添加Tyrus的依赖。



    org.glassfish.tyrus.bundles
    tyrus-standalone-client
    1.17



implementation 'org.glassfish.tyrus.bundles:tyrus-standalone-client:1.17'

编写客户端代码: 创建一个Java类，实现WebSocket客户端的功能。

import java.net.URI;
import javax.websocket.ClientEndpoint;
import javax.websocket.ContainerProvider;
import javax.websocket.OnMessage;
import javax.websocket.Session;
import javax.websocket.WebSocketContainer;

@ClientEndpoint
public class WebSocketClient {

    Session session = null;

    public WebSocketClient(URI endpointURI) {
        try {
            WebSocketContainer container = ContainerProvider.getWebSocketContainer();
            container.connectToServer(this, endpointURI);
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }

    @OnMessage
    public void onMessage(String message) {
        System.out.println("Received message: " + message);
    }

    public void sendMessage(String message) {
        try {
            session.getBasicRemote().sendText(message);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public static void main(String[] args) {
        try {
            WebSocketClient client = new WebSocketClient(new URI("ws://localhost:8080/your-websocket-endpoint")); // 替换为你的WebSocket服务器地址
            client.sendMessage("Hello, Server!");

            Thread.sleep(5000); // 保持连接5秒
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            try {
                if (client.session != null) {
                    client.session.close();
                }
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

代码解释:

@ClientEndpoint: 标记这个类是一个WebSocket客户端。
@OnMessage: 当收到消息时，这个方法会被调用。
WebSocketContainer: 用于创建和管理WebSocket连接。
session.getBasicRemote().sendText(message): 发送文本消息。

运行客户端: 运行WebSocketClient的main方法。确保你的WebSocket服务器正在运行，并且地址与代码中的ws://localhost:8080/your-websocket-endpoint匹配。

WebSocket连接失败的常见原因及排查方法

服务器未启动或地址错误: 这是最常见的问题。确保你的WebSocket服务器已经启动，并且客户端代码中的URL指向正确的地址和端口。可以使用telnet或curl命令测试服务器端口是否开放。
防火墙阻止连接: 检查你的防火墙设置，确保允许客户端连接到WebSocket服务器的端口。
WebSocket协议不匹配: 确保客户端和服务器都使用相同的WebSocket协议版本（例如，RFC 6455）。
代理服务器问题: 如果你的网络环境使用了代理服务器，需要配置WebSocket客户端使用代理。Tyrus允许你通过设置ClientProperties来配置代理。
服务器端错误: 查看服务器端的日志，是否有任何错误信息。服务器端可能因为各种原因拒绝连接，例如客户端IP地址不在白名单中。

如何处理WebSocket连接断开和自动重连

WebSocket连接断开是不可避免的。为了提高应用的健壮性，你需要处理连接断开的情况，并尝试自动重连。

监听连接关闭事件: 在@ClientEndpoint类中添加@OnClose注解的方法，当连接关闭时，这个方法会被调用。

import javax.websocket.OnClose;

@OnClose
public void onClose() {
    System.out.println("Connection closed.");
    // 在这里实现重连逻辑
}

实现重连逻辑: 在onClose方法中，你可以尝试重新建立连接。为了避免无限循环，可以设置最大重试次数和重试间隔。

import java.util.concurrent.TimeUnit;

private int retryCount = 0;
private final int maxRetries = 5;
private final long retryInterval = 5; // seconds

@OnClose
public void onClose() {
    System.out.println("Connection closed. Attempting to reconnect...");
    if (retryCount < maxRetries) {
        retryCount++;
        try {
            TimeUnit.SECONDS.sleep(retryInterval);
            session = ContainerProvider.getWebSocketContainer().connectToServer(this, endpointURI);
            System.out.println("Reconnected successfully.");
            retryCount = 0; // 重置重试计数器
        } catch (Exception e) {
            System.err.println("Failed to reconnect: " + e.getMessage());
            onClose(); // 递归调用，继续尝试重连
        }
    } else {
        System.err.println("Max retries reached. Giving up.");
    }
}

注意: 递归调用onClose方法可能会导致栈溢出。更好的做法是使用一个单独的线程或定时任务来执行重连逻辑。

处理服务器主动关闭连接的情况: 服务器可能会因为各种原因主动关闭连接。客户端应该能够正确处理这种情况，并尝试重新连接。服务器通常会发送一个关闭帧，其中包含关闭代码和原因。你可以在@OnClose方法中获取这些信息。
```
import javax.websocket.CloseReason;

@OnClose
public void onClose(CloseReason closeReason) {
    System.out.println("Connection closed. Reason: " + closeReason.getReasonCode() + " - " + closeReason.getReasonPhrase());
    // ... 重连逻辑
}
```

如何在Java WebSocket客户端中处理二进制数据

WebSocket不仅可以传输文本数据，还可以传输二进制数据。如果你需要处理图像、音频、视频等二进制数据，可以使用ByteBuffer或InputStream来接收和发送数据。

接收二进制数据: 使用@OnMessage注解的方法，并指定参数类型为ByteBuffer或InputStream。

import java.nio.ByteBuffer;
import javax.websocket.OnMessage;

@OnMessage
public void onMessage(ByteBuffer message) {
    System.out.println("Received binary message: " + message.remaining() + " bytes");
    // 处理二进制数据
}

或者：

import java.io.InputStream;
import javax.websocket.OnMessage;

@OnMessage
public void onMessage(InputStream message) {
    try {
        // 读取InputStream
        byte[] buffer = new byte[1024];
        int bytesRead;
        while ((bytesRead = message.read(buffer)) != -1) {
            // 处理读取到的数据
        }
    } catch (Exception e) {
        e.printStackTrace();
    }
}

发送二进制数据: 使用session.getBasicRemote().sendBinary(ByteBuffer data)或session.getBasicRemote().sendBinary(InputStream data)方法发送二进制数据。

import java.nio.ByteBuffer;

public void sendBinaryMessage(byte[] data) {
    ByteBuffer buffer = ByteBuffer.wrap(data);
    try {
        session.getBasicRemote().sendBinary(buffer);
    } catch (Exception e) {
        e.printStackTrace();
    }
}

或者：

import java.io.ByteArrayInputStream;

public void sendBinaryMessage(byte[] data) {
    try (ByteArrayInputStream inputStream = new ByteArrayInputStream(data)) {
        session.getBasicRemote().sendBinary(inputStream);
    } catch (Exception e) {
        e.printStackTrace();
    }
}

注意: 在使用InputStream发送二进制数据时，确保在使用完毕后关闭InputStream，以释放资源。

通过以上步骤，你就可以在Java中使用WebSocket客户端连接WebSocket服务器，实现实时通信功能。记住，异常处理和错误日志记录对于构建健壮的WebSocket应用至关重要。

今天关于《Java实现WebSocket实时通信方法》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！

java 实时通信 websocket 连接 Tyrus