Annotation Type CsvSource
-
@Target({ANNOTATION_TYPE,METHOD}) @Retention(RUNTIME) @Documented @API(status=EXPERIMENTAL, since="5.0") @ArgumentsSource(org.junit.jupiter.params.provider.CsvArgumentsProvider.class) public @interface CsvSource@CsvSourceis anArgumentsSourcewhich reads comma-separated values (CSV) from one or more supplied CSV lines.The supplied values will be provided as arguments to the annotated
@ParameterizedTestmethod.- Since:
- 5.0
- See Also:
CsvFileSource,ArgumentsSource,ParameterizedTest
-
-
Required Element Summary
Required Elements Modifier and Type Required Element Description java.lang.String[]valueThe CSV lines to use as the source of arguments; must not be empty.
-
Optional Element Summary
Optional Elements Modifier and Type Optional Element Description chardelimiterThe column delimiter character to use when reading the lines.java.lang.StringdelimiterStringThe column delimiter string to use when reading the lines.java.lang.StringemptyValueThe empty value to use when reading the lines.java.lang.String[]nullValuesA list of strings that should be interpreted asnullreferences.
-
-
-
Element Detail
-
value
java.lang.String[] value
The CSV lines to use as the source of arguments; must not be empty.Each value corresponds to a line in a CSV file and will be split using the specified
delimiter()ordelimiterString(). Any line beginning with a#symbol will be interpreted as a comment and will be ignored.
-
-
-
delimiter
char delimiter
The column delimiter character to use when reading the lines.This is an alternative to
delimiterString()and cannot be used in conjunction withdelimiterString().Defaults implicitly to
',', if neither delimiter attribute is explicitly set.- Default:
- '\u0000'
-
-
-
delimiterString
@API(status=EXPERIMENTAL, since="5.6") java.lang.String delimiterStringThe column delimiter string to use when reading the lines.This is an alternative to
delimiter()and cannot be used in conjunction withdelimiter().Defaults implicitly to
",", if neither delimiter attribute is explicitly set.- Since:
- 5.6
- Default:
- ""
-
-
-
emptyValue
@API(status=EXPERIMENTAL, since="5.5") java.lang.String emptyValueThe empty value to use when reading the lines.This value replaces quoted empty strings read from the input.
Defaults to
"".- Since:
- 5.5
- Default:
- ""
-
-
-
nullValues
@API(status=EXPERIMENTAL, since="5.6") java.lang.String[] nullValuesA list of strings that should be interpreted asnullreferences.For example, you may wish for certain values such as
"N/A"or"NIL"to be converted tonullreferences.Please note that unquoted empty values will always be converted to
nullreferences regardless of the value of thisnullValuesattribute; whereas, a quoted empty string will be treated as anemptyValue().Defaults to
{}.- Since:
- 5.6
- Default:
- {}
-
-