参考:https://blog.csdn.net/agonie201218/article/details/122333354
1 简介
JMH
即Java Microbenchmark Harness
,JMH(Java Microbenchmark Harness)是用于代码微基准测试的工具套件,主要是基于方法层面的基准测试,精度可以达到纳秒级。
该工具是由 Oracle 内部实现 JIT 的大牛们编写的,他们应该比任何人都了解 JIT 以及 JVM 对于基准测试的影响,测试结果可信度高。
官网:https://openjdk.org/projects/code-tools/jmh/
2 应用场景
当你定位到热点方法,希望进一步优化方法性能的时候,就可以使用 JMH 对优化的结果进行量化的分析。
1)想准确地知道某个方法需要执行多长时间,以及执行时间和输入之间的相关性
2)对比接口不同实现在给定条件下的吞吐量
3)查看多少百分比的请求在多长时间内完成
3 基本使用

3.2 添加JMH依赖
<!--JMH-->
<dependency>
<groupId>org.openjdk.jmh</groupId>
<artifactId>jmh-core</artifactId>
<version>1.23</version>
</dependency>
<dependency>
<groupId>org.openjdk.jmh</groupId>
<artifactId>jmh-generator-annprocess</artifactId>
<version>1.23</version>
</dependency>
3.3 准备一个要测试的方法
public class JMHSample_01 {
static List<Integer> nums = new ArrayList<>();
static {
Random r = new Random();
for (int i = 0; i < 10000; i++) nums.add(1000000 + r.nextInt(1000000));
}
public static void foreach() {
nums.forEach(v->isPrime(v));
}
public static boolean isPrime(int num) {
for(int i=2; i<=num/2; i++) {
if(num % i == 0) return false;
}
return true;
}
}
3.4 在test下测试
public class JMHSample_01_test {
@BenchmarkMode(Mode.AverageTime) // 指定mode为Mode.AverageTime
@Benchmark
@Warmup(iterations = 5, time = 1, timeUnit = TimeUnit.SECONDS)
@Measurement(iterations = 10, time = 1, timeUnit = TimeUnit.SECONDS)
@Fork(2)
public void t(){
JMHSample_01.foreach();
}
}
3.5 右键执行
3.5.1 可能出现的错误
打开Run-Edit Configuration → Environment Variables → include system environment viables
3.5.2 执行结果
4 相关注解介绍
4.1 @Benchmark
@Benchmark
声明一个public
方法为基准测试方法
4.2 @BenchmarkMode
@BenchmarkMode(Mode.AverageTime)
通过JMH
我们可以轻松的测试出某个接口的吞吐量、平均执行时间等指标的数据。
假设我想测试平均耗时,那么可以使用@BenchmarkMode
注解指定测试维度为Mode.AverageTime
有一下几种模式:
1)Throughput: 整体吞吐量,比如 QPS,单位时间内的调用量等;
2)AverageTime: 平均耗时,指的是每次执行的平均时间。如果这个值很小不好辨认,可以把统计的单位时间调小一点;
3)SampleTime: 随机取样,这和我们在第一课时里聊到的 TP 值是一个概念;
4)SingleShotTime: 如果你想要测试仅仅一次的性能,比如第一次初始化花了多长时间,就可以使用这个参数,其实和传统的 main 方法没有什么区别;
5)All: 所有的指标,都算一遍,你可以设置成这个参数看下效果。
4.3 @Measurement
@Measurement(iterations = 10, time = 1, timeUnit = TimeUnit.SECONDS)
iterations:测试次数,注意,测试次数不是执行被测试方法的次数,每次测试会执行N次被测试方法
time:每次测量的持续时间,timeUnit
指定时间单位,本例中:每次测量持续1秒,1秒内执行的被测试
方法的次数是不固定的,由方法执行耗时和time决定
4.4 @Warmup
@Warmup(iterations = 5, time = 1, timeUnit = TimeUnit.SECONDS)
为了数据准确,我们可能需要让被测试方法做下热身运动。jvm使用JIT即时编译器,一定的预热次数可让JIT对testGson方法的调用链路完成编译,去掉解释执行对测试结果的影响
iterations
:预热次数;
time与timeUnit
:每次预热的持续时间,timeUnit
指定时间单位。
4.5 @Fork
@Fork(1)
@Fork
用于指定fork
出多少个子进程来执行同一基准测试方法。
fork 的值一般设置成 1,表示只使用一个进程进行测试;如果这个数字大于 1,表示会启用新的进程进行测试;但如果设置成 0,程序依然会运行,不过是这样是在用户的 JVM 进程上运行的,不推荐这么做
4.6 @Threads
@Threads(2)
@Threads
注解用于指定使用多少个线程来执行基准测试方法,如果使用@Threads
指定线程数为2
,那么每次测量都会创建两个线程来执行基准测试方法。
如果@Measurement注解指定time为1s,基准测试方法的执行耗时为1s,那么如果只使用单个线程,一次测量只会执行一次基准测试方法,如果使用10个线程,一次测量就能执行10次基准测试方法。
4.7 @OutputTimeUnit
@OutputTimeUnit(TimeUnit.NANOSECONDS)
OutputTimeUnit注解用于指定输出的方法执行耗时的单位。如果方法执行耗时为秒级别,为了便于 观察结果,我们可以使用@OutputTimeUnit指定输出的耗时时间单位为秒;如果方法执行耗时为毫秒级别,为了便于观察结果,我们可以使用@OutputTimeUnit指定输出的耗时时间单位为毫秒,否则使用默认的秒做单位,会输出10的负几次方这样的数字,不太直观。
4.8 @Group
@Group 注解只能加在方法上,用来把测试方法进行归类。如果你单个测试文件中方法比较多,或者需要将其归类,则可以使用这个注解。
与之关联的 @GroupThreads 注解,会在这个归类的基础上,再进行一些线程方面的设置。这两个注解都很少使用,除非是非常大的性能测试案例。
4.9 @State
@State 指定了在类中变量的作用范围,用于声明某个类是一个“状态”,可以用 Scope 参数用来表示该状态的共享范围。这个注解必须加在类上,否则提示无法运行。
Scope 有如下三种值:
1)Benchmark :表示变量的作用范围是某个基准测试类。
2)Thread :每个线程一份副本,如果配置了 Threads 注解,则每个 Thread 都拥有一份变量,它们互不影响。
3)Group :联系上面的 @Group 注解,在同一个 Group 里,将会共享同一个变量实例
在官方demo:JMHSample04DefaultState 测试文件中,演示了@Group的使用
4.10 @Setup 和 @TearDown
和单元测试框架 JUnit 类似,@Setup 用于基准测试前的初始化动作,@TearDown 用于基准测试后的动作,来做一些全局的配置。
这两个注解,同样有一个 Level 值,标明了方法运行的时机,它有三个取值。
1)Trial :默认的级别,也就是 Benchmark 级别。
2)Iteration :每次迭代都会运行。
3)Invocation :每次方法调用都会运行,这个是粒度最细的。
如果你的初始化操作,是和方法相关的,那最好使用 Invocation 级别。但大多数场景是一些全局的资源,比如一个 Spring 的 DAO,那么就使用默认的 Trial,只初始化一次就可以。
4.11 @Param
@Param 注解只能修饰字段,用来测试不同的参数,对程序性能的影响。配合 @State注解,可以同时制定这些参数的执行范围。
4.12 @CompilerControl
这可以说是一个非常有用的功能了。
Java 中方法调用的开销是比较大的,尤其是在调用量非常大的情况下。拿简单的getter/setter 方法来说,这种方法在 Java 代码中大量存在。我们在访问的时候,就需要创建相应的栈帧,访问到需要的字段后,再弹出栈帧,恢复原程序的执行。
如果能够把这些对象的访问和操作,纳入目标方法的调用范围之内,就少了一次方法调用,速度就能得到提升,这就是方法内联的概念。如下图所示,代码经过 JIT 编译之后,效率会有大的提升
这个注解可以用在类或者方法上,能够控制方法的编译行为,常用的有 3 种模式:
强制使用内联(INLINE),禁止使用内联(DONT_INLINE),甚至是禁止方法编译(EXCLUDE)等。
5 官方demo
http://hg.openjdk.java.net/code-tools/jmh/file/tip/jmh-samples/src/main/java/org/openjdk/jmh/samples/
把官方demo的注解翻译后的demo
https://github.com/Childe-Chen/goodGoodStudy/tree/master/src/main/java/com/cxd/benchmark
6 结果输出形式
使用 JMH 测试的结果,可以二次加工,进行图形化展示。结合图表数据,更加直观。通过运行时,指定输出的格式文件,即可获得相应格式的性能测试结果。
比如下面这行代码,就是指定输出 JSON 格式的数据
Options opt = new OptionsBuilder()
.resultFormat(ResultFormatType.JSON)
.build();
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· DeepSeek “源神”启动!「GitHub 热点速览」
· 微软正式发布.NET 10 Preview 1:开启下一代开发框架新篇章
· C# 集成 DeepSeek 模型实现 AI 私有化(本地部署与 API 调用教程)
· DeepSeek R1 简明指南:架构、训练、本地部署及硬件要求
· 2 本地部署DeepSeek模型构建本地知识库+联网搜索详细步骤
2020-12-14 Lodop打印小票