Java Academy · Les

Geparametriseerde tests met @CsvSource en @MethodSource

Voer dezelfde test uit met meerdere invoersets met @ParameterizedTest, @CsvSource en @MethodSource.

Les 1 van 413 stappen

Geparametriseerde tests met @CsvSource en @MethodSource is een gratis Java Academy-les op CoddyKit. Dit is les 1 van 4. Je kunt de volledige les hieronder gratis lezen en daarna in de browser praktisch oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is. Deze les maakt deel uit van het leertraject Java Academy. Je voortgang wordt gesynchroniseerd op het web en in de CoddyKit-app. De cursus Java Academy bevat in totaal 4 lessen.

Waarom geparametriseerde tests?

Door dezelfde testlogica met meerdere invoersets uit te voeren, ontdek je randgevallen zonder testmethoden te kopiëren en te plakken. JUnit 5 ondersteunt geparametriseerde tests standaard met @ParameterizedTest.

@ValueSource: Eenvoudige tests met één waarde

@ValueSource levert één parameter van een bepaald type. De test wordt eenmaal per waarde uitgevoerd.

@ParameterizedTest
@ValueSource(strings = {"", "  ", "\t"})
void blank_strings_are_rejected(String input) {
    assertThrows(IllegalArgumentException.class, () -> validator.validate(input));
}

@CsvSource: Meerdere parameters in de test

@CsvSource levert rijen met door komma's gescheiden waarden. Elke rij is één testaanroep. Gebruik enkele aanhalingstekens om komma's in tekenreekswaarden te beschermen.

@ParameterizedTest
@CsvSource({
    "Alice, 30, true",
    "Bob,   17, false",
    "Carol, 0,  false"
})
void test_adult_check(String name, int age, boolean expectedAdult) {
    User user = new User(name, age);
    assertEquals(expectedAdult, user.isAdult());
}

@CsvSource met delimiterString

Gebruik delimiterString voor scheidingstekens van meerdere tekens of wanneer je gegevens komma's bevatten. Gebruik nullValues om een markeringsreeks aan null te koppelen.

@ParameterizedTest
@CsvSource(value = {
    "Alice | 30 | ADMIN",
    "Bob   | 25 | USER"
}, delimiterString = "|")
void test_roles(String name, int age, String role) { ... }

@CsvFileSource: Externe gegevensbestanden

Laad testgegevens uit een CSV-bestand op het klassenpad. Dit is handig voor grote gegevensverzamelingen die je testcode onoverzichtelijk zouden maken.

@ParameterizedTest
@CsvFileSource(resources = "/test-data/users.csv", numLinesToSkip = 1)
void test_from_file(String name, int age, boolean expected) {
    assertEquals(expected, service.isEligible(name, age));
}

@MethodSource: Complexe parameters

@MethodSource roept een statische fabrieksmethode aan die een Stream<Arguments> teruggeeft. Elke Arguments.of() is één testaanroep. Gebruik dit voor complexe objecten.

@ParameterizedTest
@MethodSource("provideOrders")
void test_total_calculation(Order order, BigDecimal expected) {
    assertEquals(expected, orderService.calculateTotal(order));
}
static Stream<Arguments> provideOrders() {
    return Stream.of(
        Arguments.of(new Order(List.of(item(10), item(20))), BigDecimal.valueOf(30)),
        Arguments.of(new Order(List.of()),                   BigDecimal.ZERO)
    );
}

@EnumSource: Alle enumwaarden testen

@EnumSource voert de test eenmaal uit voor elke enumconstante. Gebruik mode en names om specifieke waarden op te nemen of uit te sluiten.

@ParameterizedTest
@EnumSource(value = UserStatus.class, mode = EnumSource.Mode.EXCLUDE, names = "DELETED")
void test_active_statuses(UserStatus status) {
    assertTrue(notificationService.shouldNotify(status));
}

@NullAndEmptySource

Een korte schrijfwijze voor het testen van null en lege tekenreeksinvoer. Combineer @ValueSource met @NullSource + @EmptySource, of gebruik de gecombineerde @NullAndEmptySource.

@ParameterizedTest
@NullAndEmptySource
void null_and_empty_are_invalid(String input) {
    assertFalse(validator.isValid(input));
}

