注解（Annotations）是JUnit的标志性技术，本文就来对它的20个注解，以及元注解和组合注解进行学习。

20个注解

在org.junit.jupiter.api包中定义了这些注解，它们分别是：

• @Test 测试方法，可以直接运行。

• @ParameterizedTest 参数化测试，比如：

  @ParameterizedTest
  @ValueSource(strings = { "racecar", "radar", "able was I ere I saw elba" })
  void palindromes(String candidate) {
      assertTrue(StringUtils.isPalindrome(candidate));
  }
  

• @RepeatedTest 重复测试，比如：

  @RepeatedTest(10)
  void repeatedTest() {
      // ...
  }
  

• @TestFactory 测试工厂，专门生成测试方法，比如：

  import org.junit.jupiter.api.DynamicTest;
  
  @TestFactory
  Collection<DynamicTest> dynamicTestsFromCollection() {
      return Arrays.asList(
          dynamicTest("1st dynamic test", () -> assertTrue(isPalindrome("madam"))),
          dynamicTest("2nd dynamic test", () -> assertEquals(4, calculator.multiply(2, 2)))
      );
  }
  

• @TestTemplate 测试模板，比如：

  final List<String> fruits = Arrays.asList("apple", "banana", "lemon");
  
  @TestTemplate
  @ExtendWith(MyTestTemplateInvocationContextProvider.class)
  void testTemplate(String fruit) {
      assertTrue(fruits.contains(fruit));
  }
  
  public class MyTestTemplateInvocationContextProvider
          implements TestTemplateInvocationContextProvider {
  
      @Override
      public boolean supportsTestTemplate(ExtensionContext context) {
          return true;
      }
  
      @Override
      public Stream<TestTemplateInvocationContext> provideTestTemplateInvocationContexts(
              ExtensionContext context) {
  
          return Stream.of(invocationContext("apple"), invocationContext("banana"));
      }
  }
  

  @TestTemplate必须注册一个TestTemplateInvocationContextProvider，它的用法跟@Test类似。

• @TestMethodOrder 指定测试顺序，比如：

  import org.junit.jupiter.api.MethodOrderer.OrderAnnotation;
  import org.junit.jupiter.api.Order;
  import org.junit.jupiter.api.Test;
  import org.junit.jupiter.api.TestMethodOrder;
  
  @TestMethodOrder(OrderAnnotation.class)
  class OrderedTestsDemo {
  
      @Test
      @Order(1)
      void nullValues() {
          // perform assertions against null values
      }
  
      @Test
      @Order(2)
      void emptyValues() {
          // perform assertions against empty values
      }
  
      @Test
      @Order(3)
      void validValues() {
          // perform assertions against valid values
      }
  
  }
  

• @TestInstance 是否生成多个测试实例，默认JUnit每个测试方法生成一个实例，使用这个注解能让每个类只生成一个实例，比如：

  @TestInstance(Lifecycle.PER_CLASS)
  class TestMethodDemo {
  
      @Test
      void test1() {
      }
  
      @Test
      void test2() {
      }
  
      @Test
      void test3() {
      }
  
  }
  

• @DisplayName 自定义测试名字，会体现在测试报告中，比如：

  import org.junit.jupiter.api.DisplayName;
  import org.junit.jupiter.api.Test;
  
  @DisplayName("A special test case")
  class DisplayNameDemo {
  
      @Test
      @DisplayName("Custom test name containing spaces")
      void testWithDisplayNameContainingSpaces() {
      }
  
      @Test
      @DisplayName("╯°□°）╯")
      void testWithDisplayNameContainingSpecialCharacters() {
      }
  
      @Test
      @DisplayName("