官网:http://openjdk.java.net/projects/code-tools/jmh/
一、简介:JMH is a Java harness for building, running, and analysing nano/micro/milli/macro benchmarks written in Java and other languages targetting the JVM,由简介可知,JMH不止能对Java语言做基准测试,还能对运行在JVM上的其他语言做基准测试。而且可以分析到纳秒级别。
二、推荐用法
官方推荐创建一个独立的Maven工程来运行JMH基准测试,这样更能确保结果的准确性。当然也可以在已存在的工程中,或者在IDE上运行,但是越复杂,结果越不可靠(more complex and the results are less reliable)。
三、简单实用
推荐用法通过命令行创建,构建和运行JMH基准测试。
四、实战例子
1)、首先需要引入jmh,推荐pom的方式引入到项目或者工程文件中
org.openjdk.jmh jmh-core 1.23 org.openjdk.jmh jmh-generator-annprocess 1.23 provided
2)、编写需要性能测试分析的代码,这里以HashMap的几种遍历方式为例进行性能测试分析,代码如下:
package test;import org.openjdk.jmh.annotations.*;import org.openjdk.jmh.runner.Runner;import org.openjdk.jmh.runner.RunnerException;import org.openjdk.jmh.runner.options.Options;import org.openjdk.jmh.runner.options.OptionsBuilder;import java.util.HashMap;import java.util.Iterator;import java.util.Map;import java.util.concurrent.TimeUnit;@BenchmarkMode(Mode.AverageTime) // 测试完成时间@OutputTimeUnit(TimeUnit.NANOSECONDS)@Warmup(iterations = 2, time = 1, timeUnit = TimeUnit.SECONDS) // 预热 2 轮,每次 1s@Measurement(iterations = 5, time = 1, timeUnit = TimeUnit.SECONDS) // 测试 5 轮,每次 1s@Fork(1) // fork 1 个线程@State(Scope.Thread) // 每个测试线程一个实例public class HashMapCycleTest { static Map map = new HashMap() {{ // 添加数据 for (int i = 0; i < 100; i++) { put(i, "val:" + i); } }}; public static void main(String[] args) throws RunnerException { // 启动基准测试 Options opt = new OptionsBuilder() .include(HashMapCycleTest.class.getSimpleName()) // 要导入的测试类 .output("d://jmh-map.log") // 输出测试结果的文件 .build(); new Runner(opt).run(); // 执行测试 } @Benchmark public void entrySet() { // 遍历 Iterator> iterator = map.entrySet().iterator(); while (iterator.hasNext()) { Map.Entry entry = iterator.next(); Integer k = entry.getKey(); String v = entry.getValue(); } } @Benchmark public void forEachEntrySet() { // 遍历 for (Map.Entry entry : map.entrySet()) { Integer k = entry.getKey(); String v = entry.getValue(); } } @Benchmark public void keySet() { // 遍历 Iterator iterator = map.keySet().iterator(); while (iterator.hasNext()) { Integer k = iterator.next(); String v = map.get(k); } } @Benchmark public void forEachKeySet() { // 遍历 for (Integer key : map.keySet()) { Integer k = key; String v = map.get(k); } } @Benchmark public void lambda() { // 遍历 map.forEach((key, value) -> { Integer k = key; String v = value; }); } @Benchmark public void streamApi() { // 单线程遍历 map.entrySet().stream().forEach((entry) -> { Integer k = entry.getKey(); String v = entry.getValue(); }); } @Benchmark public void parallelStreamApi() { // 多线程遍历 map.entrySet().parallelStream().forEach((entry) -> { Integer k = entry.getKey(); String v = entry.getValue(); }); }}
所有被添加了 @Benchmark 注解的方法都会被测试
3)、最后执行main方法后就会在我们的D盘下生成日志文件jmh-map.log
这里我贴出部分日志
五、总结
JMH中的基本概念
Warmup
Warmup(iterations = 1,time = 3) 默认是运行10次,每次运行1秒,我们的例子是运行1次,每次3秒
预热,由于JVM中对于特定代码会存在优化(本地化),预热对于测试结果很重要
Fork
代表启动多个单独的进程分别测试
BenchmarkMode
基准测试的模式 默认是Mode.Throughput,表示吞吐量(每秒钟执行多少次)
其他参数还有
AverageTime,表示每次执行时间
SampleTime表示采样时间
SingleShotTime表示只运行一次,用于测试冷启动消耗时间
All表示统计前面的所有指标
Mesurement
@Measurement(iterations = 1,time = 10)
执行多少次,间隔多少秒开始下一次迭代
Timeout 默认为10分钟
每次执行需要在多少分钟内完成,如果在规定时间内没完成就认为超时了。
Threads
每次多少个线程来执行
Fork
多个单独的进程分别测试每个方法,我们这里指定为每个方法启动一个进程。
Benchmark
测试哪一段代码 PSTest.testForEach
这里仅做了基本的展示使用