Tio-Boot HTTP Speed Test

1、功能概述

SpeedTestHandler 是基于 Tio-Boot HTTP 框架的一个测速接口，能根据客户端传入的 size 参数（单位 MB）动态生成指定大小的二进制 payload 并返回，用于测试网络带宽及客户端接收性能。

---

2、Handler 实现示例

package com.litongjava.linux.handler;

import com.litongjava.tio.boot.http.TioRequestContext;
import com.litongjava.tio.http.common.HttpRequest;
import com.litongjava.tio.http.common.HttpResponse;

public class SpeedTestHandler {

  /**
   * 测速接口：GET /speed/test?size={size in MB}
   */
  public HttpResponse output(HttpRequest request) {
    HttpResponse httpResponse = TioRequestContext.getResponse();
    // 读取 size 参数（单位 MB）
    Long sizeMb = request.getLong("size");
    if (sizeMb == null || sizeMb < 0) {
      sizeMb = 500L;
    }

    // 计算字节数
    long totalBytes = sizeMb * 1024L * 1024L;

    // 生成指定大小的零字节数组
    byte[] payload = new byte[(int) totalBytes];

    // 构造响应
    httpResponse.disableGzip(true);
    return httpResponse.ok(payload);
  }
}

说明

• disableGzip(true)：示例中调用关闭框架的 gzip 压缩逻辑，以避免压缩影响带宽测试。
• 流式写出可防止一次性为数百 MB/GB 申请大块堆内存或引发 OOM。

---

4、接口说明

属性	值
请求方式	GET
请求 URL	http://{host}:{port}/speed/test
查询参数	size：要生成的响应大小，单位 MB；缺省或非法时默认为 500
响应内容	指定大小的二进制零数据流

---

4、测试方法

1. 用 curl 测速并输出总耗时

   curl -o /dev/null \
        -s \
        -w 'total_time: %{time_total}s\n' \
        "http://localhost/speed/test?size=100"
   

   • -o /dev/null：丢弃响应体
   • -s：静默模式，不显示进度
   • -w 'total_time: %{time_total}s\n'：打印总耗时

2. 使用 shell 的 time 命令

   time curl -o /dev/null "http://localhost/speed/test?size=100"
   

   这样还能同时看到 real / user / sys 等信息。

3. 确认无 gzip

   curl -I "http://localhost/speed/test?size=100"
   

   应该看到响应头中不含 Content-Encoding: gzip，且 Content-Length 接近 104857600（100×1024²）。

---

5、常见问题

• 为什么收到的数据远小于预期？ 可能因为框架自动启用了 gzip 压缩。请确认已在代码或全局配置中禁用压缩。
• 大体量响应会导致 OOM？ 推荐使用流式分块写出，而非一次性 new byte[size]。

---

至此，你可根据实际部署环境（host、port、Tio-Boot 版本等）将示例代码和测试命令替换或调整，即可完成大规模带宽测试。祝测试顺利！