[!quote] Definition

@ParameterizedTest is used to signal that the annotated method is a parameterized test method. ^definition

@ArgumentsProvider

[!quote] @ParameterizedTest methods must specify at least one ArgumentsProvider via @ArgumentsSource or a corresponding composed annotation(e.g., @ValueSource, @CsvSource, etc.). The provider is responsible for providing a Stream of Arguments that will be used to invoke the parameterized test method.

통상적으로 @ArgumentProvider 인터페이스의 구현체를 준비하고, @ArgumentSource 어노테이션으로 테스트 스위트에 매핑하는 것이 매개변수를 가진 테스트의 본질이다. [^arguments-provider]

ArgumentProvider 인터페이스는 Stream<? extends Arguments> provideArguments(ExtensionContext context) 메서드를 구현해야 하는데, 그러려면 반환형에 사용되는 Arguments에 대해 알아야 한다.

[!info] org.junit.jupiter.params.provider.Arguments는 단순히 Object[]를 반환하는 것이 목적이다. 직접 get에 매핑될 람다를 전달하거나, of, arguments 같은 팩토리 메서드를 활용하면 된다.

[!example]

다음은 인자의 전달 방식을 확인할 수 있는 간단한 학습 테스트이다. MyArgumentsProvider를 통해 ("a", "b"), ("c", "d") 케이스가 전달된다.

static class MyArgumentsProvider implements ArgumentsProvider {
 @Override
 public Stream<Arguments> provideArguments(ExtensionContext context) {
  return Stream.<Arguments>builder()
    .add(Arguments.of("a", "b"))
    .add(() -> List.of("c", "d").toArray())
    .build();
 }
}

@ParameterizedTest
@ArgumentsSource(MyArgumentsProvider.class)
void parameter_withProvider(String s1, String s2) {
    // 1: s1 = "a", s2 = "b"
    // 2: s1 = "c", s2 = "d"
 assertThat(s1).isIn("a", "c");
 assertThat(s2).isIn("b", "d");
}

[!example]

후처리가 필요하다면 ArgumentConverter를 활용할 수 있다. 다음은 전달받은 문자열의 첫 번째 문자를 대문자 char로 변환하는 예제이다.

@ParameterizedTest
@ArgumentsSource(MyArgumentsProvider.class)
void parameter_withProvider_andConverter(
  @ConvertWith(ToUpperChar.class) char c1,
  @ConvertWith(ToUpperChar.class) char c2
) {
 // previous test fails
 // Expecting actual: 'A' to be in: ["a", "c"]
 // Expecting actual: 'B' to be in: ["b", "d"]

 // convert String "s" to uppercase char 'S'
 assertThat(List.of(c1, c2)).satisfiesAnyOf(
   actual -> assertThat(actual).isEqualTo(List.of('A', 'B')),
   actual -> assertThat(actual).isEqualTo(List.of('C', 'D')));
}

static class ToUpperChar implements ArgumentConverter {
 @Override
 public Character convert(Object source, ParameterContext context) throws ArgumentConversionException {
  char c = String.valueOf(source).charAt(0);
  return Character.toUpperCase(c);
 }
}

[!caution] IntelliJ의 테스트 결과를 나타내는 실행 뷰에서는 두 케이스 모두 ArgumentsSource 값을 기준으로 출력된다. ArgumentConverter를 사용한다면 실제 메서드에 전달된 값과 달라질 수 있다는 점에 유의하자.