Aangepaste weergavenamen

Gebruik name in @ParameterizedTest om de weergavenaam van de test op te maken. Plaatsaanduidingen: {index}, {0}, {1}, {arguments}.

@ParameterizedTest(name = "age={1} should be adult={2}")
@CsvSource({"Alice, 30, true", "Bob, 17, false"})
void test_adult(String name, int age, boolean expected) { ... }

Bronnen combineren met @ArgumentsSource

Implementeer ArgumentsProvider voor volledig aangepaste argumentgeneratie — dynamische gegevens uit databases, bestanden of API's.

public class UserArgumentsProvider implements ArgumentsProvider {
    public Stream<? extends Arguments> provideArguments(ExtensionContext ctx) {
        return Stream.of(
            Arguments.of(new User("Alice", 30)),
            Arguments.of(new User("Bob", 17))
        );
    }
}
@ParameterizedTest
@ArgumentsSource(UserArgumentsProvider.class)
void test_user(User user) { ... }

Geparametriseerde tests voor grenswaarden

Test grensvoorwaarden systematisch: min-1, min, max, max+1. Geparametriseerde tests maken de dekking van grenswaarden leesbaar en onderhoudbaar.

@ParameterizedTest
@CsvSource({"0, false", "1, true", "100, true", "101, false"})
void test_range_boundaries(int value, boolean expected) {
    assertEquals(expected, validator.isInRange(value, 1, 100));
}

Korte controle

Welk retourtype van @MethodSource levert de argumenten voor elke testaanroep?

Samenvatting

Gebruik @CsvSource voor tabelgegevens in de test zelf, @MethodSource voor complexe objecten, @EnumSource voor alle enumwaarden en @NullAndEmptySource voor randgevallen met null en lege waarden. Aangepaste namen met name= verbeteren de leesbaarheid van tests.

Gratis beginnen

Leer Java met een AI-tutor — gratis

Schrijf echte code en voer die uit in je browser, krijg direct hulp van een AI-tutor die 24/7 beschikbaar is en ga verder waar je gebleven bent op het web of in de app.

Cursussen
104
Lessen
374

Veelgestelde vragen

Is de les “Geparametriseerde tests met @CsvSource en @MethodSource” gratis?

Ja — de volledige tekst van “Geparametriseerde tests met @CsvSource en @MethodSource” kun je hier gratis op het web lezen. Als je interactief wilt oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is, en de rest van de cursus Java Academy wilt ontgrendelen, kun je upgraden naar CoddyKit PRO. De cursus Java Academy bevat in totaal 4 lessen.

Wat leer ik in “Geparametriseerde tests met @CsvSource en @MethodSource”?

Voer dezelfde test uit met meerdere invoersets met @ParameterizedTest, @CsvSource en @MethodSource. Je oefent met Java Academy door code rechtstreeks in de browser uit te voeren. Een AI-begeleider die 24/7 beschikbaar is beantwoordt je vragen terwijl je de les doorwerkt.

Heb ik ervaring nodig om met Java Academy te beginnen?

Ervaring vooraf is niet nodig. Java Academy op CoddyKit is opgebouwd voor beginners tot gevorderden, zodat je hier of bij het begin kunt starten en in je eigen tempo kunt leren. Dit is les 1 van 4.

Hoe lang duurt de les “Geparametriseerde tests met @CsvSource en @MethodSource”?

De meeste lessen van CoddyKit duren ongeveer 5–10 minuten. Elke les is kort en interactief, zodat je gestaag vooruitgaat en op het web en in de app precies verdergaat waar je was gebleven.

Kan ik code schrijven en uitvoeren in deze les over Java Academy?

Ja. Elke les over Java Academy bevat een ingebouwde code-editor, zodat je rechtstreeks in je browser echte code kunt schrijven en uitvoeren en direct feedback van AI krijgt — lokale installatie is niet nodig.

Alle lessen in deze cursus

  1. Geparametriseerde tests met @CsvSource en @MethodSource
  2. Mockito geavanceerd: argumentcaptors en spies
  3. Spring Boot-testslices: @WebMvcTest en @DataJpaTest
  4. Testcontainers: integratietests met een echte database
← Terug naar Java Academy