Как происходит передача данных в JUnit

Механизм передачи данных в JUnit

В JUnit передача данных между тестами, методами и параметрами является фундаментальным аспектом фреймворка. В отличие от многих других тестовых сред, JUnit сознательно ограничивает прямую передачу состояния между тестовыми методами, чтобы обеспечить их изоляцию и независимость. Однако существует несколько четко определенных механизмов для передачи данных.

Основные принципы передачи данных

1. Изоляция тестовых методов: Каждый тестовый метод выполняется в отдельном экземпляре тестового класса.
2. Жизненный цикл теста: Данные передаются через хуки жизненного цикла (@BeforeEach, @AfterEach).
3. Параметризация: Прямая передача входных данных в тестовые методы.

Ключевые механизмы передачи данных

1. Параметризованные тесты (JUnit 5)

Наиболее прямой способ передачи данных — использование аннотации @ParameterizedTest с источниками данных.

import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.ValueSource;
import org.junit.jupiter.params.provider.CsvSource;

class ParameterizedExampleTest {
    
    @ParameterizedTest
    @ValueSource(strings = {"data1", "data2", "data3"})
    void testWithValueSource(String data) {
        // Каждый тест получает свое значение data
        System.out.println("Testing with: " + data);
    }
    
    @ParameterizedTest
    @CsvSource({"1, 'John'", "2, 'Jane'", "3, 'Bob'"})
    void testWithCsvSource(int id, String name) {
        // Тест получает пары значений
        System.out.println("ID: " + id + ", Name: " + name);
    }
}

2. Источники данных (Data Providers)

JUnit 5 предоставляет различные источники данных через аннотации:

• @ValueSource: Простые значения (строки, числа)
• @CsvSource: CSV-форматированные данные
• @MethodSource: Данные из методов
• @CsvFileSource: Данные из CSV-файлов
• @ArgumentsSource: Кастомные источники данных

import org.junit.jupiter.params.provider.Arguments;
import org.junit.jupiter.params.provider.MethodSource;
import java.util.stream.Stream;

class MethodSourceTest {
    
    @ParameterizedTest
    @MethodSource("provideTestData")
    void testWithMethodSource(int input, String expected) {
        // Тест получает данные из метода provideTestData
        System.out.println("Input: " + input + ", Expected: " + expected);
    }
    
    private static Stream<Arguments> provideTestData() {
        return Stream.of(
            Arguments.of(1, "one"),
            Arguments.of(2, "two"),
            Arguments.of(3, "three")
        );
    }
}

3. Передача через поля класса (с ограничениями)

Хотя каждый тестовый метод создает новый экземпляр класса, можно использовать статические поля или специальные расширения:

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.TestInstance;

@TestInstance(TestInstance.Lifecycle.PER_CLASS)
class SharedStateTest {
    // Общее состояние для всех тестов в классе
    private int sharedCounter = 0;
    
    @Test
    void test1() {
        sharedCounter++;
        System.out.println("Counter in test1: " + sharedCounter);
    }
    
    @Test
    void test2() {
        sharedCounter++;
        System.out.println("Counter in test2: " + sharedCounter);
    }
}

4. Передача через хуки жизненного цикла

Методы с аннотациями @BeforeEach и @AfterEach могут подготавливать и очищать данные:

import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;

class LifecycleTest {
    private String testData;
    
    @BeforeEach
    void setUp() {
        // Подготовка данных перед каждым тестом
        testData = "prepared-data";
    }
    
    @Test
    void testUsingPreparedData() {
        System.out.println("Using data: " + testData);
    }
}

5. Расширения (Extensions) для сложных сценариев

Для продвинутой передачи данных можно использовать расширения JUnit 5:

import org.junit.jupiter.api.extension.ExtendWith;
import org.junit.jupiter.api.extension.ExtensionContext;
import org.junit.jupiter.api.extension.ParameterResolver;

class DataResolverExtension implements ParameterResolver {
    @Override
    public boolean supportsParameter(ParameterContext parameterContext, 
                                   ExtensionContext extensionContext) {
        return parameterContext.getParameter().getType() == String.class;
    }
    
    @Override
    public Object resolveParameter(ParameterContext parameterContext, 
                                 ExtensionContext extensionContext) {
        return "resolved-data-from-extension";
    }
}

@ExtendWith(DataResolverExtension.class)
class ExtensionTest {
    @Test
    void testWithInjectedParameter(String injectedData) {
        System.out.println("Injected data: " + injectedData);
    }
}

Важные ограничения и лучшие практики

• Нет прямой передачи между тестами: JUnit намеренно не позволяет тестам делиться состоянием напрямую
• Идемпотентность: Каждый тест должен быть независимым и воспроизводимым
• Параллельное выполнение: Изоляция данных критична для параллельного запуска тестов
• Чистота данных: Данные должны очищаться после каждого теста для предотвращения side effects

Сравнение с другими фреймворками

В отличие от TestNG, где есть аннотация @DataProvider с более богатыми возможностями, JUnit использует более декларативный подход. В JUnit 5 механизм параметризации был значительно улучшен по сравнению с JUnit 4, где использовались @RunWith(Parameterized.class) и конструкторы.

Ключевой вывод: В JUnit передача данных происходит преимущественно через параметризацию и хуки жизненного цикла, что обеспечивает чистоту, изоляцию и предсказуемость тестов. Для сложных сценариев используются расширения, но основная философия остается неизменной — тесты должны быть максимально независимыми друг от друга.