在libGDX的GWT编译客户端中正确使用WebSocket并开启TCP_NODELAY

你遇到的核心问题其实是Java-WebSocket库无法兼容GWT编译——GWT只能处理特定的Java API和专为GWT设计的库，而Java-WebSocket依赖的NIO套接字类在GWT的浏览器环境中没有对应的实现，所以编译时会报继承或类找不到的错误。同时，浏览器端的WebSocket API本身不允许直接设置TCP_NODELAY，这需要结合跨平台实现和服务器端配置来解决。

下面是一套完整的解决方案：

1. 采用跨平台WebSocket接口设计 #

为了兼顾桌面/Android（用Java-WebSocket）和GWT（用原生API），先在core模块定义一个通用的WebSocket接口，隔离平台差异：

package com.mygdx.game;

public interface GameWebSocket {
    void connect(String serverUri);
    void send(String message);
    void send(byte[] data);
    void close();
    void setListener(WebSocketListener listener);

    interface WebSocketListener {
        void onOpen();
        void onClose(int code, String reason, boolean remote);
        void onMessage(String message);
        void onMessage(byte[] data);
        void onError(Exception ex);
    }
}

2. 桌面/Android端用Java-WebSocket实现（支持TCP_NODELAY） #

在desktop和android模块中，基于Java-WebSocket实现这个接口，同时手动开启TCP_NODELAY：

package com.mygdx.game.desktop;

import com.mygdx.game.GameWebSocket;
import org.java_websocket.client.WebSocketClient;
import org.java_websocket.drafts.Draft_6455;
import org.java_websocket.handshake.ServerHandshake;

import java.net.URI;
import java.net.URISyntaxException;

public class DesktopAndroidWebSocket implements GameWebSocket {
    private WebSocketClient client;
    private WebSocketListener listener;

    @Override
    public void connect(String serverUri) {
        try {
            client = new WebSocketClient(new URI(serverUri), new Draft_6455()) {
                @Override
                public void onOpen(ServerHandshake handshakedata) {
                    // 关键：开启TCP_NODELAY
                    try {
                        client.getSocket().setTcpNoDelay(true);
                    } catch (Exception e) {
                        if (listener != null) listener.onError(e);
                    }
                    if (listener != null) listener.onOpen();
                }

                @Override
                public void onClose(int code, String reason, boolean remote) {
                    if (listener != null) listener.onClose(code, reason, remote);
                }

                @Override
                public void onMessage(String message) {
                    if (listener != null) listener.onMessage(message);
                }

                @Override
                public void onMessage(java.nio.ByteBuffer message) {
                    if (listener != null) {
                        byte[] data = new byte[message.remaining()];
                        message.get(data);
                        listener.onMessage(data);
                    }
                }

                @Override
                public void onError(Exception ex) {
                    if (listener != null) listener.onError(ex);
                }
            };
            client.connect();
        } catch (URISyntaxException e) {
            if (listener != null) listener.onError(e);
        }
    }

    @Override
    public void send(String message) {
        if (client != null && client.isOpen()) client.send(message);
    }

    @Override
    public void send(byte[] data) {
        if (client != null && client.isOpen()) client.send(data);
    }

    @Override
    public void close() {
        if (client != null) client.close();
    }

    @Override
    public void setListener(WebSocketListener listener) {
        this.listener = listener;
    }
}

3. GWT端用原生WebSocket API实现 #

在html模块中，使用GWT内置的WebSocket API实现接口（浏览器端无法直接设置TCP_NODELAY，但可以通过服务器端优化）：

package com.mygdx.game.client;

import com.google.gwt.web.client.WebSocket;
import com.mygdx.game.GameWebSocket;
import com.google.gwt.typedarrays.client.Uint8Array;

public class GwtGameWebSocket implements GameWebSocket {
    private WebSocket socket;
    private WebSocketListener listener;

    @Override
    public void connect(String serverUri) {
        socket = WebSocket.createIfSupported();
        if (socket == null) {
            if (listener != null) listener.onError(new Exception("浏览器不支持WebSocket"));
            return;
        }

        socket.setOnOpen(event -> {
            if (listener != null) listener.onOpen();
        });

        socket.setOnClose(event -> {
            if (listener != null) listener.onClose(event.getCode(), event.getReason(), event.isWasClean());
        });

        socket.setOnMessage(event -> {
            if (listener != null) listener.onMessage(event.getData());
        });

        socket.setOnError(event -> {
            if (listener != null) listener.onError(new Exception(event.getMessage()));
        });

        socket.open(serverUri);
    }

