当前位置：首页 > news >正文

JMH 详细使用

news 来源：原创 2025/9/13 11:39:41

JMH 基本使用

官方地址

JMH 是一个用于 Java 代码微基准测试的工具，允许开发者对特定部分进行精确的性能测试；

安装 JMH

环境：

Maven 项目；
JDK 8；

Maven 方式安装

引入如下依赖：

<dependencies><!-- JMH 核心库 包含执行基准测试所需的基本功能 --><dependency><groupId>org.openjdk.jmh</groupId><artifactId>jmh-core</artifactId><version>1.35</version></dependency><!-- JMH 的注解处理器 用于编译时处理 JMH 的注解 --><dependency><groupId>org.openjdk.jmh</groupId><artifactId>jmh-generator-annprocess</artifactId><version>1.35</version></dependency>
</dependencies>

注解介绍

@Warmup

预热，可用在类级别和方法级别

iterations：表示预热的次数；默认为5；
time：表示每次预热的时间；默认为10
timeUnit：表示每次预热的时间的单位，默认为TimeUnit.SECONDS；

@Measurement

具体的测试配置，可用在类级别和方法级别

iterations：表示测试的次数；默认为5；
time：表示每次测试的时间；默认为10
timeUnit：表示每次测试的时间的单位，默认为TimeUnit.SECONDS；

@Benchmark

测试方法，只可用在方法上，表示该方法是需要测试的方法；

@BenchmarkMode

表示测试采用的模式; 可用在类和方法上;

一共有四种Mode, 分别是:

Mode.Throughput: 吞吐量测试, 即指定时间单位该方法会执行多少次;
Mode.AverageTime: 平均耗时测试, 即输出每次操作平均耗时
Mode.SampleTime: 抽样测试, 会在执行过程中采样, 输出最快的, 50% 快, 90%, 95%, 99%, 99.9%, 99.99%, 100%
Mode.SingleShotTime: 冷启动测试, 设置后, 该方法一轮只会运行一次; 该模式主要为了测试冷启动的性能;

也可以使用 Mode.All 对以上四种模式都进行测试; 或者通过 @BenchmarkMode({Mode.SampleTime, Mode.SingleShotTime}) 方式选择需要进行测试的多种模式;

@OutputTimeUnit

表示输出测试报告的时间单位, 可用在类和方法上;

@State

类注解, 表示类对象的作用域; 一般标记在静态内部类里;

作用域主要有三种取值:

Scope.Thread: 表示类对象会在 Benchmark 各个线程执行之前初始化, 作为入参, 且各个线程的实参是相互独立的; 且参数类型为当前 @State 注解的类名;
Scope.Benchmark: 表示 Benchmark 的各个线程共用一个入参;
Scope.Group: 表示一个线程组共用一个对象

示例如下:

@State(Scope.Benchmark)
public static class BenchmarkState {int x;
}
@State(Scope.Thread)
public static class ThreadState {int x;
}
@Benchmark
public void measureUnshared(ThreadState state) {state.x++;
}
@Benchmark
public void measureShared(BenchmarkState state) {state.x++;
}

也可以对最外部的类进行注解; 此时这个类中的测试方法可以直接操作成员变量, 不用特意去将静态内部类执行注入的操作, 示例如下所示;

