ContiPerf-更为优雅和方便的单元压力测试工具

ContiPerf 是一个轻量级的单元测试工具,基于JUnit 4二次开发,使用它基于注解的方式,快速在本地进行单元压测并提供详细的报告。

Example

新建 SpringBoot 工程

POM文件中的核心依赖如下:

1
2
3
4
5
6
7
8
9
10
11
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.databene</groupId>
<artifactId>contiperf</artifactId>
<version>2.1.0</version>
<scope>test</scope>
</dependency>

测试接口以及实现

1
2
3
4
5
6
7
8
package com.wuwenze.contiperf.service;

import java.util.List;

public interface ContiperfExampleService {

List<String> findAll();
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
import com.wuwenze.contiperf.service.ContiperfExampleService;

import org.springframework.stereotype.Service;

import java.util.ArrayList;
import java.util.List;
import java.util.Random;

import lombok.extern.slf4j.Slf4j;

@Slf4j
@Service
public class ContiperfExampleServiceImpl implements ContiperfExampleService {
private final Random RANDOM = new Random();

@Override
public List<String> findAll() {
try {
int sleepSecond = RANDOM.nextInt(10);
log.info("#findAll(): sleep {} seconds..", sleepSecond);
Thread.sleep(sleepSecond * 1000);
} catch (InterruptedException e) {
// ignore
}
List<String> resultList = new ArrayList<>();
for (int i = 0; i < 1000; i++) {
resultList.add("string_" + i);
}
return resultList;
}
}

构建单元测试

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
package com.wuwenze.contiperf.service;

import com.wuwenze.contiperf.ContiperfExamplesApplication;

import org.databene.contiperf.PerfTest;
import org.databene.contiperf.junit.ContiPerfRule;
import org.junit.Rule;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;


@RunWith(SpringRunner.class)
@SpringBootTest(classes = ContiperfExamplesApplication.class)
public class ContiperfExampleServiceTest {
@Rule
public ContiPerfRule i = new ContiPerfRule();

@Autowired
private ContiperfExampleService contiperfExampleService;

@Test
@PerfTest(threads = 1000, duration = 1500)
public void findAll() {
contiperfExampleService
.findAll()
.forEach(System.out::println);
}
}

最终执行效果

查看测试报告

##

总结

PerfTest参数

参数 描述
PerfTest(invocations = 300) 执行300次,和线程数量无关,默认值为1,表示执行1次;
@PerfTest(threads=30) 并发执行30个线程,默认值为1个线程;
PerfTest(duration = 20000) 重复地执行测试至少执行20s。

以上三个属性可以组合使用,其中Threads必须和其他两个属性组合才能生效。当Invocations和Duration都有指定时,以执行次数多的为准。

1
2
3
4
5
6
7
8
9
10
11
// 如果执行方法300次的时候执行时间还没到100ms,则继续执行到满足执行时间等于100ms,如果执行到50次的时候已经100ms了,则会继续执行之100次。
@PerfTest(invocations = 300, threads = 2, duration = 100),

// 如果你不想让测试连续不间断的跑完,可以通过注释设置等待时间,每执行完一次会等待30~80ms然后才会执行下一次调用。
@PerfTest(invocations = 1000, threads = 10, timer = RandomTimer.class, timerParams = { 30, 80 })

// 在开多线程进行并发压测的时候,如果一下子达到最大进程数有些系统可能会受不了,ContiPerf还提供了“预热”功能
@PerfTest(threads = 10, duration = 60000, rampUp = 1000);
// 启动时会先起一个线程,然后每个1000ms起一线程,到9000ms时10个线程同时执行,那么这个测试实际执行了69s,如果只想衡量全力压测的结果,那么可以在注释中加入warmUp,即
@PerfTest(threads = 10, duration = 60000, rampUp = 1000, warmUp = 9000);
// 那么统计结果的时候会去掉预热的9s。

Required参数

参数 描述
Required(throughput = 20) 要求每秒至少执行20个测试;
Required(average = 50) 要求平均执行时间不超过50ms;
Required(median = 45) 要求所有执行的50%不超过45ms;
Required(max = 2000) 要求没有测试超过2s;
Required(totalTime = 5000) 要求总的执行时间不超过5s;
Required(percentile90 = 3000) 要求90%的测试不超过3s;
Required(percentile95 = 5000) 要求95%的测试不超过5s;
Required(percentile99 = 10000) 要求99%的测试不超过10s;
Required(percentiles = “66:200,96:500”) 要求66%的测试不超过200ms,96%的测试不超过500ms。

测试报告

最终的测试报告位于target/contiperf-report/index.html,使用浏览器打开即可。

评论

Your browser is out-of-date!

Update your browser to view this website correctly. Update my browser now

×