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

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

Аннотация JUnit 5 @AfterAll является заменой аннотации @AfterClass в JUnit 4. Она используется как метод очистки для тестового класса.

@AfterAll используется для обозначения того, что аннотированный метод должен быть выполнен после всех тестов в текущем тестовом классе.

Обратите внимание, что для выполнения метода после каждого теста мы можем использовать аннотацию @AfterEach.

1. Аннотация @AfterAll

Аннотируйте метод аннотацией @AfterAll, как в данном примере:

@AfterAll
public static void cleanUp(){
    System.out.println("After All cleanUp() method called");
}

Пожалуйста, помните, что:

• Методы, аннотированные @AfterAll, должны иметь возвращаемый тип void, но не должны быть private. 

• Методы, аннотированные @AfterAll, могут опционально объявлять параметры, которые должны быть разрешены ParameterResolvers.

• Методы, аннотированные @AfterAll, наследуются от суперклассов, если они не скрыты или не  переопределены. Кроме того,  @AfterAll методы из суперклассов будут выполняться перед  @AfterAll методами в подклассах.

• Метод, аннотированный @AfterAll должен быть статическим, в противном случае он будет выдавать ошибки во время выполнения.

Annotated method must be a static method

org.junit.platform.commons.JUnitException: @AfterAll method 'public void com.howtodoinjava.junit5.examples.JUnit5AnnotationsExample.cleanUp()' must be static.
	at org.junit.jupiter.engine.descriptor.LifecycleMethodUtils.assertStatic(LifecycleMethodUtils.java:66)
	at org.junit.jupiter.engine.descriptor.LifecycleMethodUtils.lambda$findAfterAllMethods$1(LifecycleMethodUtils.java:48)
	at java.util.ArrayList.forEach(ArrayList.java:1249)
	at java.util.Collections$UnmodifiableCollection.forEach(Collections.java:1080)
	at org.junit.jupiter.engine.descriptor.LifecycleMethodUtils.findAfterAllMethods(LifecycleMethodUtils.java:48)

2. Пример аннотации @AfterAll

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

5 раз запустим метод add помощью аннотации @RepeatedTest. Эта аннотация приведет к тому, что addтест будет запущен 5 раз. Но метод, аннотированный @AfterAll, нужно вызывать только один раз.

AfterAnnotationsTest.java

package com.howtodoinjava.junit5.examples;
 
import org.junit.jupiter.api.AfterAll;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.Assertions;
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;
import org.junit.platform.runner.JUnitPlatform;
import org.junit.runner.RunWith;
 
@RunWith(JUnitPlatform.class)
public class AfterAnnotationsTest {
 
    @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");
    }
     
    @AfterAll
    public static void cleanUp(){
        System.out.println("After All cleanUp() method called");
    }
     
    @AfterEach
    public void cleanUpEach(){
        System.out.println("After Each cleanUpEach() method called");
    }
}

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

Calculator.java

package com.howtodoinjava.junit5.examples;
 
public class Calculator 
{
    public int add(int a, int b) {
        return a + b;
    }
}

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

Running test -> 1
After Each cleanUpEach() method called
 
Running test -> 2
After Each cleanUpEach() method called
 
Running test -> 3
After Each cleanUpEach() method called
 
Running test -> 4
After Each cleanUpEach() method called
 
Running test -> 5
After Each cleanUpEach() method called
 
After All cleanUp() method called

Понятно, что аннотированный @AfterAll,метод cleanUp() вызывается только один раз.

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

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