关键词:
单元测试
JUnit5 的变化
Spring Boot 2.2.0 版本开始引入 JUnit 5 作为单元测试默认库
注意:
SpringBoot 2.4 以上版本移除了默认对 Vintage 的依赖。如果需要兼容junit4需要自行引入(不能使用junit4的功能 @Test)
JUnit 5’s Vintage Engine Removed from spring-boot-starter-test,如果需要继续兼容junit4需要自行引入vintage
<!--在pom文件中加上一下内容来兼容junit4-->
<dependency>
<groupId>org.junit.vintage</groupId>
<artifactId>junit-vintage-engine</artifactId>
<scope>test</scope>
<exclusions>
<exclusion>
<groupId>org.hamcrest</groupId>
<artifactId>hamcrest-core</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
现在版本:
@SpringBootTest
class Boot05WebAdminApplicationTests
@Test
void contextLoads()
以前:
@SpringBootTest + @RunWith(SpringRunner.class)
SpringBoot整合Junit以后。
编写测试方法:@Test标注(注意需要使用junit5版本的注解)
Junit类具有Spring的功能,@Autowired、比如 @Transactional 标注测试方法,测试完成后自动回滚
JUnit5常用注解
@Test :表示方法是测试方法。但是与JUnit4的@Test不同,他的职责非常单一不能声明任何属性,拓展的测试将会由Jupiter提供额外测试
@ParameterizedTest :表示方法是参数化测试,下方会有详细介绍
@RepeatedTest :表示方法可重复执行,指定测试次数,会重复指定次数
@DisplayName :为测试类或者测试方法设置展示名称
@BeforeEach :表示在每个单元测试之前执行
@AfterEach :表示在每个单元测试之后执行
@BeforeAll :表示在所有单元测试之前执行
@AfterAll :表示在所有单元测试之后执行
标注这上面两个注解的方法必须是static
@Tag :表示单元测试类别,类似于JUnit4中的@Categories
@Disabled :表示测试类或测试方法不执行,类似于JUnit4中的@Ignore
@Timeout :表示测试方法运行如果超过了指定时间将会返回错误
@ExtendWith :为测试类或测试方法提供扩展类引用
常用注解使用演示
//@RunWith
/*
@BootstrapWith(SpringBootTestContextBootstrapper.class)
@ExtendWith(SpringExtension.class)===>替代runwith
*/
@SpringBootTest //使用spring的测试驱动进行测试,这样就可以使用SpringBoot中的容器功能了
@DisplayName("自定义测试类")
public class Test
@DisplayName("自定义测试方法")
@org.junit.jupiter.api.Test
public void test1()
System.out.println("测试方法1运行");
@Disabled //该测试方法不执行
@org.junit.jupiter.api.Test
public void test2()
System.out.println("测试方法2运行");
@RepeatedTest(5)//当前测试方法一旦运行就执行5次
@org.junit.jupiter.api.Test
public void test3()
System.out.println("测试方法3运行");
//规定方法的超时时间,超出指定时间就会抛出异常
@org.junit.jupiter.api.Test
@Timeout(value = 1,unit = TimeUnit.SECONDS)//指定单位,这里是秒
public void test4() throws InterruptedException
Thread.sleep(3000);
System.out.println("测试方法4运行");
@BeforeEach
public void testBeforeEach()
System.out.println("测试方法即将开始");
@AfterEach
public void testAfterEachEach()
System.out.println("测试方法结束");
@BeforeAll
static public void testBeforeAll()
System.out.println("所有测试方法即将开始");
@AfterAll
static public void testAfterEachAll()
System.out.println("所有测试方法结束");
断言机制(assertions)
断言(assertions)是测试方法中的核心部分,用来对测试需要满足的条件进行验证。这些断言方法都是 org.junit.jupiter.api.Assertions 的静态方法。JUnit 5 内置的断言可以分成如下几个类别:
- 检查业务逻辑返回的数据是否合理。
- 所有的测试运行结束以后,会有一个详细的测试报告;
1、简单断言
用来对单个值进行简单的验证。如:
前面的断言失败,后面的断言不会执行
@Test
@DisplayName("simple assertion")
public void simple()
assertEquals(3, 1 + 2, "simple math");
assertNotEquals(3, 1 + 1);
assertNotSame(new Object(), new Object());
Object obj = new Object();
assertSame(obj, obj);
assertFalse(1 > 2);
assertTrue(1 < 2);
assertNull(null);
assertNotNull(new Object());
2、数组断言
通过 assertArrayEquals 方法来判断两个对象或原始类型的数组是否相等
是逻辑相等,也就是equals,不是地址相等,即==对于数组就是数组元素一致
@Test
@DisplayName("array assertion")
public void array()
assertArrayEquals(new int[]1, 2, new int[] 1, 2,"数组内容不相等");
3、组合断言
assertAll 方法接受多个 org.junit.jupiter.api.Executable 函数式接口的实例作为要验证的断言,可以通过 lambda 表达式很容易的提供这些断言
全部断言需要成功,才会执行下面的代码
@Test
@DisplayName("assert all")
public void all()
assertAll("Math",
() -> assertEquals(2, 1 + 1),
() -> assertTrue(1 > 0)
);
4、异常断言
在JUnit4时期,想要测试方法的异常情况时,需要用@Rule注解的ExpectedException变量还是比较麻烦的。而JUnit5提供了一种新的断言方式Assertions.assertThrows() ,配合函数式编程就可以进行使用
第一个参数是预期出现的异常类型,第二个参数是Executable 接口,第三个参数是不符合第一个异常时抛出的信息
断定业务逻辑一定会出现异常,否则会抛出异常
@Test
@DisplayName("异常测试")
public void exceptionTest()
ArithmeticException exception = Assertions.assertThrows(
//扔出断言异常
ArithmeticException.class, () -> System.out.println(1 % 0));
5、超时断言
Junit5还提供了Assertions.assertTimeout() 为测试方法设置了超时时间
@Test
@DisplayName("超时测试")
public void timeoutTest()
//如果测试方法时间超过1s将会异常
Assertions.assertTimeout(Duration.ofMillis(1000), () -> Thread.sleep(500));
6、快速失败
通过 fail 方法直接使得测试失败
@Test
@DisplayName("fail")
public void shouldFail()
fail("This should fail");
4、前置条件(assumptions)
JUnit 5 中的前置条件(assumptions【假设】)类似于断言,不同之处在于不满足的断言会使得测试方法失败,而不满足的前置条件只会使得测试方法的执行终止。前置条件可以看成是测试方法执行的前提,当该前提不满足时,就没有继续执行的必要。
和@disabled一样在测试报告中表现为skiped,注意和上面的包区分,这些方法都是assumptions下面的,上面是assertions下面的。
@DisplayName("前置条件")
public class Test
private final String environment = "DEV";
@org.junit.jupiter.api.Test
@DisplayName("simple")
public void simpleAssume()
assumeTrue(Objects.equals(this.environment, "DEV1"),"两个字符串不相等");
assumeFalse(() -> Objects.equals(this.environment, "PROD"));
@org.junit.jupiter.api.Test
@DisplayName("assume then do")
public void assumeThenDo()
//如果假设成功了,要怎么办
assumingThat(
Objects.equals(this.environment, "DEV"),
() -> System.out.println("In DEV")
);
assumeTrue 和 assumFalse 确保给定的条件为 true 或 false,不满足条件会使得测试执行终止。assumingThat 的参数是表示条件的布尔值和对应的 Executable 接口的实现对象。只有条件满足时,Executable 对象才会被执行;当条件不满足时,测试执行并不会终止。
5、嵌套测试
JUnit 5 可以通过 Java 中的内部类和@Nested 注解实现嵌套测试,从而可以更好的把相关的测试方法组织在一起。在内部类中可以使用@BeforeEach 和@AfterEach 注解,而且嵌套的层次没有限制。
内层的test可以驱动外层的Before(After)Each/All之类的方法提前/之后运行,外层的不能驱动内层的Before(After)Each/All之类的方法
@DisplayName("前置条件")
public class Test
Stack<Object> stack;
@org.junit.jupiter.api.Test
@DisplayName("is instantiated with new Stack()")
void isInstantiatedWithNew()
new Stack<>();
@Nested
@DisplayName("when new")
class WhenNew
@BeforeEach
void createNewStack()
stack = new Stack<>();
@org.junit.jupiter.api.Test
@DisplayName("is empty")
void isEmpty()
assertTrue(stack.isEmpty());
@org.junit.jupiter.api.Test
@DisplayName("throws EmptyStackException when popped")
void throwsExceptionWhenPopped()
assertThrows(EmptyStackException.class, stack::pop);
@org.junit.jupiter.api.Test
@DisplayName("throws EmptyStackException when peeked")
void throwsExceptionWhenPeeked()
assertThrows(EmptyStackException.class, stack::peek);
@Nested
@DisplayName("after pushing an element")
class AfterPushing
String anElement = "an element";
@BeforeEach
void pushAnElement()
stack.push(anElement);
@org.junit.jupiter.api.Test
@DisplayName("it is no longer empty")
void isNotEmpty()
assertFalse(stack.isEmpty());
@org.junit.jupiter.api.Test
@DisplayName("returns the element when popped and is empty")
void returnElementWhenPopped()
assertEquals(anElement, stack.pop());
assertTrue(stack.isEmpty());
@org.junit.jupiter.api.Test
@DisplayName("returns the element when peeked but remains not empty")
void returnElementWhenPeeked()
assertEquals(anElement, stack.peek());
assertFalse(stack.isEmpty());
6、参数化测试
参数化测试是JUnit5很重要的一个新特性,它使得用不同的参数多次运行测试成为了可能,也为我们的单元测试带来许多便利。
利用@ValueSource等注解,指定入参,我们将可以使用不同的参数进行多次单元测试,而不需要每新增一个参数就新增一个单元测试,省去了很多冗余代码。
@ValueSource: 为参数化测试指定入参来源,支持八大基础类以及String类型,Class类型
@NullSource: 表示为参数化测试提供一个null的入参
@EnumSource: 表示为参数化测试提供一个枚举入参
@CsvFileSource:表示读取指定CSV文件内容作为参数化测试入参
@MethodSource:表示读取指定方法的返回值作为参数化测试入参(注意方法返回需要是一个流(Stream)并且必须是今静态方法)
当然如果参数化测试仅仅只能做到指定普通的入参还达不到让我觉得惊艳的地步。让我真正感到他的强大之处的地方在于他可以支持外部的各类入参。如:CSV,YML,JSON 文件甚至方法的返回值也可以作为入参。只需要去实现ArgumentsProvider接口,任何外部文件都可以作为它的入参。
@ParameterizedTest
@ValueSource(strings = "one", "two", "three")
@DisplayName("参数化测试1")
public void parameterizedTest1(String string)
System.out.println(string);
Assertions.assertTrue(StringUtils.isNotBlank(string));
@ParameterizedTest
@MethodSource("method") //指定方法名
@DisplayName("方法来源参数")
public void testWithExplicitLocalMethodSource(String name)
System.out.println(name);
Assertions.assertNotNull(name);
static Stream<String> method()
return Stream.of("apple", "banana");
Junit4到Junit5的迁移指南
在进行迁移的时候需要注意如下的变化:
注解在 org.junit.jupiter.api 包中,断言在 org.junit.jupiter.api.Assertions 类中,前置条件在 org.junit.jupiter.api.Assumptions 类中。
把@Before 和@After 替换成@BeforeEach 和@AfterEach。
把@BeforeClass 和@AfterClass 替换成@BeforeAll 和@AfterAll。
把@Ignore 替换成@Disabled。
把@Category 替换成@Tag。
把@RunWith、@Rule 和@ClassRule 替换成@ExtendWith。
springboot2_单元测试(代码片段)
07、单元测试1、JUnit5的变化SpringBoot2.2.0版本开始引入JUnit5作为单元测试默认库作为最新版本的JUnit框架,JUnit5与之前版本的Junit框架有很大的不同。由三个不同子项目的几个不同模块组成。JUnit5=JUnitPlatform+JUnitJupiter+JU... 查看详情
springboot2单元测试和指标监控(代码片段)
单元测试1、JUnit5的变化SpringBoot2.2.0版本开始引入JUnit5作为单元测试默认库作为最新版本的JUnit框架,JUnit5与之前版本的Junit框架有很大的不同。由三个不同子项目的几个不同模块组成。JUnit5=JUnitPlatform+JUnitJupiter+JUnitVi... 查看详情
springboot2——数据访问的集成&单元测试(junit5)(代码片段)
SpringBoot2——数据访问的集成&单元测试(JUnit5)一、数据访问1.1数据库场景的自动配置(HikariDataSource)1.2整合druid数据源1.2.1自定义druid数据源1.2.2使用官方starter方式1.3整合MyBatis操作(重点)1.3.1整合过... 查看详情
springboot2核心功能---单元测试(代码片段)
一、JUnit5的变化SpringBoot2.2.0版本开始引入JUnit5作为单元测试默认库作为最新版本的JUnit框架,JUnit5与之前版本的Junit框架有很大的不同。由三个不同子项目的几个不同模块组成。JUnit5=JUnitPlatform+JUnitJupiter+JUnitVintageJUnit... 查看详情
springboot——单元测试之junit5(代码片段)
...置条件5.嵌套测试6.参数化测试7.JUnit4→Junit51.JUnit5的变化SpringBoot2.2.0版本开始引入JUnit5作为单元测试默认库作为最新版本的JUnit框架,JUnit5与之前版本的Junit框架有很大的不同。由三个不同子项目的几个不同模块组成。JUnit5=... 查看详情
springboot——单元测试之junit5(代码片段)
...置条件5.嵌套测试6.参数化测试7.JUnit4→Junit51.JUnit5的变化SpringBoot2.2.0版本开始引入JUnit5作为单元测试默认库作为最新版本的JUnit框架,JUnit5与之前版本的Junit框架有很大的不同。由三个不同子项目的几个不同模块组成。JUnit5=... 查看详情
ideaspringboot1.xjunit单元测试
...单元测试框架是junit,其中springboot1.x系列主要使用junit4,springboot2.x主要使用junit5;mock类和打桩的主要框架是mockito,主要有1.x(springboot1.x依赖),2.x(springboot2.0,2.1依赖),3.x(springboot2.2依赖)三个版本。0、关于单元测试首先... 查看详情
解决springboot2.2.5单元测试类的报错
类不存在 原因分析 是junit5升级了框架没有兼容解决办法1改写pom.xml<!--测试模块--><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifac 查看详情
如何在多模块项目中使用 JUnit5 和 SpringBoot2 通过 gradle 而不是 intelliJ 运行测试
】如何在多模块项目中使用JUnit5和SpringBoot2通过gradle而不是intelliJ运行测试【英文标题】:HowtoruntestsbygradleinsteadofintelliJwithJUnit5andSpringBoot2inmultimoduleproject【发布时间】:2020-01-2918:39:26【问题描述】:我创建了一个空的gradle项目,... 查看详情
java应用xviii在java中使用junit5进行单元测试和自动化测试
一、前言单元测试和自动化测试是现代软件开发过程中必不可少的环节,可以提高代码质量和开发效率。JUnit5是Java中流行的单元测试框架,本文将介绍如何在Java中使用JUnit5进行单元测试和自动化测试。二、单元测试2.1单元测试... 查看详情
junit5单元测试教程(代码片段)
...的测试工具是JUnit,通常我们使用JUnit可以对一个逻辑单元进行测试,因此也叫单元测试。多个单元测试组合测试,可以确保我们的程序符合预期。JUnit单元测试可以在开发阶段发现问题,让我们可以提前修复代码&... 查看详情
单元测试实践(springcloud+junit5+mockito+datamocker)
网上看过一句话,单元测试就像早睡早起,每个人都说好,但是很少有人做到。从这么多年的项目经历亲身证明,是真的。这次借着项目内实施单元测试的机会,记录实施的过程和一些总结经验。项目情况首先是背景,项目是一... 查看详情
springboot集成junit5,更优雅单元测试!(代码片段)
来源:https://www.cnblogs.com/haixiang/p/13812363.html 为什么使用JUnit5JUnit4被广泛使用,但是许多场景下使用起来语法较为繁琐,JUnit5中支持lambda表达式,语法简单且代码不冗余。JUnit5易扩展,包容性强,可以接入... 查看详情
一文弄懂springboot+junit5微服务单元测试编写实践
Springboot+Junit5微服务单元测试编写实践现在写单元测试的重要性不言而喻,下边说明一下Junit5测试的会用到的主要注解和方法。PS:常用开发工具都可以自动生成Junit测试类。单元测试命名可参考【翻译】7种流行的单元... 查看详情
junit5单元测试教程(代码片段)
点赞再看,动力无限。微信搜「程序猿阿朗」。本文Github.com/niumoo/JavaNotes和未读代码博客已经收录,有很多知识点和系列文章。在软件开发过程中,我们通常都需要测试自己的代码运行是否正常,可能对一个函数... 查看详情
使用 Micronaut 应用程序为 JUnit5 中的每个单元/集成测试运行一次 TestContainer
】使用Micronaut应用程序为JUnit5中的每个单元/集成测试运行一次TestContainer【英文标题】:RunningTestContaineronceforeachUnit/IntegrationtestinJUnit5withMicronautapplication【发布时间】:2021-10-1707:33:55【问题描述】:我在Micronaut应用程序中使用带... 查看详情
springboot+mock+junit5搭建测试环境
一、springboot2.1.6+junit5.5.2,mock是springboot自带二、pom.xml <properties> <junit.jupiter.version>5.5.2</junit.jupiter.version> </prop 查看详情
如何使用 junit5 和 testcontainers 测试存储库?
...个示例项目,我在其中试验不同的技术。我有以下设置:SpringBoot2.3.4.RELEASE飞路7.0.1测试容器1.15.0-rc2Junit5.7.0如何使用testcontainer-ju 查看详情