FrameworkBenchmarks 中的 Jooby 基准测试:一套 Java 微框架如何跑满 TechEmpower 六类测试

原创2026-10-14 14:18:081,655 阅读
文章标签:性能测试测试质量保障后端示例工程Web框架

FrameworkBenchmarks 中的 Jooby 基准测试:一套 Java 微框架如何跑满 TechEmpower 六类测试

本文以 TechEmpower FrameworkBenchmarks 仓库中 Jooby 基准测试说明文档 为核心,完整梳理 Jooby 框架在该项目中覆盖的六类测试端点、基于 Maven Profile 的三种 HTTP 平台构建方式与运行方式,并结合仓库源码(App.java、pom.xml 等)解释各测试的实现细节,帮助读者理解一个 Java 微 Web 框架如何被完整纳入基准测试套件。

1. 文档定位:Jooby 在基准套件中的角色

Jooby 是一个面向 Java 与 Kotlin 的模块化微 Web 框架。仓库中的 README 给出的最小示例展示了其声明式风格——通过继承 Jooby 类,直接在实例初始化块里注册路由:

public class App extends Jooby {

  {
    get("/", ctx -> "Hello, World!");
  }

}

该目录是基准测试套件中 Jooby 的测试模块。README 将六个测试(Plain Text、JSON Encoding、Single Query、Multiple Queries、Database Update、Fortunes)全部指向同一个源文件 src/main/java/com/techempower/App.java,即六个端点集中在一个应用类中实现,而不是拆分成多个程序。

2. 六类测试端点(Test URLs)

README 中列出的测试 URL 全部基于 localhost:8080,与 benchmark_config.json 及 config.toml 中登记的 URL 完全一致:

测试类型 URL 对应源码位置
Plain Text Test http://localhost:8080/plaintext App.java
JSON Encoding Test http://localhost:8080/json App.java
Single Query Test http://localhost:8080/db App.java
Multiple Queries Test http://localhost:8080/queries App.java
Database Update Test http://localhost:8080/updates App.java
Fortunes Test http://localhost:8080/fortunes App.java

从源码结构看,各端点的实现要点如下:

  • Plain Text:"Hello, World!" 在类初始化时预先转成 UTF-8 字节数组并包装成可复用的 Output 对象(MESSAGE_BYTES),每个请求只做一次 ctx.send(message),避免重复编码;
  • JSON:通过 Json.encode(new Message(MESSAGE)) 编码,输出类型设置为 MediaType.JSON;
  • Single Query / Multiple Queries / Updates:使用 HikariModule 提供的 DataSource,手写 JDBC 的 PreparedStatement 执行 select * from world where id=?;其中 /queries 与 /updates 的查询次数由 queries 查询参数控制,解析逻辑在 Util.queries() 中——缺省为 1,并做 Math.min(500, Math.max(1, ...)) 的边界钳制,非法值回退为 1;
  • Updates:采用单条批量 UPDATE 语句,借助 Postgres 的 VALUES 子句一次更新多行:UPDATE world SET randomNumber = temp.randomNumber FROM (VALUES (?, ?), ...) ORDER BY 1) AS temp(id, randomNumber) WHERE temp.id = world.id;
  • Fortunes:查询 fortune 表全部行后追加一条固定记录 "Additional fortune added at request time.",排序后渲染 Rocker 模板 public/views/fortunes.rocker.html。

一个值得注意的结构细节:数据库相关的路由(/db、/queries、/updates、/fortunes)被包裹在 dispatch(() -> { ... }) 中。注释明确写着 /** Go blocking: */,即这些会阻塞的 JDBC 路由被放入独立的分发线程池,避免在事件循环线程上执行阻塞 IO;而 /plaintext 与 /json 则直接跑在事件循环上。应用入口 main 方法通过 runApp(args, EVENT_LOOP, App::new) 显式指定 EVENT_LOOP 执行模式(见 App.java 末尾)。

3. JSON 编码:编译期生成的 dsl-json 转换器

/json 等端点的序列化实现位于 Json.java。它基于 dsl-json 库,并通过 @CompiledJson 注解(见 World.java 与 Message.java)在编译期生成类型化的转换器,例如 _World_DslJsonConverter.ObjectFormatConverter。

源码中的两个细节体现了性能取向:

  1. JsonWriter 以 ThreadLocal 池化复用(初始容量 1024),每次编码前 reset() 后复用,减少对象分配;
  2. 编码结果直接以 outputFactory.wrap(writer.getByteBuffer(), 0, writer.size()) 包成 Jooby 的 Output,绕开中间 String 拷贝。

编译期转换器的生成依赖 pom.xml 中 maven-compiler-plugin 配置的注解处理器(jooby-apt 与 dsl-json),并且 build-helper-maven-plugin 会把生成的注解产物目录加入编译源路径(pom.xml)。

4. 构建:Maven Profile 切换 HTTP 平台

README 给出的三条构建命令,本质上是切换 pom.xml 中定义的 Maven Profile,每个 Profile 引入不同的 Jooby 平台适配依赖:

构建命令 Profile 引入的依赖
mvn clean package -P netty netty jooby-netty
mvn clean package -P undertow undertow jooby-undertow
mvn clean package -P jetty jetty jooby-jetty

除此之外,pom.xml 中还定义了一个 vertx Profile(引入 jooby-vertx),对应基准套件里非 README 主线的 pgclient 变体,见下一节。

构建产物的组织方式由 maven-shade-plugin 完成:打成 fat jar(finalName 为 jooby),并通过 ManifestResourceTransformer 把主类写入清单,主类来自属性 application.class,默认值即 com.techempower.App(pom.xml)。另外 Rocker 模板由 rocker-maven-plugin 在 generate-sources 阶段从 public 目录编译生成。

