JUnit: что это, ключевые понятия и как работает

Что такое JUnit?

JUnit — это фреймворк с открытым исходным кодом для написания и запуска повторяемых модульных тестов на языке Java и Kotlin. Он входит в экосистему xUnit — семейства фреймворков, основанных на архитектуре Kent Beck и Erich Gamma, и является стандартным инструментом тестирования в Android Studio и IntelliJ IDEA.

Основная задача JUnit — изолировать небольшой фрагмент кода (метод, класс) и проверить его поведение в контролируемых условиях. Тесты пишутся в виде обычных Java/Kotlin классов с аннотациями, а фреймворк берёт на себя обнаружение тестов, управление их жизненным циклом и сбор статистики выполнения.

Первая версия JUnit появилась в 1997 году и радикально изменила подход к разработке, популяризировав практики Test-Driven Development (TDD). Сегодня JUnit 5 (Jupiter) — актуальная версия, полностью переработанная под модульную архитектуру с поддержкой Java 8+ и расширений.

Как работает JUnit

Механизм выполнения JUnit основан на паттерне Test Runner, который сканирует classpath, находит методы с аннотацией @Test, создаёт экземпляр тестового класса и запускает методы в определённом порядке. Test Runner управляет жизненным циклом: вызов BeforeAll → BeforeEach → Test → AfterEach → AfterAll.

Жизненный цикл тестового класса

JUnit оборачивает каждый тестовый метод в отдельный экземпляр класса, что гарантирует изоляцию между тестами. Это означает, что поля класса не сохраняют состояние между разными @Test-методами — каждый тест начинается с чистого объекта.

Базовая структура теста

Простейший тест на JUnit выглядит как метод с аннотацией @Test, внутри которого вызывается тестируемый код и проверяется результат через assertion. Если assertion не проходит — тест считается упавшим, и JUnit сообщает об ошибке.

@Test
void additionShouldReturnCorrectSum() {
    var calculator = new Calculator();
    var result = calculator.add(2, 3);
    assertEquals(5, result);
}

Test Runner автоматически находит такой метод, запускает его и сообщает результат. Если метод не выбрасывает исключения — тест пройден (green). Если assertion не срабатывает — тест падает (red).

Аннотации JUnit: жизненный цикл теста

Аннотации JUnit определяют, когда и как должен выполняться тестовый код. В JUnit 5 аннотации находятся в пакете org.junit.jupiter.api и покрывают все этапы: подготовку данных, выполнение теста, очистку ресурсов.

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

Рассмотрим полный тестовый класс с корректным жизненным циклом. Метод setUp создаёт свежий экземпляр Calculator перед каждым тестом, а tearDown освобождает ресурсы — например, закрывает файловые дескрипторы или соединения с базой данных.

class CalculatorTest {

    private Calculator calculator;

    @BeforeEach
    void setUp() {
        calculator = new Calculator();
    }

    @Test
    void subtractionShouldReturnCorrectResult() {
        int result = calculator.subtract(10, 4);
        assertEquals(6, result);
    }

    @AfterEach
    void tearDown() {
        calculator.reset();
    }
}

Assertions: проверка результатов в JUnit

Assertions — это статические методы, которые сравнивают фактический результат с ожидаемым и выбрасывают исключение при несовпадении. JUnit 5 предлагает класс org.junit.jupiter.api.Assertions с более чем 25 методами для разных сценариев проверки — от простого сравнения значений до проверки таймаутов и групповых assertion.

• assertEquals(expected, actual) — проверяет равенство через equals().
• assertTrue(condition) — проверяет, что условие истинно.
• assertFalse(condition) — проверяет, что условие ложно.
• assertNotNull(object) — проверяет, что объект не null.
• assertNull(object) — проверяет, что объект равен null.
• assertThrows(exception, executable) — проверяет, что код выбрасывает указанное исключение.
• assertAll(executables) — группирует несколько проверок и выполняет все, не останавливаясь на первой ошибке.

