06.JUnit按条件执行

1.介绍

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

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

介绍

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

1. 给测试类添加注解TestMethodOrder，注解的value是OrderAnnotation.class
2. 给每个测试方法添加Order注解，value值是数字，越小的value越优先执行

使用方式

3.按操作系统设置条件

介绍

根据操作系统情况，决定是否执行

注解

1. @EnabledOnOs：指定多个操作系统，只有当前操作系统是其中的一个，测试方法才会执行
2. @DisabledOnOs：指定多个操作系统，只要当前操作系统是其中的一个，测试方法就不会执行

示例代码

    @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.按JAVA环境设置条件

介绍

根据环境变量，决定是否执行

注解

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

示例代码

    @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));
    }

5.按系统属性设置条件

介绍

根据系统属性，决定是否执行

注解

1. @EnabledIfSystemProperty：指定系统属性的key和期望值（模糊匹配），只有当前系统有此属性并且值也匹配，测试方法才会执行
2. @DisabledIfSystemProperty：定系统属性的key和期望值（模糊匹配），只要当前系统有此属性并且值也匹配，测试方法就不会执行

示例代码

    @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));
    }

6.按环境变量设置条件

介绍

根据环境变量，决定是否执行

注解

1. @EnabledIfEnvironmentVariable：指定环境变量的key和期望值（模糊匹配），只有当前系统有此环境变量并且值也匹配，测试方法才会执行
2. @DisabledIfEnvironmentVariable：指定环境变量的key和期望值（模糊匹配），只要当前系统有此环境变量并且值也匹配，测试方法就不会执行

示例代码

    @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));
    }

7.自定义条件

介绍

前面的条件注解很丰富，但终究是固定、有限的，无法满足所有场景，它们不够用时，咱们还可以自定义前提条件，即EnabledIf和DisabledIf注解

注意

1. EnabledIf和DisabledIf的package，注意是org.junit.jupiter.api.condition，不要用这个org.springframework.test.context.junit.jupiter.EnabledIf，一旦用错，执行测试时会抛出异常
2. EnabledIf和DisabledIf对应的junit版本，它们是从5.7版本版本才开始的

如果版本不正确

用的SpringBoot版本是2.3.4.RELEASE，间接依赖的junit版本是5.6.2，因此，必须在pom.xml中做下图红框中的修改，将间接依赖去掉，并主动依赖5.7.0，才能将junit从5.6.2升级到5.7，这样才能用上EnabledIf和DisabledIf

示例代码

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));
    }

修饰类

前面的代码中，EnabledIf和DisabledIf注解被用来修饰方法，其实它们还可以修饰类，用于控制整个类是否执行单元测试，不过修饰类的时候，对应的自定义方法必须是static类型

方法不在同一个类里面

前面的代码中，customCondition方法和使用它的EnabledIf注解在同一个类中，其实它们也可以在不同的类中，不过此时EnabledIf注解的value要给出：包名、类名、方法名，如下所示，注意类名和方法名之间的连接符是#

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