pom.xml 中还有一些环境相关配置:maven.compiler.source/target 为 25,基础依赖为 jooby-hikari、jooby-rocker、postgresql(42.7.7)、jooby-vertx-pg-client 与 dsl-json,统一版本由 jooby-bom(4.0.11)导入管理;针对 macOS 还有自动激活的 mac Profile,追加 netty-resolver-dns-native-macos(osx-aarch_64)。

5. 运行与数据库配置

README 给出的运行命令为:

java -jar target/jooby-2x.jar

而仓库中的 Dockerfile 实际运行的是 shade 插件产出的 target/jooby.jar(例如 jooby.dockerfile),并附带了一组 JVM 参数:

java -server -Xms2g -Xmx2g -XX:+UseNUMA -XX:+UseParallelGC -jar target/jooby.jar

各 Dockerfile 的构建与启动差异如下(均以 maven:3.9.11-eclipse-temurin-25-noble 为构建镜像,EXPOSE 8080):

  • jooby.dockerfile:mvn package -q -P undertow,普通 JVM 参数;
  • jooby-netty.dockerfile:mvn package -q -P netty,并追加 Netty 调优参数,如 -Dio.netty.disableHttpHeadersValidation=true、-Dio.netty.buffer.checkBounds=false、-Dio.netty.eventLoopGroup=single,以及 JDK 侧的 --enable-native-access=ALL-UNNAMED、--add-opens=java.base/java.lang=ALL-UNNAMED、--sun-misc-unsafe-memory-access=allow;
  • jooby-jetty.dockerfile:mvn package -q -P jetty,JVM 参数与普通版相同;
  • jooby-mvc.dockerfile:mvn package -q -P netty,但启动类换为 com.techempower.MvcApp(-cp target/jooby.jar);
  • jooby-pgclient.dockerfile:mvn package -q -P vertx,启动类为 com.techempower.ReactivePg 并传参 vertx,同时追加 -Dvertx.disableMetrics=true、-Dvertx.disableContextTimings=true、-Djava.lang.Integer.IntegerCache.high=10000 等参数。

数据库连接信息通过 Jooby 的配置系统加载,conf/application.conf 提供了 JDBC 数据源属性:

db.databaseName = hello_world
db.serverName = tfb-database
db.portNumber = 5432
db.user = benchmarkdbuser
db.password = benchmarkdbpass
db.dataSourceClassName = org.postgresql.ds.PGSimpleDataSource

其中 serverName 指向基准套件的数据库容器 tfb-database,dataSourceClassName 指定 Postgres 的 PGSimpleDataSource,由 HikariModule 据此创建连接池。HikariModule 的安装在 App.java 中,随后通过 require(DataSource.class) 取出数据源。

6. 多入口变体:MvcApp 与 ReactivePg

除了 README 主线对应的 App,目录内还有两个额外入口,它们在 benchmark_config.json 中分别登记为 mvc(display_name: jooby-jaxrs)与 pgclient(display_name: jooby-pgclient)变体:

  • MvcApp.java:演示 Jooby 的注解式 MVC 风格。入口不再是继承 Jooby 的类,而是用 runApp(args, EVENT_LOOP, app -> { ... }) 以编程式安装模块(HikariModule、RockerModule),再注册资源类 Resource_(由 jooby-apt 注解处理器从 Resource.java 生成)。Resource 用 @GET、@Path("/plaintext") 等注解声明路由,数据库路由标注 @Dispatch 同样放入阻塞线程池;
  • ReactivePg.java:把数据库访问换成 Vert.x 的响应式 PG 客户端(VertxPgConnectionModule),SQL 占位符也随之从 JDBC 的 ? 换成 $1 风格。它通过 prepare(statements()) 预准备三类语句:selectWorld、selectFortune,以及 1~500 长度的批量 updateWorld(UPDATE WORLD SET RANDOMNUMBER = CASE ID WHEN $1 THEN $2 ... ELSE RANDOMNUMBER END WHERE ID IN (...),见 buildAggregatedUpdateQuery())。/queries 场景则通过 sqlClient.group(client -> {...}) 在同一连接组内并发发起 N 条 prepared query(selectWorlds())。对应的 Vert.x 客户端连接参数在 conf/application.vertx.conf 中给出:
db.cachePreparedStatements = true
db.preparedStatementCacheMaxSize = 1024
db.pipeliningLimit = 256

7. 基准套件登记信息

benchmark_config.json(与 config.toml 内容对应)为每个变体登记了完整元数据,关键字段包括:

  • 端口统一为 8080;query_url / update_url 带 ?queries= 参数前缀,压测时在其后追加查询次数;
  • approach = "Realistic"、classification = "Fullstack"、orm = "Raw"、database = "Postgres"、webserver = "None"(框架自带 HTTP 层,不前置 nginx);
  • platform 字段按变体区分:default 为 Undertow、netty/mvc/pgclient 为 Netty、jetty 为 Jetty;versus 字段则对应到基准结果页上的平台对比组;
  • pgclient 变体只登记了 db_url/query_url/update_url/fortune_url,不跑 /plaintext 与 /json。

8. 小结

Jooby 模块展示了基准套件对一个 Java 微框架的典型收录方式:单一 App 入口集中实现六个标准测试端点;通过 Maven Profile 在同一份源码上切换 Undertow/Netty/Jetty 三种平台;再以注解式 MVC 入口和响应式 PG 客户端入口形成两个补充变体;JVM 与 Netty 参数按平台差异化配置。所有 URL、端口、构建与运行方式均可在 README、pom.xml、benchmark_config.json 与五个 Dockerfile 中交叉验证。

登录后查看全文
FrameworkBenchmarks