@State(Scope.Thread)
public class Sample_04_DefaultState {int x;@Benchmarkpublic void measure() {     // 不用通过注入的方式来操作成员变量 xx++;}
}

@Setup

方法级别注解, 表示在启动测试方法前做的准备工作; 必须在 @State 的类中才能使用; 实际上就是 @State 管理的对象的生命周期的一部分;

可以选择操作的执行方式,有以下三种情况:

Level.Iteration: 表示测试方法的每一轮测试开始前, 执行指定操作;
Level.Trial: 表示测试方法每轮测试都执行结束后, 才会执行一次该操作, 即该方法所有测试执行之前, 才只执行一次;
Level.Invocation: 一轮可能会调用测试方法多次, 该值表示测试方法每一次调用结束后都会执行指定操作;

@TearDown

方法级别注解, 表示在测试方法执行结束之后做的操作; 同样必须在 @State 的类中才能使用;

可以选择操作的执行方式,有以下三种情况:

Level.Iteration: 表示测试方法的每一轮测试结束后, 执行制定操作;
Level.Trial: 表示测试方法每轮测试都执行结束后, 才会执行一次该操作, 即该方法所有测试执行之后, 才执行一次;
Level.Invocation: 一轮可能会调用测试方法多次, 该值表示测试方法每一次调用结束后都会执行指定操作;

@OperationsPerInvocation

类、方法级别注解,可以指定数值, 假设为n, 则用于告诉 JMH 标记的方法执行了一次相当于执行了 n 次, 最后统计结果时会除n取平均值;

@Fork

可用在方法级别和类级别上; 默认不指定value时, 相当于 5;

value取0时, 测试默认只执行一次, 且测试方法会在 main 启动进程中执行;
value取1时, 会fork出一个线程来专门执行测试方法; 与 main 方法不在同一个进程中执行;
value取n时, 会fork出 n 个线程来执行测试方法;

可以通过使用 @Fork 注解对测试方法多进行几轮测试, 提高测试结果的精确性;

@Group

方法级别注解;

指定方法所属的测试组; 相同测试组的方法会在一个 Benchmark 中执行; 可以模拟生产环境的资源竞争;

@GroupThreads

方法级别注解;

指定在测试组中, 创建多少个线程执行该测试方法;

内置类

Blackhole

JMH 提供的黑洞对象, 可以对执行结果进行消费, 调用其 consume() 方法可对执行结果进行消费;

构造器

是指如何启动测试并进行配置构造的; 示例如下所示:

public static void main(String[] args) throws RunnerException {Options opt = new OptionsBuilder().include(Sample_03_States.class.getSimpleName()).threads(4).forks(1).build();new Runner(opt).run();
}

include

表示包含的测试类;

threads

在执行每一个测试方法时, 即执行每一个 Benchmark 时,会创造多少个线程去执行;

warmupIterations

表示预热的次数;

measurementTime

表示执行测试的时间;

measurementIterations

表示执行测试的次数;

resultFormat

指定输出结果文件的格式, 可以指定为 JSON 文件

result

指定结果的输出位置; 示例如下所示:


result("/E:/data/result.json")

测试结果详解

简单运行如下示例：

public class Sample_01_HelloWorld {@Benchmark  // 需要测试的方法public void wellHelloThere() {// this method was intentionally left blank.}public static void main(String[] args) throws RunnerException {Options opt = new OptionsBuilder().include(Sample_01_HelloWorld.class.getSimpleName())// 总共测试几轮.forks(1).build();new Runner(opt).run();}}

执行内容如下所示：

# JMH version: 1.35
# VM version: JDK 1.8.0_411, Java HotSpot(TM) 64-Bit Server VM, 25.411-b09
# VM invoker: D:\software\Java\jdk-1.8\jre\bin\java.exe
# VM options: -javaagent:D:\App\JetBrains\IntelliJ IDEA 2024.1.1\lib\idea_rt.jar=52629:D:\App\JetBrains\IntelliJ IDEA 2024.1.1\bin -Dfile.encoding=UTF-8
# Blackhole mode: full + dont-inline hint (auto-detected, use -Djmh.blackhole.autoDetect=false to disable)
# Warmup: 5 iterations, 10 s each
# Measurement: 5 iterations, 10 s each
# Timeout: 10 min per iteration
# Threads: 1 thread, will synchronize iterations
# Benchmark mode: Throughput, ops/time
# Benchmark: top.ytazwc.Sample_01_HelloWorld.wellHelloThere# Run progress: 0.00% complete, ETA 00:01:42
# Fork: 1 of 1
# Warmup Iteration   1: 3973752961.056 ops/s
# Warmup Iteration   2: 4022547742.955 ops/s
# Warmup Iteration   3: 4047713548.605 ops/s
# Warmup Iteration   4: 4099985036.125 ops/s
# Warmup Iteration   5: 4162155433.451 ops/s
Iteration   1: 4177536042.557 ops/s
Iteration   2: 4138225116.905 ops/s
Iteration   3: 4119016558.348 ops/s
Iteration   4: 3734934421.257 ops/s
Iteration   5: 3804276755.428 ops/sResult "top.ytazwc.Sample_01_HelloWorld.wellHelloThere":3994797778.899 ±(99.9%) 801318456.801 ops/s [Average](min, avg, max) = (3734934421.257, 3994797778.899, 4177536042.557), stdev = 208099858.535CI (99.9%): [3193479322.098, 4796116235.700] (assumes normal distribution)# Run complete. Total time: 00:01:43REMEMBER: The numbers below are just data. To gain reusable insights, you need to follow up on
why the numbers are the way they are. Use profilers (see -prof, -lprof), design factorial
experiments, perform baseline and negative tests that provide experimental control, make sure
the benchmarking environment is safe on JVM/OS/HW level, ask for reviews from the domain experts.
Do not assume the numbers tell you what you want them to tell.Benchmark                                      Mode  Cnt           Score           Error  Units
Sample_01_HelloWorld.wellHelloThere           thrpt    5  3994797778.899 ± 801318456.801  ops/s

首先是第一部分，介绍一些基本信息如下所示：

# JMH version: 1.35
# VM version: JDK 1.8.0_411, Java HotSpot(TM) 64-Bit Server VM, 25.411-b09
# VM invoker: D:\software\Java\jdk-1.8\jre\bin\java.exe
# VM options: -javaagent:D:\App\JetBrains\IntelliJ IDEA 2024.1.1\lib\idea_rt.jar=52629:D:\App\JetBrains\IntelliJ IDEA 2024.1.1\bin -Dfile.encoding=UTF-8
# Blackhole mode: full + dont-inline hint (auto-detected, use -Djmh.blackhole.autoDetect=false to disable)
# Warmup: 5 iterations, 10 s each
# Measurement: 5 iterations, 10 s each
# Timeout: 10 min per iteration
# Threads: 1 thread, will synchronize iterations
# Benchmark mode: Throughput, ops/time
# Benchmark: top.ytazwc.Sample_01_HelloWorld.wellHelloThere

主要是介绍一些基本信息，比如 JMH 的版本，虚拟机的参数等；一般可仔细观察的参数如下：

Benchmark mode测试模式规则：采用吞吐量的测试方式，单位是 ops/time，每个时间单位的请求数；
Benchmark：测试的方法；
Warmup：预热的次数和每次预热的时间；
Measurement：测试次数及每次的时间；
Threads：线程执行相关

第二部分则是执行测试相关的结果：

# Run progress: 0.00% complete, ETA 00:01:42
# Fork: 1 of 1
# Warmup Iteration   1: 3973752961.056 ops/s
# Warmup Iteration   2: 4022547742.955 ops/s
# Warmup Iteration   3: 4047713548.605 ops/s
# Warmup Iteration   4: 4099985036.125 ops/s
# Warmup Iteration   5: 4162155433.451 ops/s
Iteration   1: 4177536042.557 ops/s
Iteration   2: 4138225116.905 ops/s
Iteration   3: 4119016558.348 ops/s
Iteration   4: 3734934421.257 ops/s
Iteration   5: 3804276755.428 ops/sResult "top.ytazwc.Sample_01_HelloWorld.wellHelloThere":3994797778.899 ±(99.9%) 801318456.801 ops/s [Average](min, avg, max) = (3734934421.257, 3994797778.899, 4177536042.557), stdev = 208099858.535CI (99.9%): [3193479322.098, 4796116235.700] (assumes normal distribution)

根据提供的信息，可以很清楚的看到每一轮预热的结果和每次具体测试的结果；Result部分的信息则是 "" 中的具体方法的一个总的测试结果；

平均值及误差：3994797778.899 ±(99.9%) 801318456.801 ops/s [Average]；
最大值，平均值，最大值：(min, avg, max) = (3734934421.257, 3994797778.899, 4177536042.557)；
方差：stdev = 208099858.535；
置信区间：CI (99.9%): [3193479322.098, 4796116235.700] (assumes normal distribution)

第三部分则是对整体的一个测试做一个汇总：

# Run complete. Total time: 00:01:43REMEMBER: The numbers below are just data. To gain reusable insights, you need to follow up on
why the numbers are the way they are. Use profilers (see -prof, -lprof), design factorial
experiments, perform baseline and negative tests that provide experimental control, make sure
the benchmarking environment is safe on JVM/OS/HW level, ask for reviews from the domain experts.
Do not assume the numbers tell you what you want them to tell.Benchmark                                      Mode  Cnt           Score           Error  Units
Sample_01_HelloWorld.wellHelloThere           thrpt    5  3994797778.899 ± 801318456.801  ops/s

在最后是一个类表格的形式，描述测试的方法(Benchmark)，采用的测试模式(Mode)，测试次数(Cnt)，测试的平均结果(Score)，结果误差(Error)，测试结果的单位(Units)等；

测试结果可视化

可以将测试结果输出为一个文件, 并将其上传到在线可视化网址中, 可以将结果输出为可视化图表;

JMH 详细使用

JMH 基本使用官方地址 JMH 是一个用于 Java 代码微基准测试的工具，允许开发者对特定部分进行精确的性能测试； 安装 JMH 环境： Maven 项目；JDK 8； Maven 方式安装引入如下依赖： <dependencies>…...

编程日记 2025/9/13 11:39:41

2025 PHP授权系统网站源码

2025 PHP授权系统网站源码安装教程： PHP7.0以上先上传源码到服务器，然后再配置伪静态， 访问域名根据操作完成安装， 然后配置伪静态规则。 Ngix伪静态规则： location / { if (!-e $request_filename) { rewrite …...

编程日记 2025/9/13 18:31:15

【对话推荐系统】Towards Topic-Guided Conversational Recommender System 论文阅读

Towards Topic-Guided Conversational Recommender System 论文阅读 Abstract1 Introduction2 Related Work2.1 Conversation System2.2 Conversational Recommender System2.3 Dataset for Conversational Recommendation 3 Dataset Construction3.1 Collecting Movies for Re…...

编程日记 2025/9/14 6:24:03

git 使用常见错误整理

1. git am 应用补丁时遇到错误 fatal: previous rebase directory .git/rebase-apply still exists but mbox given fatal:之前的变基目录 .git/rebase-apply仍然存在，但却提供了mbox 答：这通常是因为之前的 git am 或 git rebase 操作失败后&#xf…...

编程日记 2025/9/14 6:23:08

数据存储：一文掌握存储数据到mysql的详细使用

文章目录一、环境准备1.1 安装MySQL数据库1.2 安装Python MySQL驱动二、连接到MySQL数据库三、执行基本的CRUD操作3.1 创建（Create）：插入数据3.2 读取（Read）：查询数据3.3 更新（Update&#xf…...

编程日记 2025/9/14 6:24:06

React 源码揭秘 | 更新队列

前面几篇遇到updateQueue的时候，我们把它先简单的当成了一个队列处理，这篇我们来详细讨论一下这个更新队列。有关updateQueue中的部分，可以见源码 UpdateQueue实现 Update对象我们先来看一下UpdateQueue中的内容，Update对象&…...

编程日记 2025/9/14 6:26:32

Vue3 + Vite + TS,使用配置项目别名属性：resolve

使用 resolve 配置全局项目路径别名 1.优化了开发中单页面引用其他模块的路径复杂性 2.妥妥解决了，组件复用当中提高开发效率 // 不使用配置 import { useStore } from ../../../stores // 使用配置可根据开发者需求任意定义，较多 import { useStore…...

编程日记 2025/9/14 6:26:32

使用 C# 以api的形式调用 DeepSeek

一：创建 API 密钥首先，您需要来自 DeepSeek 的 API 密钥。访问 DeepSeek，创建一个帐户，并生成一个新的 API 密钥。二：安装所需的 NuGet 包使用 NuGet 包管理器安装包，或在包管理器控制台中运行以下命…...

编程日记 2025/9/11 17:56:50

手机放兜里，支付宝“碰一下”被盗刷？

大家好，我是小悟。近期，网络上关于“支付宝‘碰一下’支付易被盗刷”的传言甚嚣尘上，不少用户对此心生疑虑。首先，要明确一点：“碰一下”支付并不会像某些传言中所描述的那样容易被隔空盗刷。这一观点已经得到了支付…...

编程日记 2025/9/14 6:19:26

0x01 html和css

css 对于三种css使用方式： 第一种：行内样式 <span style"color: grey;">2024年05月15日 20:07</span>第二种：内部样式 <!DOCTYPE html> <html lang"en"> <head>...<style>span{…...

编程日记 2025/9/14 6:21:53

模型和数据集的平台之在Hugging Face上进行模型下载、上传以及创建专属Space

模型下载步骤： 注册Hugging Face平台 https://huggingface.co/ 新建一个hf_download_josn.py 文件 touch hf_download_josn.py 编写hf_download_josn.py文件 import os from huggingface_hub import hf_hub_download# 指定模型标识符 repo_id "inter…...

编程日记 2025/9/14 6:26:09

轮式机器人在复杂地形中如何选择合适的全局路径规划算法？

已思考完成收起嗯，用户问的是轮式机器人在复杂地形中如何选择合适的全局路径规划算法。首先，我需要理解复杂地形可能带来的挑战，比如崎岖的路面、动态障碍物、非结构化环境等等。轮式机器人在这里的运动控制需要考虑地形通过性、稳定性&…...

编程日记 2025/9/14 6:27:08

免费使用 DeepSeek API 教程及资源汇总

免费使用 DeepSeek API 教程及资源汇总一、DeepSeek API 资源汇总1.1 火山引擎1.2 百度千帆1.3 阿里百炼1.4 腾讯云二、其他平台2.1 华为云2.2 硅基流动三、总结 DeepSeek-R1 作为 2025 年初发布的推理大模型，凭借其卓越的逻辑推理能力和成本优势，迅速…...

编程日记 2025/9/14 6:28:23

文献汇总｜AI生成图像检测相关数据集汇总

前言：本博客汇总当前AI生成图像检测领域用到的数据集及相关链接。 ⚠️：除标注「未公开」数据集，其余数据集均已开源。目录 2020202220232024 2020 CNNSpot https://github.com/peterwang512/CNNDetection Testset: The zip file contains …...

编程日记 2025/9/13 23:17:31

C# 弃元的使用

总目录前言在C# 7.0及更高版本中，弃元（Discard）是一个新的语言特性，允许开发者在特定情况下忽略某些值。弃元用下划线 _ 作为占位符，明确表示忽略某个值，提升代码可读性一、弃元是什么？ 1.…...

编程日记 2025/9/11 0:44:08

蓝桥杯备考：贪心算法之矩阵消除游戏

这道题是牛客上的一道题，它呢和我们之前的排座位游戏非常之相似，但是，排座位问题选择行和列是不会改变元素的值的，这道题呢每每选一行都会把这行或者这列清零，所以我们的策略就是先用二进制把选择所有行的情况全部枚举…...

编程日记 2025/9/8 21:46:18

React面试（一）

文章目录 1.vue和react有什么异同2.useEffect中为什么不能使用异步3.useEffect和useLayoutEffect的区别4.react的生命周期5.state和prop的区别6.受控组件和非受控组件7.为什么react16之后不把事件挂载到document上了8.讲一下react的hoc，它可以用来做什么&#xff1f…...

编程日记 2025/9/14 4:16:55

《解锁AI密码，机器人精准感知环境不再是梦！》

在科技飞速发展的当下，人工智能与机器人技术的融合正深刻改变着世界。其中，人工智能助力机器人实现更精准的环境感知，已成为该领域的核心课题，吸引着全球科研人员与科技企业的目光。这不仅关乎机器人能否在复杂环境中高效执行任务…...

编程日记 2025/9/13 21:20:21

C/C++语言知识点二

1. 编程算法之“哨兵”思想哨兵思想是一种编程技巧，通过在数据结构的边界或特定位置放置一个特殊值（称为“哨兵”），来简化逻辑判断和提高代码效率。哨兵通常是一个标记值，用于指示某种条件或边界，从而避免…...

编程日记 2025/9/7 21:45:13

【SpringBoot】——分组校验、自定义注解、登入验证（集成redis）、属性配置方式、多环境开发系统学习知识

🎼个人主页：【Y小夜】 😎作者简介：一位双非学校的大三学生，编程爱好者， 专注于基础和实战分享，欢迎私信咨询！ 🎆入门专栏：🎇【MySQL&#xff0…...

编程日记 2025/9/11 1:25:49

【EB-03】 AUTOSAR builder与EB RTE集成

AUTOSAR builder与EB RTE集成 1. Import Arxml files to Tresos2. Run MultiTask Script3. Add Components3.1 Run EcuExtractCreator Script4. Mapping Component to Partitions5. Event Mapping/Runnables Mapping to Tasks6. Port Connect7. Run SvcAs_Trigger Script8. Ver…...

编程日记 2025/9/9 16:15:30