Использование ParameterResolver в JUnit 5

Если вы занимались написанием тестов, то наверняка сталкивались с ситуацией, когда в тест нужно передать какой-либо объект. JUnit 5 предоставляет механизм Extensions, который позволяет значительно расширить функциональность тестов. Одной из наиболее полезных возможностей этого механизма является ParameterResolver, который позволяет автоматически внедрять зависимости (объекты) в тестовые методы.

В этой статье мы разберем, как работает ParameterResolver, какие функции он предоставляет и как его использовать для упрощения тестирования.

ParameterResolver — это интерфейс, который позволяет JUnit 5 передавать объекты (параметры) в тестовые методы во время выполнения тестов. Это особенно полезно, если вы хотите:

автоматически внедрять зависимости (например, настройки, моки или реальные объекты);
избежать явного создания этих объектов в каждом тесте;
повысить гибкость и читаемость тестовых методов.

JUnit 5 предоставляет встроенные объекты, которые можно внедрять в методы тестов:

TestInfo — предоставляет информацию о текущем тесте (например, его имя или аннотации);
TestReporter — позволяет публиковать дополнительную информацию о тесте;
и другие.

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

Принцип работы ParameterResolver включает три основных шага:

JUnit анализирует параметры тестового метода. Когда тест запускается, JUnit проверяет сигнатуру метода, чтобы определить, какие параметры указаны и какие типы данных ожидаются.
Ищется подходящий ParameterResolver. JUnit обращается к зарегистрированным расширениям (Extensions) и задает каждому вопрос: «Можешь ли ты предоставить параметр типа X?» Если ParameterResolver отвечает «true», он передает объект для использования в тесте.
Объект передается в тестовый метод. JUnit вызывает тестовый метод с параметрами, которые были подготовлены ParameterResolver.

Чтобы создать собственный ParameterResolver, нужно реализовать интерфейс ParameterResolver. Этот интерфейс требует реализации двух методов:

supportsParameter — проверяет, может ли resolver обработать переданный параметр. Если может, возвращает true.
resolveParameter — создает и возвращает объект, который будет передан в метод теста.

После этого ваш ParameterResolver нужно зарегистрировать, добавив аннотацию @ExtendWith к классу тестов.

Допустим, у нас есть класс User с полями, конструктором и методом toString. Мы хотим автоматизировать его создание для тестов.

public class MyExtension implements ParameterResolver { @Override public boolean supportsParameter(ParameterContext parameterContext, ExtensionContext extensionContext) { // Проверяем, является ли параметр объектом класса User return parameterContext.getParameter().getType() == User.class; } @Override public Object resolveParameter(ParameterContext parameterContext, ExtensionContext extensionContext) { // Логика создания объекта User return new User(); } } @ExtendWith(MyExtension.class) public class MyOneTest { @Test @DisplayName("Add user") void addUser(User user) { System.out.println("Это наш пользователь: " + user); } }

Вывод в консоль:

Это наш пользователь: userId=12e5bc2cc06bb5237533, firstName=Teddy, lastName=Haag, password=AFmikd65*, age=17, email=amal.hansen@yahoo.com, salary=20171, department=Legal

ParameterResolver в JUnit 5 — это не просто удобный инструмент, а мощный механизм автоматизации. Он:

Упрощает код тестов за счёт устранения явного создания объектов.
Улучшает читаемость и поддержку тестов.
Позволяет внедрять зависимости, ориентируясь на конкретные условия или контекст выполнения тестов.

Теперь вы знаете, как использовать ParameterResolver для упрощения написания тестов. Попробуйте внедрить его в своих проектах, чтобы превратить рутинное тестирование в удобный и понятный процесс. 😊

#testing #automatization #java #qa #qaengineer #qaинженер #Junit5

Использование ParameterResolver в JUnit 5

Что такое ParameterResolver?

Как работает ParameterResolver?

Создание пользовательского ParameterResolver

Пример: создание пользователя

Почему стоит использовать ParameterResolver?

Заключение