assertThrows для проверки исключений

Отдельного внимания заслуживает метод assertThrows, который позволяет проверить, что код корректно обрабатывает ошибочные ситуации — деление на ноль, передачу null, превышение лимитов.

@Test
void divisionByZeroShouldThrowException() {
    Calculator calc = new Calculator();

    ArithmeticException exception = assertThrows(
        ArithmeticException.class,
        () -> calc.divide(10, 0)
    );

    assertEquals("Cannot divide by zero", exception.getMessage());
}

Parameterized тесты в JUnit

Parameterized тесты позволяют запустить один и тот же тестовый метод с разными наборами аргументов. В JUnit 5 для этого используется аннотация @ParameterizedTest в комбинации с источником данных — @ValueSource, @CsvSource, @MethodSource или @EnumSource.

Этот подход радикально сокращает дублирование кода: вместо десяти одинаковых тестов для разных значений пишется один параметризованный метод. По данным Google Testing Blog, параметризация снижает объём тестового кода на 40–60% без потери покрытия.

Пример с CsvSource

Аннотация @CsvSource передаёт в тест несколько строк с разделителем-запятой. Каждая строка соответствует одному запуску теста. JUnit автоматически преобразует строковые значения в нужные типы: int, long, String и другие.

@ParameterizedTest
@CsvSource({
    "1,    1,   2",
    "2,    3,   5",
    "10,  20,  30",
    "-1,   1,   0"
})
void additionWithMultipleInputs(int a, int b, int expected) {
    assertEquals(expected, a + b);
}

MethodSource для сложных объектов

Когда входные данные сложнее простых чисел или строк, используется @MethodSource. Он ссылается на статический метод, который возвращает Stream аргументов — например, Stream of Arguments или Stream of User объектов для тестирования DAO-слоя.

Интеграция JUnit с Android-проектами

В Android-разработке JUnit используется в паре с AndroidX Test, который предоставляет расширения для тестирования Activity, Content Provider и других компонентов Android. JUnit отвечает за модульные тесты (unit tests), выполняемые на JVM без эмулятора, а AndroidX Test — за инструментальные тесты на устройстве.

Настройка Gradle

Для подключения JUnit 5 в Android-проект достаточно добавить зависимость org.junit.jupiter:junit-jupiter в build.gradle уровня модуля. Gradle-плагин AGP поддерживает запуск JUnit 5 тестов на JVM через стандартный Test Runner.

// build.gradle.kts
android {
    testOptions {
        unitTests.isIncludeAndroidResources = true
    }
}

dependencies {
    testImplementation("org.junit.jupiter:junit-jupiter:5.11.0")
    testImplementation("androidx.test:core-ktx:1.6.1")
}

Тестирование ViewModel с JUnit

На практике JUnit чаще всего применяется для тестирования ViewModel и репозиториев — слоёв, которые не требуют Android-контекста или эмулятора. Такой тест выполняется за миллисекунды и может быть запущен сотни раз без потери времени.

• ViewModel — проверка состояний: loading, success, error.
• Repository — проверка маппинга данных и обработки ошибок.
• UseCase — проверка бизнес-логики с моками зависимостей.

JUnit 4 vs JUnit 5: ключевые отличия

JUnit 5 (Jupiter) — это не просто новая версия, а полностью переработанная платформа, разделённая на три модуля: JUnit Platform (запуск тестов на JVM), JUnit Jupiter (API для написания тестов) и JUnit Vintage (обратная совместимость с JUnit 4). Такая модульность позволяет подключать разные Test Engine — например, Spek для Kotlin или TestNG.

Миграция с JUnit 4 на JUnit 5 не требует переписывания всех тестов — достаточно подключить JUnit Vintage Engine, и старые тесты продолжат работать. Новые тесты рекомендуется писать на JUnit 5, чтобы использовать расширения, лямбды в assertions и встроенную поддержку параметризации.