Туториал по JUnit 5 — Аннотация @BeforeEach

Это продолжение туториала по JUnit 5. Введение опубликовано здесь.

Аннотация @BeforeEach используется для обозначения того, что аннотированный метод должен выполняться перед каждым методом @Test, @RepeatedTest, @ParameterizedTest, или @TestFactory в текущем классе.

Аннотация JUnit 5 @BeforeEach является одним из методов жизненного цикла и заменяет аннотацию @Before в JUnit 4.

По умолчанию тестовые методы будут выполняться в том же потоке, что и аннотированный @BeforeEach метод.

1. Использование @BeforeEach

• Добавьте аннотацию @BeforeEach к методу, как указано ниже:

@BeforeEach public void initEach(){      //test setup code }  @Test void succeedingTest() {     //test code and assertions }

• Аннотированный @BeforeEach метод НЕ ДОЛЖЕН быть статическим, иначе он вызовет ошибку времени выполнения.

@BeforeEach public static void initEach(){      //test setup code }  //Error   org.junit.platform.commons.JUnitException: @BeforeEach method 'public static void com.howtodoinjava.junit5.examples. JUnit5AnnotationsExample.initEach()' must not be static. at org.junit.jupiter.engine.descriptor. LifecycleMethodUtils.assertNonStatic(LifecycleMethodUtils.java:73)

@BeforeEach в родительском и дочернем классах

Метод @BeforeEach наследуется от родительских классов (или интерфейсов) до тех пор, пока они не скрыты или не  переопределены. 

Кроме того, каждый метод с аннотацией @Before из родительских классов (или интерфейсов) будет выполняться перед каждым методом с аннотацией @Before в дочерних классах.

2. Пример @BeforeEach

Мы использовали Calculator класс и добавили один метод add().

5 раз протестируем с помощью аннотации @RepeatedTest. Аннотация @RepeatedTest вызовет выполнение теста add() 5 раз.

Аннотированный @BeforeEach метод должен выполняться при каждом вызове тестового метода.

import org.junit.jupiter.api.Assertions; import org.junit.jupiter.api.BeforeAll; import org.junit.jupiter.api.BeforeEach; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.RepeatedTest; import org.junit.jupiter.api.RepetitionInfo; import org.junit.jupiter.api.Test; import org.junit.jupiter.api.TestInfo;  public class BeforeEachTest {      @DisplayName("Add operation test")     @RepeatedTest(5)     void addNumber(TestInfo testInfo, RepetitionInfo repetitionInfo) {          System.out.println("Running test -> " + repetitionInfo.getCurrentRepetition());         Assertions.assertEquals(2, Calculator.add(1, 1), "1 + 1 should equal 2");     }      @BeforeAll     public static void init(){         System.out.println("BeforeAll init() method called");     }      @BeforeEach     public void initEach(){         System.out.println("BeforeEach initEach() method called");     } }

Это класс калькулятора:

public class Calculator {     public int add(int a, int b) {         return a + b;     } }

Теперь выполните тест, и вы увидите вывод консоли ниже:

ВыходBeforeAll init() method called BeforeEach initEach() method called  BeforeEach initEach() method called Running test -> 1  BeforeEach initEach() method called Running test -> 2  BeforeEach initEach() method called Running test -> 3  BeforeEach initEach() method called Running test -> 4  BeforeEach initEach() method called Running test -> 5

Очевидно, что аннотированный @BeforeEach метод initEach() вызывается один раз при вызове тестового метода.

Хорошего изучения!!!

Скачать исходный код