«Переход с JUnit 4 на JUnit 5» - Spring на русском

«1. Обзор

В этой статье мы увидим, как мы можем перейти с JUnit 4 на последнюю версию JUnit 5, с обзором различий между двумя версиями библиотеки.

Общие рекомендации по использованию JUnit 5 см. в нашей статье здесь.

2. Преимущества JUnit 5

Начнем с предыдущей версии — JUnit 4 имеет некоторые явные ограничения:

Весь фреймворк содержался в одной библиотеке jar. Всю библиотеку необходимо импортировать, даже если требуется только конкретная функция. В JUnit 5 мы получаем больше детализации и можем импортировать только то, что необходимо. Один исполнитель тестов может одновременно выполнять только тесты в JUnit 4 (например, SpringJUnit4ClassRunner или Parameterized). JUnit 5 позволяет нескольким исполнителям работать одновременно JUnit 4 никогда не продвигался дальше Java 7, упуская множество функций из Java 8. JUnit 5 хорошо использует функции Java 8

Идея JUnit 5 заключалась в том, чтобы полностью переписать JUnit 4 устранить большинство из этих недостатков.

3. Отличия

JUnit 4 был разделен на модули, составляющие JUnit 5:

Платформа JUnit — этот модуль охватывает все платформы расширения, которые могут нас заинтересовать в выполнении тестов, обнаружении и составлении отчетов JUnit Vintage — – этот модуль обеспечивает обратную совместимость с JUnit 4 или даже с JUnit 3

3.1. Аннотации

JUnit 5 содержит важные изменения в своих аннотациях. Наиболее важным из них является то, что мы больше не можем использовать аннотацию @Test для указания ожиданий.

Ожидаемый параметр в JUnit 4:

@Test(expected = Exception.class)
public void shouldRaiseAnException() throws Exception {
    // ...
}

Теперь мы можем использовать метод assertThrows:

public void shouldRaiseAnException() throws Exception {
    Assertions.assertThrows(Exception.class, () -> {
        //...
    });
}

Атрибут timeout в JUnit 4:

@Test(timeout = 1)
public void shouldFailBecauseTimeout() throws InterruptedException {
    Thread.sleep(10);
}

Теперь метод assertTimeout в JUnit 5:

@Test
public void shouldFailBecauseTimeout() throws InterruptedException {
    Assertions.assertTimeout(Duration.ofMillis(1), () -> Thread.sleep(10));
}

Другие аннотации, которые были изменены в JUnit 5:

@Before аннотация переименована в @BeforeEach @After аннотация переименована в @AfterEach @BeforeClass аннотация переименована в @BeforeAll @AfterClass аннотация переименована to @AfterAll @Ignore аннотация переименована в @Disabled

3.2. Утверждения

Теперь мы можем писать сообщения об утверждениях в лямбда-выражении в JUnit 5, позволяя ленивой оценке пропускать построение сложных сообщений до тех пор, пока они не понадобятся:

@Test
public void shouldFailBecauseTheNumbersAreNotEqual_lazyEvaluation() {
    Assertions.assertTrue(
      2 == 3, 
      () -> "Numbers " + 2 + " and " + 3 + " are not equal!");
}

Мы также можем группировать утверждения в JUnit 5:

@Test
public void shouldAssertAllTheGroup() {
    List<Integer> list = Arrays.asList(1, 2, 4);
    Assertions.assertAll("List is not incremental",
        () -> Assertions.assertEquals(list.get(0).intValue(), 1),
        () -> Assertions.assertEquals(list.get(1).intValue(), 2),
        () -> Assertions.assertEquals(list.get(2).intValue(), 3));
}

3.3. Предположения

Новый класс Предположений теперь находится в org.junit.jupiter.api.Assumptions. JUnit 5 полностью поддерживает существующие методы предположений в JUnit 4, а также добавляет набор новых методов, позволяющих выполнять некоторые утверждения только в определенных сценариях:

