robaho httpserver

零依赖的 JDK com.sun.net.httpserver.HttpServer 规范替代实现，专为 JDK 25 + 虚拟线程 设计。

• HTTP/1.1：完整实现，支持 keep-alive、pipelining、chunked、trailer
• HTTP/2：RFC 9113 合规（h2c + ALPN），含 HPACK Huffman 编解码、流控、多路复用
• WebSocket：基于 nanohttpd 修改的 RFC 6455 实现
• 代理：ProxyHandler 支持 HTTP 转发与 CONNECT 隧道
• 虚拟线程原生：默认执行器即虚拟线程，全链路无 monitor 锁（ReentrantLock/CAS），ScopedValue（JDK 25）
• 零依赖：仅 200KB jar，无任何第三方库

• 比 JDK 内置实现快 10 倍以上（TechEmpower 基准，同硬件同 JDK）
• 比 Jetty http2 快 3 倍、http1 快 5 倍（h2load 基准）
• 单机回环实测：h1 ~31k RPS、h2 多路复用 ~28k RPS、单流上传 ~110MB/s（8 核 macOS，小响应）
• h2 路径垃圾分配比优化前减少 73%（GC 停顿 4 倍减少）

<dependency>
  <groupId>io.github.robaho</groupId>
  <artifactId>httpserver</artifactId>
  <version>使用徽章中的版本号（去掉前缀 v）</version>
</dependency>

要求 JDK 25+。

JDK 会自动使用 robaho.net.httpserver.DefaultHttpServerProvider 替代内置实现（jar 在 classpath/module path 上即可）。如有多个 provider，用系统属性指定：

-Dcom.sun.net.httpserver.HttpServerProvider=robaho.net.httpserver.DefaultHttpServerProvider

也可以直接实例化：DefaultHttpServerProvider.java

import java.io.IOException;
import java.io.OutputStream;
import java.net.InetSocketAddress;
import java.util.concurrent.Executors;

import com.sun.net.httpserver.HttpExchange;
import com.sun.net.httpserver.HttpHandler;
import com.sun.net.httpserver.HttpServer;

public class Test {
    static void main(String[] args) throws Exception {
        HttpServer server = HttpServer.create(new InetSocketAddress(8000), 0);
        server.createContext("/", new MyHandler());
        // 虚拟线程执行器（默认已是虚拟线程，可省略）
        server.setExecutor(Executors.newVirtualThreadPerTaskExecutor());
        server.start();
    }

    static class MyHandler implements HttpHandler {
        @Override
        public void handle(HttpExchange exchange) throws IOException {
            byte[] bytes = "This is the response".getBytes();
            var contentLength = bytes.length == 0 ? -1 : bytes.length;
            try (OutputStream os = exchange.getResponseBody()) {
                exchange.sendResponseHeaders(200, contentLength);
                os.write(bytes);
            }
        }
    }
}

用于基本测试（下载、echo、hello）：

mvn -q compile test-compile exec:java -Dexec.mainClass=com.example.SimpleFileServer -Dexec.classpathScope=test

继承 WebSocketHandler 并注册端点：

HttpHandler h = new EchoWebSocketHandler();
HttpContext c = server.createContext("/ws", h);

更多示例见 websocket 测试目录。底层 API 来自 nanohttpd。

使用 Java System Logger。

设置 robaho.net.httpserver.EnableStats=true 后，/__stats 端点返回实时统计：

$ curl http://localhost:8080/__stats
Active Connections: 2049
Requests Since: 2669256
Requests/sec: 73719
Total Handler Exceptions: 0
...

"Since" 统计在每次拉取时重置，"Total" 统计累计。

以下参数均通过 JVM 系统属性（-D）设置，在服务器启动时一次性读取。

HTTP/2 连接级发送窗口（服务端→客户端方向）初始为 65535 字节（协议默认），只能由客户端通过 WINDOW_UPDATE 增长，服务端无法代为扩大。大响应或多路复用下载场景下，客户端收满 64KB 后服务端写线程会等待窗口信用回流，吞吐受窗口往返次数限制（实测：默认窗口下 640KB 多路复用响应需约 10 次窗口往返）。

自研 h2 客户端若追求高吞吐，建议：

• 连接建立早期主动发送一次大的连接级 WINDOW_UPDATE（如 1~16MB），浏览器均如此
• 收到 DATA 后及时归还信用（收即还，而非攒到消息结束），避免服务端写线程等待
• 流级窗口同理，可通过 SETTINGS 帧通告更大的 INITIAL_WINDOW_SIZE

服务端侧对应的调优项为 http2InitialWindowSize（流级接收窗口，影响上传吞吐）与 http2ConnectionWindowSize（连接级接收窗口）。

• 几乎所有 JDK 原有测试均已包含（145 项 TestNG 套件全绿）
• 额外的代理、WebSocket、HTTP/2 合规测试
• HTTP/2 通过 h2spec 全部规范测试