Это последняя статья из нашей серии о внедрение зависимостей и тестировании в JUnit 5. В ней мы поговорим о параметризованных тестах.
3. Параметризованные тесты
Параметризованные тесты позволяют проводить тест несколько раз с разными аргументами. Главное преимущество в том, что можно написать один тест и проводить тестирование с рядом различных аргументов. Такие тесты будут безопаснее, и с их помощью можно проверять различные вводные данные. Методы аннотируются с помощью @ParameterizedTest. Необходимо декларировать как минимум один источник, который предоставляет аргументы для каждого вызова и затем использует эти аргументы в тестовом методе.@ValueSource — это самый простой из возможных источников. Необходимо указать единый массив литеральных значений для предоставления одного аргумента на каждый вызов параметризованного теста. Использование этой аннотации показано в Примере 4 (Listing 4). Сценарий теста предполагает проверку числа слов в нескольких данных предложениях, данных в качестве параметров.
В примере выше мы делаем следующее:
-
Отмечаем тест как параметризованный, используя соответствующую аннотацию (1).
-
Затем указываем значения, передаваемые в качестве аргумента тестового метода (2). Тестовый методы выполняется дважды, по одному разу для каждого из аргументов, предоставленных с помощью аннотации @ValueSource.
В Примере 5 (Listing 5) показано использование аннотации @EnumSource для проверки числа слов в данных предложениях, предоставленных как экземпляры enum.
В приведенном выше примере представлен один параметризованный тест. Он работает следующим образом:
-
Тест получает в качестве параметров CSV-файл, указанный в аннотации @CsvSource (1). Этот тест выполняется три раза, по одному для каждой строки CSV-файла.
-
Строка CSV-файла анализируется, и первое значение присваивается параметру expected, а второе значение присваивается параметру sentence.
В Примере 6 (Listing 6) показано использование аннотации @CsvFileSource, а в Примере 7 (Listing 7) показано содержимое файла word_counter.csv на classpath. Сценарий теста предполагает проверку числа слов в нескольких данных предложениях, данных в качестве параметров, на этот раз в формате CSV, имеющим CSV-файл в качестве ресурса для ввода данных.
В приведенном выше примере представлен один параметризованный тест. В качестве параметров он получает параметры, содержащиеся в файле, указанном в аннотации @CsvFileSource (1). Этот тест выполняется три раза, по одному для каждой строки CSV-файла. Строка CSV-файла анализируется, и первое значение присваивается параметру expected, а второе значение присваивается параметру sentence.
Заключение
В этой серии статей рассмотрены новые возможности предоставления параметров для модульного тестирования в JUnit 5 с помощью внедрения зависимостей. Мы показали, как это делать эффективно с помощью различных распознавателей параметров (TestInfoParameterResolver, TestReporterParameterResolver, RepetitionInfoParameterResolver). Кроме того, показано, как писать повторяющиеся и параметризованные тесты (аннотации @RepeatedTest и @ParameterizedTest).
Автор Catalin Tudose, Java and Web Technologies Expert