@Test
public void whenEnvironmentIsWeb_thenUrlsShouldStartWithHttp() {
    assumingThat("WEB".equals(System.getenv("ENV")),
      () -> {
          assertTrue("http".startsWith(address));
      });
}

3.4. Тегирование и фильтрация

В JUnit 4 мы могли группировать тесты, используя аннотацию @Category. В JUnit 5 аннотация @Category заменяется аннотацией @Tag:

@Tag("annotations")
@Tag("junit5")
@RunWith(JUnitPlatform.class)
public class AnnotationTestExampleTest {
    /*...*/
}

Мы можем включать/исключать определенные теги с помощью плагина maven-surefire:

<build>
    <plugins>
        <plugin>
            <artifactId>maven-surefire-plugin</artifactId>
            <configuration>
                <properties>
                    <includeTags>junit5</includeTags>
                </properties>
            </configuration>
        </plugin>
    </plugins>
</build>

3.5. Новые аннотации для запуска тестов

@RunWith использовался для интеграции контекста теста с другими фреймворками или для изменения общего потока выполнения тестов в JUnit 4.

В JUnit 5 теперь мы можем использовать @ExtendWith аннотации для обеспечения аналогичной функциональности.

В качестве примера, чтобы использовать функции Spring в JUnit 4:

@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(
  {"/app-config.xml", "/test-data-access-config.xml"})
public class SpringExtensionTest {
    /*...*/
}

Теперь в JUnit 5 это простое расширение:

@ExtendWith(SpringExtension.class)
@ContextConfiguration(
  { "/app-config.xml", "/test-data-access-config.xml" })
public class SpringExtensionTest {
    /*...*/
}

3.6. Новые аннотации правил тестирования

В JUnit 4 аннотации @Rule и @ClassRule использовались для добавления специальных функций в тесты.

В JUnit 5. мы можем воспроизвести ту же логику, используя аннотацию @ExtendWith.

Например, скажем, у нас есть специальное правило в JUnit 4 для записи трассировки журнала до и после теста:

public class TraceUnitTestRule implements TestRule {
 
    @Override
    public Statement apply(Statement base, Description description) {
        return new Statement() {
            @Override
            public void evaluate() throws Throwable {
                // Before and after an evaluation tracing here 
                ...
            }
        };
    }
}

И мы реализуем его в наборе тестов:

@Rule
public TraceUnitTestRule traceRuleTests = new TraceUnitTestRule();

В JUnit 5, мы можем написать то же самое гораздо более интуитивным образом:

public class TraceUnitExtension implements AfterEachCallback, BeforeEachCallback {

    @Override
    public void beforeEach(TestExtensionContext context) throws Exception {
        // ...
    }

    @Override
    public void afterEach(TestExtensionContext context) throws Exception {
        // ...
    }
}

Используя интерфейсы AfterEachCallback и BeforeEachCallback JUnit 5, доступные в пакете org.junit.jupiter.api.extension, мы легко реализуем это правило в наборе тестов: ~ ~~

@RunWith(JUnitPlatform.class)
@ExtendWith(TraceUnitExtension.class)
public class RuleExampleTest {
 
    @Test
    public void whenTracingTests() {
        /*...*/
    }
}

3.7. JUnit 5 Vintage

JUnit Vintage помогает в миграции тестов JUnit, запуская тесты JUnit 3 или JUnit 4 в контексте JUnit 5.

Мы можем использовать его, импортировав JUnit Vintage Engine:

<dependency>
    <groupId>org.junit.vintage</groupId>
    <artifactId>junit-vintage-engine</artifactId>
    <version>${junit5.vintage.version}</version>
    <scope>test</scope>
</dependency>

4. Заключение

«Как мы видели в этой статье, JUnit 5 представляет собой модульную и современную версию платформы JUnit 4. Мы представили основные различия между этими двумя версиями и намекнули, как перейти с одной на другую.

Полную реализацию этого руководства можно найти на GitHub.

«Переход с JUnit 4 на JUnit 5»