JUnit5学习之四：按条件执行

欢迎访问我的GitHub

https://github.com/zq2599/blog_demos

内容：所有原创文章分类汇总及配套源码，涉及Java、Docker、Kubernetes、DevOPS等；

关于《JUnit5学习》系列

《JUnit5学习》系列旨在通过实战提升SpringBoot环境下的单元测试技能，一共八篇文章，链接如下：

1. 基本操作
2. Assumptions类
3. Assertions类
4. 按条件执行
5. 标签(Tag)和自定义注解
6. 参数化测试(Parameterized Tests)基础
7. 参数化测试(Parameterized Tests)进阶
8. 综合进阶（终篇）

本篇概览

本文是《JUnit5学习》系列的第四篇，有时咱们希望测试方法仅在一定条件下才执行，例如有的测试方法只适合Linux环境，这就是按条件执行的需求，本篇的主要内容就是学习如何为测试方法设置前提条件，只有满足了这些条件测试才会被执行，本篇大纲如下：

1. 自定义测试方法的执行顺序
2. 按操作系统设置条件
3. 按JAVA环境设置条件
4. 按系统属性设置条件
5. 按环境变量设置条件
6. 自定义条件

源码下载

1. 如果您不想编码，可以在GitHub下载所有源码，地址和链接信息如下表所示：

名称	链接	备注
项目主页	https://github.com/zq2599/blog_demos	该项目在GitHub上的主页
git仓库地址(https)	https://github.com/zq2599/blog_demos.git	该项目源码的仓库地址，https协议
git仓库地址(ssh)	git@github.com:zq2599/blog_demos.git	该项目源码的仓库地址，ssh协议

2. 这个git项目中有多个文件夹，本章的应用在junitpractice文件夹下，如下图红框所示：

3. junitpractice是父子结构的工程，本篇的代码在conditional子工程中，如下图：

自定义测试方法的执行顺序

今天要写的测试方法很多，为了管理好这些方法，在学习按条件执行之前先来看看如何控制测试方法的执行顺序：

1. 给测试类添加注解TestMethodOrder，注解的value是OrderAnnotation.class
2. 给每个测试方法添加Order注解，value值是数字，越小的value越优先执行
3. 使用方法如下图所示：

• 接下来的实战中，咱们就用上述方法控制测试方法的执行顺序；

按操作系统设置条件

1. 注解EnabledOnOs指定多个操作系统，只有当前操作系统是其中的一个，测试方法才会执行；
2. 注解DisabledOnOs指定多个操作系统，只要当前操作系统是其中的一个，测试方法就不会执行；
3. 测试代码如下：

 @Test @Order(1) @EnabledOnOs(OS.WINDOWS) @DisplayName("操作系统：只有windows才会执行") void onlyWindowsTest() {  assertEquals(2, Math.addExact(1, 1)); } @Test @Order(2) @EnabledOnOs({OS.WINDOWS, OS.LINUX}) @DisplayName("操作系统：windows和linux都会执行") void windowsORLinuxTest() {  assertEquals(2, Math.addExact(1, 1)); } @Test @Order(3) @DisabledOnOs({OS.MAC}) @DisplayName("操作系统：只有MAC才不会执行") void withoutMacTest() {  assertEquals(2, Math.addExact(1, 1)); }

4. 我这里是windows操作系统，上述三个方法执行结果如下：

按JAVA环境设置条件

1. 注解EnabledOnJre指定多个JRE版本，只有当前JRE是其中的一个，测试方法才会执行；
2. 注解DisabledOnJre指定多个JRE版本，只要当前JRE是其中的一个，测试方法就不会执行；
3. 注解EnabledForJreRange指定JRE版本的范围，只有当前JRE在此范围内，测试方法才会执行；
4. 注解DisabledForJreRange指定JRE版本的范围，只要当前JRE在此范围内，测试方法就不会执行；
5. 测试代码如下：

 @Test @Order(4) @EnabledOnJre({JRE.JAVA_9, JRE.JAVA_11}) @DisplayName("Java环境：只有JAVA9和11版本才会执行") void onlyJava9And11Test() {  assertEquals(2, Math.addExact(1, 1)); } @Test @Order(5) @DisabledOnJre({JRE.JAVA_9}) @DisplayName("Java环境：JAVA9不执行") void withoutJava9Test() {  assertEquals(2, Math.addExact(1, 1)); } @Test @Order(6) @EnabledForJreRange(min=JRE.JAVA_8, max=JRE.JAVA_11) @DisplayName("Java环境：从JAVA8到1之间的版本都会执行") void fromJava8To11Test() {  assertEquals(2, Math.addExact(1, 1)); }

6. 我这里是JDK8，执行结果如下：

按系统属性设置条件

1. 注解EnabledIfSystemProperty指定系统属性的key和期望值(模糊匹配)，只有当前系统有此属性并且值也匹配，测试方法才会执行；
2. 注解DisabledIfSystemProperty指定系统属性的key和期望值(模糊匹配)，只要当前系统有此属性并且值也匹配，测试方法就不会执行；
3. 测试代码如下：

 @Test @Order(7) @EnabledIfSystemProperty(named = "os.arch", matches = ".*64.*") @DisplayName("系统属性：64位操作系统才会执行") void only64BitArch() {  assertEquals(2, Math.addExact(1, 1)); } @Test @Order(8) @DisabledIfSystemProperty(named = "java.vm.name", matches = ".*HotSpot.*") @DisplayName("系统属性：HotSpot不会执行") void withOutHotSpotTest() {  assertEquals(2, Math.addExact(1, 1)); }