    @Override
    public void send(String message) {
        if (socket != null && socket.getReadyState() == WebSocket.OPEN) socket.send(message);
    }

    @Override
    public void send(byte[] data) {
        // GWT WebSocket支持ArrayBuffer，需将byte[]转换为TypedArray
        if (socket != null && socket.getReadyState() == WebSocket.OPEN) {
            Uint8Array uint8Array = Uint8Array.create(data.length);
            for (int i = 0; i < data.length; i++) {
                uint8Array.set(i, data[i] & 0xFF);
            }
            socket.send(uint8Array.buffer());
        }
    }

    @Override
    public void close() {
        if (socket != null) socket.close();
    }

    @Override
    public void setListener(WebSocketListener listener) {
        this.listener = listener;
    }
}

4. 配置GWT编译与依赖 #

• 移除GWT模块的Java-WebSocket依赖：在html模块的build.gradle中删除compile "org.java-websocket:Java-WebSocket:1.3.7"，避免GWT尝试编译不兼容的类。
• 更新GWT模块配置：在html模块的YourGame.gwt.xml中添加WebSocket支持，并排除Java-WebSocket的包：

<inherits name="com.google.gwt.web.WebSocket"/>
<exclude name="org.java_websocket.**"/>

5. 解决TCP_NODELAY的浏览器端限制 #

浏览器的WebSocket API没有暴露TCP_NODELAY的设置接口，但有两个关键点：

1. 服务器端强制开启：在你的Java服务器中，对每个接受的Socket设置setTcpNoDelay(true)，这样无论客户端如何，服务器端的TCP连接都会禁用Nagle算法，保证低延迟。
2. 浏览器默认优化：现代浏览器针对WebSocket这种低延迟场景，默认会关闭Nagle算法（等价于开启TCP_NODELAY），所以无需额外担心。

6. 在游戏中使用跨平台WebSocket #

在你的核心游戏类中，根据平台选择对应的实现：

import com.badlogic.gdx.Application;
import com.badlogic.gdx.Gdx;
import com.mygdx.game.GameWebSocket;
import com.mygdx.game.desktop.DesktopAndroidWebSocket;
import com.mygdx.game.client.GwtGameWebSocket;

public class MyGdxGame extends com.badlogic.gdx.Game {
    private GameWebSocket webSocket;

    @Override
    public void create() {
        // 根据平台初始化WebSocket
        if (Gdx.app.getType() == Application.ApplicationType.Desktop || 
            Gdx.app.getType() == Application.ApplicationType.Android) {
            webSocket = new DesktopAndroidWebSocket();
        } else if (Gdx.app.getType() == Application.ApplicationType.WebGL) {
            webSocket = new GwtGameWebSocket();
        } else {
            webSocket = null;
        }

        if (webSocket != null) {
            webSocket.setListener(new GameWebSocket.WebSocketListener() {
                @Override
                public void onOpen() {
                    Gdx.app.log("WebSocket", "连接成功");
                    webSocket.send("Hello, it is me. Mario :)");
                }

                @Override
                public void onClose(int code, String reason, boolean remote) {
                    Gdx.app.log("WebSocket", "连接关闭: " + code + " - " + reason);
                }

                @Override
                public void onMessage(String message) {
                    Gdx.app.log("WebSocket", "收到消息: " + message);
                }

                @Override
                public void onMessage(byte[] data) {
                    Gdx.app.log("WebSocket", "收到二进制消息");
                }

                @Override
                public void onError(Exception ex) {
                    Gdx.app.error("WebSocket", "错误发生", ex);
                }
            });
            webSocket.connect("ws://你的服务器地址:端口");
        }
    }

    @Override
    public void dispose() {
        if (webSocket != null) webSocket.close();
    }
}

这样修改后，你的项目就能在桌面、Android和HTML5平台正常运行WebSocket通信，同时在桌面/Android端开启TCP_NODELAY，GWT端依赖浏览器和服务器的优化保证低延迟。

内容的提问来源于stack exchange，提问作者War-sloop