Junit 5でパラメトリックテストを実現
14489 ワード
Junit 5からパラメータ化テストのサポートを大幅に改善し、向上させた.次にJunit 5パラメータ化テストの方法を詳しく見てみましょう.
Junit 4に比べて、Junit 5フレームワークはテストプラットフォームに進化しています.そのコア構成も従来のJunitのjarパッケージから複数のモジュールからなるように変更された.本明細書で必要とされる依存モジュールは、次のとおりです. junit-jupiter-engine:Junitのコアテストエンジン junit-jupiter-params:パラメトリックテストを記述するために必要な依存パケット junit-platform-launcher:IDE(InteliJ/Eclipses)などの運転時に必要なイニシエータ また、MavenコマンドラインツールからJintを実行するには、junit-platform-surefire-providerパッケージの依存も必要です.
mavenのpom.xmlファイルに次のように追加してインストールします.
value sourceは最も簡単なパラメータソースであり,注釈により携帯する運転パラメータを直接指定することができる. String values: @ValueSource(strings = {“foo”, “bar”, “baz”}) Double values: @ValueSource(doubles = {1.5D, 2.2D, 3.0D}) Long values: @ValueSource(longs = {2L, 4L, 8L}) Integer values: @ValueSource(ints = {2, 4, 8})
サンプルコードは次のとおりです.
しゅつりょく
パラメータ値を指定したEnum列挙タイプから入力できるように、列挙パラメータソースを指定します.制約条件または正規一致を設定することで、入力パラメータをフィルタできます.
出力:
パラメータソースとして他のJavaメソッド関数を使用します.参照メソッドの戻り値は、Stream、Iterator、またはIterableである必要があります.
出力:
パラメータクラスをパラメータソースとして使用します.ここで参照するクラスはArgumentsProviderインタフェースを実装する必要があります.例は次のとおりです.
パラメータソースとしてcsvフォーマット(comma-separated-values)の注記を指定する
出力:
csvパラメータソースの使用に加えて、ここではcsvファイルをパラメータソースとして使用することもサポートされています.
仮定users.csvファイルには、次のcsv形式のデータが含まれています.
1,Selma 2,Lisa 3,Tim
コードの例は次のとおりです.
出力:
JUnit allows us to convert arguments to the target format we need in our tests.
There are two possible conversion types:
暗黙的変換
JUnitは、特にstringと一般的なデータ型の組み込みフォーマット変換をサポートしています.
以下はstring型との変換をサポートするタイプです.
Boolean Byte Character Short Integer Long Float Double Enum subclass Instant LocalDate LocalDateTime LocalTime OffsetTime OffsetDateTime Year YearMonth ZonedDateTime
明示的な変換
Junit 5では@ConvertWith(MyConverter.class)注記を用いてSimpleArgumentConverterを実現することができる.
コードの例:
出力:
コードは次のとおりです.
転載先:https://www.jianshu.com/p/477f2ded7ccc
導入と依存
Junit 4に比べて、Junit 5フレームワークはテストプラットフォームに進化しています.そのコア構成も従来のJunitのjarパッケージから複数のモジュールからなるように変更された.本明細書で必要とされる依存モジュールは、次のとおりです.
mavenのpom.xmlファイルに次のように追加してインストールします.
org.junit.jupiter
junit-jupiter-engine
5.2.0
test
org.junit.jupiter
junit-jupiter-params
5.2.0
test
org.junit.platform
junit-platform-launcher
1.2.0
org.apache.maven.plugins
maven-surefire-plugin
2.22
Junit 5パラメータソースの詳細
value source
value sourceは最も簡単なパラメータソースであり,注釈により携帯する運転パラメータを直接指定することができる.
サンプルコードは次のとおりです.
import static org.junit.jupiter.api.Assertions.assertEquals;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.ValueSource;
public class ValueSourcesExampleTest {
@ParameterizedTest
@ValueSource(ints = {2, 4, 8})
void testNumberShouldBeEven(int num) {
assertEquals(0, num % 2);
}
@ParameterizedTest
@ValueSource(strings = {"Radar", "Rotor", "Tenet", "Madam", "Racecar"})
void testStringShouldBePalindrome(String word) {
assertEquals(isPalindrome(word), true);
}
@ParameterizedTest
@ValueSource(doubles = {2.D, 4.D, 8.D})
void testDoubleNumberBeEven(double num) {
assertEquals(0, num % 2);
}
boolean isPalindrome(String word) {
return word.toLowerCase().equals(new StringBuffer(word.toLowerCase()).reverse().toString());
}
}
しゅつりょく
[INFO] -------------------------------------------------------
[INFO] T E S T S
[INFO] -------------------------------------------------------
[INFO] Running qiucao.learning.ParaTest
[INFO] Tests run: 11, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.155 s - in qiucao.learning.ParaTest
[INFO]
[INFO] Results:
[INFO]
[INFO] Tests run: 11, Failures: 0, Errors: 0, Skipped: 0
Enum Source
パラメータ値を指定したEnum列挙タイプから入力できるように、列挙パラメータソースを指定します.制約条件または正規一致を設定することで、入力パラメータをフィルタできます.
import static org.junit.jupiter.api.Assertions.assertFalse;
import static org.junit.jupiter.api.Assertions.assertTrue;
import java.util.EnumSet;
import java.util.concurrent.TimeUnit;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.EnumSource;
import org.junit.jupiter.params.provider.EnumSource.Mode;
public class EnumSourcesExampleTest {
@ParameterizedTest(name = "[{index}] TimeUnit: {arguments}")
@EnumSource(TimeUnit.class)
void testTimeUnitMinimumNanos(TimeUnit unit) {
assertTrue(unit.toMillis(2000000L) > 1);
}
@ParameterizedTest
@EnumSource(value = TimeUnit.class, names = {"SECONDS", "MINUTES"})
void testTimeUnitJustSecondsAndMinutes(TimeUnit unit) {
assertTrue(EnumSet.of(TimeUnit.SECONDS, TimeUnit.MINUTES).contains(unit));
assertFalse(EnumSet
.of(TimeUnit.DAYS, TimeUnit.HOURS, TimeUnit.MILLISECONDS, TimeUnit.NANOSECONDS,
TimeUnit.MICROSECONDS).contains(unit));
}
@ParameterizedTest
@EnumSource(value = TimeUnit.class, mode = Mode.EXCLUDE, names = {"SECONDS", "MINUTES"})
void testTimeUnitExcludingSecondsAndMinutes(TimeUnit unit) {
assertFalse(EnumSet.of(TimeUnit.SECONDS, TimeUnit.MINUTES).contains(unit));
assertTrue(EnumSet
.of(TimeUnit.DAYS, TimeUnit.HOURS, TimeUnit.MILLISECONDS, TimeUnit.NANOSECONDS,
TimeUnit.MICROSECONDS).contains(unit));
}
@ParameterizedTest
@EnumSource(value = TimeUnit.class, mode = Mode.MATCH_ALL, names = ".*SECONDS")
void testTimeUnitIncludingAllTypesOfSecond(TimeUnit unit) {
assertFalse(EnumSet.of(TimeUnit.DAYS, TimeUnit.HOURS, TimeUnit.MINUTES).contains(unit));
assertTrue(EnumSet
.of(TimeUnit.SECONDS, TimeUnit.MILLISECONDS, TimeUnit.NANOSECONDS,
TimeUnit.MICROSECONDS).contains(unit));
}
}
出力:
[INFO] -------------------------------------------------------
[INFO] T E S T S
[INFO] -------------------------------------------------------
[INFO] Running qiucao.learning.ParaTest
[INFO] Tests run: 18, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.206 s - in qiucao.learning.ParaTest
[INFO]
[INFO] Results:
[INFO]
[INFO] Tests run: 18, Failures: 0, Errors: 0, Skipped: 0
Method Source
パラメータソースとして他のJavaメソッド関数を使用します.参照メソッドの戻り値は、Stream、Iterator、またはIterableである必要があります.
import static org.junit.jupiter.api.Assertions.assertAll;
import static org.junit.jupiter.api.Assertions.assertNotNull;
import static org.junit.jupiter.api.Assertions.assertTrue;
import java.util.stream.IntStream;
import java.util.stream.Stream;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.Arguments;
import org.junit.jupiter.params.provider.MethodSource;
public class MethodSourceExampleTest {
@ParameterizedTest
@MethodSource("stringGenerator")
void shouldNotBeNullString(String arg){
assertNotNull(arg);
}
@ParameterizedTest
@MethodSource("intGenerator")
void shouldBeNumberWithinRange(int arg){
assertAll(
() -> assertTrue(arg > 0),
() -> assertTrue(arg <= 10)
);
}
@ParameterizedTest(name = "[{index}] user with id: {0} and name: {1}")
@MethodSource("userGenerator")
void shouldUserWithIdAndName(long id, String name){
assertNotNull(id);
assertNotNull(name);
}
static Stream stringGenerator(){
return Stream.of("hello", "world", "let's", "test");
}
static IntStream intGenerator() {
return IntStream.range(1,10);
}
static Stream userGenerator(){
return Stream.of(Arguments.of(1L, "Sally"), Arguments.of(2L, "Terry"), Arguments.of(3L, "Fred"));
}
}
出力:
[INFO] -------------------------------------------------------
[INFO] T E S T S
[INFO] -------------------------------------------------------
[INFO] Running qiucao.learning.ParaTest
[INFO] Tests run: 16, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.191 s - in qiucao.learning.ParaTest
[INFO]
[INFO] Results:
[INFO]
[INFO] Tests run: 16, Failures: 0, Errors: 0, Skipped: 0
Argument Source
パラメータクラスをパラメータソースとして使用します.ここで参照するクラスはArgumentsProviderインタフェースを実装する必要があります.例は次のとおりです.
import static org.junit.jupiter.api.Assertions.assertFalse;
import static org.junit.jupiter.api.Assertions.assertTrue;
import java.util.stream.Stream;
import org.junit.jupiter.api.extension.ExtensionContext;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.Arguments;
import org.junit.jupiter.params.provider.ArgumentsProvider;
import org.junit.jupiter.params.provider.ArgumentsSource;
public class ArgumentsSourceExampleTest {
@ParameterizedTest
@ArgumentsSource(CustomArgumentsGenerator.class)
void testGeneratedArguments(double number) throws Exception {
assertFalse(number == 0.D);
assertTrue(number > 0);
assertTrue(number < 1);
}
static class CustomArgumentsGenerator implements ArgumentsProvider {
@Override
public Stream extends Arguments> provideArguments(ExtensionContext context) {
return Stream.of(Math.random(), Math.random(), Math.random(), Math.random(), Math.random())
.map(Arguments::of);
}
}
}
CSV Source
パラメータソースとしてcsvフォーマット(comma-separated-values)の注記を指定する
import static org.junit.jupiter.api.Assertions.assertTrue;
import java.util.HashMap;
import java.util.Map;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.CsvSource;
public class CsvSourceExampleTest {
Map idToUsername = new HashMap<>();
{
idToUsername.put(1L, "Selma");
idToUsername.put(2L, "Lisa");
idToUsername.put(3L, "Tim");
}
@ParameterizedTest
@CsvSource({"1,Selma", "2,Lisa", "3,Tim"})
void testUsersFromCsv(long id, String name) {
assertTrue(idToUsername.containsKey(id));
assertTrue(idToUsername.get(id).equals(name));
}
}
出力:
[INFO] -------------------------------------------------------
[INFO] T E S T S
[INFO] -------------------------------------------------------
[INFO] Running qiucao.learning.ParaTest
[INFO] Tests run: 3, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.164 s - in qiucao.learning.ParaTest
[INFO]
[INFO] Results:
[INFO]
[INFO] Tests run: 3, Failures: 0, Errors: 0, Skipped: 0
CSV File Source
csvパラメータソースの使用に加えて、ここではcsvファイルをパラメータソースとして使用することもサポートされています.
仮定users.csvファイルには、次のcsv形式のデータが含まれています.
1,Selma 2,Lisa 3,Tim
コードの例は次のとおりです.
import static org.junit.jupiter.api.Assertions.assertTrue;
import java.util.HashMap;
import java.util.Map;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.CsvFileSource;
import org.junit.jupiter.params.provider.CsvSource;
public class CsvFileSourceExampleTest {
Map idToUsername = new HashMap<>();
{
idToUsername.put(1L, "Selma");
idToUsername.put(2L, "Lisa");
idToUsername.put(3L, "Tim");
}
@ParameterizedTest
@CsvFileSource(resources = "/users.csv")
void testUsersFromCsv(long id, String name) {
assertTrue(idToUsername.containsKey(id));
assertTrue(idToUsername.get(id).equals(name));
}
}
出力:
[INFO] -------------------------------------------------------
[INFO] T E S T S
[INFO] -------------------------------------------------------
[INFO] Running qiucao.learning.ParaTest
[INFO] Tests run: 3, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.199 s - in qiucao.learning.ParaTest
[INFO]
[INFO] Results:
[INFO]
[INFO] Tests run: 3, Failures: 0, Errors: 0, Skipped: 0
パラメータへんかん
JUnit allows us to convert arguments to the target format we need in our tests.
There are two possible conversion types:
暗黙的変換
JUnitは、特にstringと一般的なデータ型の組み込みフォーマット変換をサポートしています.
以下はstring型との変換をサポートするタイプです.
Boolean Byte Character Short Integer Long Float Double Enum subclass Instant LocalDate LocalDateTime LocalTime OffsetTime OffsetDateTime Year YearMonth ZonedDateTime
明示的な変換
Junit 5では@ConvertWith(MyConverter.class)注記を用いてSimpleArgumentConverterを実現することができる.
コードの例:
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertNotNull;
import static org.junit.jupiter.api.Assertions.assertTrue;
import java.time.LocalDate;
import java.time.Month;
import java.util.UUID;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.converter.ConvertWith;
import org.junit.jupiter.params.converter.SimpleArgumentConverter;
import org.junit.jupiter.params.provider.ValueSource;
public class ArgumentsConversionExampleTest {
@ParameterizedTest
@ValueSource(strings = "2017-07-11")
void testImplicitArgumentConversion(LocalDate date) throws Exception {
assertTrue(date.getYear() == 2017);
assertTrue(date.getMonth().equals(Month.JULY));
assertTrue(date.getDayOfMonth() == 11);
}
@ParameterizedTest
@ValueSource(strings = "B4627B3B-ACC4-44F6-A2EB-FCC94DAB79A5")
void testImplicitArgumentConversion(@ConvertWith(ToUUIDArgumentConverter.class) UUID uuid)
throws Exception {
assertNotNull(uuid);
assertTrue(uuid.getLeastSignificantBits() == -6706989278516512347L);
}
static class ToUUIDArgumentConverter extends SimpleArgumentConverter {
@Override
protected Object convert(Object source, Class> targetType) {
assertEquals(UUID.class, targetType, "may only convert to UUID");
return UUID.fromString(String.valueOf(source));
}
}
}
出力:
[INFO] -------------------------------------------------------
[INFO] T E S T S
[INFO] -------------------------------------------------------
[INFO] Running qiucao.learning.ParaTest
[INFO] Tests run: 2, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.487 s - in qiucao.learning.ParaTest
[INFO]
[INFO] Results:
[INFO]
[INFO] Tests run: 2, Failures: 0, Errors: 0, Skipped: 0
補足対照:JUnit 4におけるパラメトリック試験方法
コードは次のとおりです.
@RunWith(Parameterized.class)
public class ParameterizedTest {
@Parameters(name = "Run #{index}: {0}^2={1}")
public static Iterable
転載先:https://www.jianshu.com/p/477f2ded7ccc