4. 上述测试方法执行结果如下：

按环境变量设置条件

1. 注解EnabledIfEnvironmentVariable指定环境变量的key和期望值(模糊匹配)，只有当前系统有此环境变量并且值也匹配，测试方法才会执行；
2. 注解DisabledIfEnvironmentVariable指定环境变量的key和期望值(模糊匹配)，只要当前系统有此环境变量并且值也匹配，测试方法就不会执行；
3. 测试代码如下：

 @Test @Order(9) @EnabledIfEnvironmentVariable(named = "JAVA_HOME", matches = ".*") @DisplayName("环境变量：JAVA_HOME才会执行") void onlyJavaHomeExistsInEnvTest() {  assertEquals(2, Math.addExact(1, 1)); } @Test @Order(10) @DisabledIfEnvironmentVariable(named = "GOPATH", matches = ".*") @DisplayName("环境变量：有GOPATH就不执行") void withoutGoPathTest() {  assertEquals(2, Math.addExact(1, 1)); }

4. 上述测试方法执行结果如下：

自定义条件(从junit5.7版本开始)

1. 前面的条件注解很丰富，但终究是固定、有限的，无法满足所有场景，它们不够用时，咱们还可以自定义前提条件，即EnabledIf和DisabledIf注解；
2. 有两个关键点要格外注意，首先是EnabledIf和DisabledIf的package，注意是org.junit.jupiter.api.condition，不要用这个：org.springframework.test.context.junit.jupiter.EnabledIf，一旦用错，执行测试时会抛出异常；
3. 第二个要注意的是EnabledIf和DisabledIf对应的junit版本，它们是从5.7版本版本才开始的，而本文用的SpringBoot版本是2.3.4.RELEASE，间接依赖的junit版本是5.6.2，因此，必须在pom.

4. EnabledIf的用法很简单，value是个存在的方法的名字，该方法必须返回boolean类型，demo如下，customCondition是个很简单的方法，被用来做是否执行单元测试的判断条件：

 boolean customCondition() {  return true; } @Test @Order(11) @EnabledIf("customCondition") @DisplayName("自定义：customCondition返回true就执行") void onlyCustomConditionTest() {  assertEquals(2, Math.addExact(1, 1)); } @Test @Order(12) @DisabledIf("customCondition") @DisplayName("自定义：customCondition返回true就不执行") void withoutCustomConditionTest() {  assertEquals(2, Math.addExact(1, 1)); }

5. 上述测试方法执行结果如下：

6. 前面的代码中，EnabledIf和DisabledIf注解被用来修饰方法，其实它们还可以修饰类，用于控制整个类是否执行单元测试，不过修饰类的时候，对应的自定义方法必须是static类型；
7. 前面的代码中，customCondition方法和使用它的EnabledIf注解在同一个类中，其实它们也可以在不同的类中，不过此时EnabledIf注解的value要给出：包名、类名、方法名，如下所示，注意类名和方法名之间的连接符是#：

 @Test @Order(12) @DisabledIf("com.example.Conditions#customCondition") @DisplayName("自定义：customCondition返回true就不执行") void withoutCustomConditionTest() {  assertEquals(2, Math.addExact(1, 1)); }

• 以上就是常用的按条件执行单元测试的各种实例了，希望本文能给您提供参考，助您在各种场景更加精确的控制用例的执行逻辑；

你不孤单，欣宸原创一路相伴

1. Java系列
2. Spring系列
3. Docker系列
4. kubernetes系列
5. 数据库+中间件系列
6. DevOps系列

欢迎关注公众号：程序员欣宸

微信搜索「程序员欣宸」，我是欣宸，期待与您一同畅游Java世界...
https://github.com/zq2599/blog_demos

原文转载：http://www.shaoqun.com/a/585572.html

跨境电商：https://www.ikjzd.com/

飞书互动：https://www.ikjzd.com/w/1319

livingsocial：https://www.ikjzd.com/w/714.html

欢迎访问我的GitHubhttps://github.com/zq2599/blog_demos内容：所有原创文章分类汇总及配套源码，涉及Java、Docker、Kubernetes、DevOPS等；关于《JUnit5学习》系列《JUnit5学习》系列旨在通过实战提升SpringBoot环境下的单元测试技能，一共八篇文章，链接如下：基本操作Assumptions类Assertions类按条件执行标
modcloth：https://www.ikjzd.com/w/1271
瀚霖：https://www.ikjzd.com/w/2345
亚马逊全球开店制造：https://www.ikjzd.com/w/204.html
谷歌不收录？4个步骤将你的URL提交给Google：https://www.ikjzd.com/home/127570
产品上传操作演练：https://www.kjyunke.com/courses/92
豌豆公主：已协调日本20多家口罩供应商 现库存20万件：https://www.ikjzd.com/home/115019