JUnit5：指定多个@Nested 类的执行顺序

Question

Junit5 是否对同一父级中定义的@Nested 类的执行顺序提供任何保证？通过我做的一个简单的例子，我注意到测试是以声明的相反顺序执行的，但是这种行为既没有记录（或者是它？）也不与@Test 注释方法的默认排序方式一致。

这也很烦人，因为显然我宁愿有一个不颠倒的顺序，如果不是一种类似于 @TestMethodOrder 的配置方式。

import org.junit.jupiter.api.Nested;
import org.junit.jupiter.api.Test;

class NestedOrderTest {
    @Nested
    class NestedTest1 {
        @Test
        void testSuccess1() {
            System.out.println(1);
        }
    }

    @Nested
    class NestedTest2 {
        @Test
        void testSuccess2() {
            System.out.println(2);
        }
    }

    @Nested
    class NestedTest3 {
        @Test
        void testSuccess3() {
            System.out.println(3);
        }
    }
}

输出：

3
2
1

Answer 1

默认情况下，单元测试库不会尝试按照源文件中出现的顺序执行测试。
JUnit 5 作为 JUnit 4 以这种方式工作。为什么 ？因为如果顺序很重要，则意味着它们之间会耦合一些测试，这不适合单元测试（重点是我的）：

2.9。测试执行顺序

默认情况下，测试方法将使用以下算法进行排序 确定性但故意不明显。这确保了 测试套件的后续运行以相同的方式执行测试方法 顺序，从而允许可重复的构建。

所以预计 JUnit 5 引入的@Nested 功能遵循相同的默认方法。

但对于集成测试，测试方法的顺序可能很重要，因为在执行的测试方法之间不一定会清除状态。
因此，在 JUnit 5 中，您可以通过使用 @TestMethodOrder(OrderAnnotation.class) 注释测试类并使用 @Order(numericOrderValue) 为顺序重要的方法指定顺序来设置执行顺序。

但@Order 旨在装饰要测试的方法，而不是您想要的测试类本身：

@API(status = EXPERIMENTAL, since = "5.4")
@Target({ ElementType.FIELD, ElementType.METHOD })
public @interface Order {...}

您还可以注意到，这是一个实验性功能。

因此，您可以在这里订购的唯一东西是同一 @Nested 范围内的测试方法，例如：

@Nested
class NestedTest1 {

    @Order(3)
    @Test
    void success3() {
        System.out.println(3);
    }

    @Order(2)
    @Test
    void success2() {
        System.out.println(2);
    }

    @Order(1)
    @Test
    void success1() {
        System.out.println(1);
    }
}

输出：

1

2

3

顺便说一句，似乎不需要指定@TestMethodOrder(OrderAnnotation.class)（至少在我测试的5.4.0版本中）。

Answer 2

Junit 5.8 中添加了@Nested 类排序功能。在这一点上，平台提供了用户可能需要的所有保证。

import org.junit.jupiter.api.ClassOrderer;
import org.junit.jupiter.api.Nested;
import org.junit.jupiter.api.Order;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.TestClassOrder;

@TestClassOrder(ClassOrderer.OrderAnnotation.class)
class OrderedNestedTestClassesDemo {

    @Nested
    @Order(1)
    class PrimaryTests {

        @Test
        void test1() {
        }
    }

    @Nested
    @Order(2)
    class SecondaryTests {

        @Test
        void test2() {
        }
    }
}