«1. Обзор

JUnit 5 предоставляет несколько методов регистрации расширений. Обзор некоторых из этих методов см. в нашем Руководстве по расширениям JUnit 5.

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

2. @RegisterExtension

Мы можем применить эту аннотацию к полям в тестовых классах. Одним из преимуществ этого метода является то, что мы можем напрямую обращаться к расширению как к объекту в тестовом контенте.

JUnit будет вызывать методы расширения на соответствующих этапах.

Например, если расширение реализует BeforeEachCallback, JUnit вызовет соответствующие методы интерфейса перед выполнением тестового метода.

3. Использование @RegisterExtension со статическими полями

При использовании со статическими полями JUnit будет применять методы этого расширения после применения расширений на основе @ExtendWith на уровне класса.

Кроме того, JUnit будет вызывать обратные вызовы расширения как на уровне класса, так и на уровне метода.

Например, в следующем расширении представлены реализации как beforeAll, так и beforeEach: 

public class LoggingExtension implements 
  BeforeAllCallback, BeforeEachCallback {

    // logger, constructor etc

    @Override
    public void beforeAll(ExtensionContext extensionContext) 
      throws Exception {
        logger.info("Type {} In beforeAll : {}", 
          type, extensionContext.getDisplayName());
    }

    @Override
    public void beforeEach(ExtensionContext extensionContext) throws Exception {
        logger.info("Type {} In beforeEach : {}",
          type, extensionContext.getDisplayName());
    }

    public String getType() {
        return type;
    }
}

Применим это расширение к статическому полю теста: 

public class RegisterExtensionTest {

    @RegisterExtension
    static LoggingExtension staticExtension = new LoggingExtension("static version");

    @Test
    public void demoTest() {
        // assertions
    }
}

В выходных данных отображаются сообщения от обоих и методы beforeEach: 

Type static version In beforeAll : RegisterExtensionTest
Type static version In beforeEach : demoTest()

4. Использование @RegisterExtension с полями экземпляра

Если мы используем RegisterExtension с нестатическими полями, JUnit применит расширение только после обработки всех обратных вызовов TestInstancePostProcessor.

В этом случае JUnit будет игнорировать обратные вызовы уровня класса, такие как beforeAll.

В приведенном выше примере давайте удалим модификатор static из LoggingExtension: 

@RegisterExtension
LoggingExtension instanceLevelExtension = new LoggingExtension("instance version");

Теперь JUnit будет вызывать только метод beforeEach, как показано в выводе: 

Type instance version In beforeEach : demoTest()

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

В В этой статье мы сделали обзор программной регистрации расширений JUnit 5 с помощью @RegisterExtension.

Мы также рассмотрели разницу между применением расширения к статическим полям и полям экземпляра.

Как обычно, примеры кода можно найти в нашем репозитории Github.