FrameworkBenchmarks 中的 Jooby 基准测试:一套 Java 微框架如何跑满 TechEmpower 六类测试
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。
源码中的两个细节体现了性能取向:
JsonWriter以ThreadLocal池化复用(初始容量 1024),每次编码前reset()后复用,减少对象分配;- 编码结果直接以
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 中交叉验证。