官网: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.jmhjmh-core1.23org.openjdk.jmhjmh-generator-annprocess1.23provided
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(); // 执行测试}@Benchmarkpublic void entrySet() {// 遍历Iterator> iterator = map.entrySet().iterator();while (iterator.hasNext()) {Map.Entry entry = iterator.next();Integer k = entry.getKey();String v = entry.getValue();}}@Benchmarkpublic void forEachEntrySet() {// 遍历for (Map.Entry entry : map.entrySet()) {Integer k = entry.getKey();String v = entry.getValue();}}@Benchmarkpublic void keySet() {// 遍历Iterator iterator = map.keySet().iterator();while (iterator.hasNext()) {Integer k = iterator.next();String v = map.get(k);}}@Benchmarkpublic void forEachKeySet() {// 遍历for (Integer key : map.keySet()) {Integer k = key;String v = map.get(k);}}@Benchmarkpublic void lambda() {// 遍历map.forEach((key, value) -> {Integer k = key;String v = value;});}@Benchmarkpublic void streamApi() {// 单线程遍历map.entrySet().stream().forEach((entry) -> {Integer k = entry.getKey();String v = entry.getValue();});}@Benchmarkpublic 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
这里仅做了基本的展示使用