Pruebas parametrizadas con @CsvSource y @MethodSource
Ejecute la misma prueba con varios conjuntos de entradas mediante @ParameterizedTest, @CsvSource y @MethodSource.
Pruebas parametrizadas con @CsvSource y @MethodSource es una lección gratuita de Java Academy en CoddyKit. Esta es la lección 1 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Java Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Java Academy incluye 4 lecciones en total.
¿Por qué usar pruebas parametrizadas?
Ejecutar la misma lógica de prueba con varios conjuntos de datos de entrada permite descubrir casos límite sin copiar y pegar métodos de prueba. JUnit 5 admite pruebas parametrizadas de forma nativa mediante @ParameterizedTest.
@ValueSource: pruebas simples con un solo valor
@ValueSource proporciona un único parámetro de un tipo determinado. La prueba se ejecuta una vez por cada valor.
@ParameterizedTest
@ValueSource(strings = {"", " ", "\t"})
void blank_strings_are_rejected(String input) {
assertThrows(IllegalArgumentException.class, () -> validator.validate(input));
}@CsvSource: varios parámetros en línea
@CsvSource proporciona filas de valores separados por comas. Cada fila corresponde a una ejecución de prueba. Utilice comillas simples para escapar las comas de los valores de tipo cadena.
@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 con delimiterString
Utilice delimiterString para delimitadores de varios caracteres o cuando los datos contengan comas. Use nullValues para convertir una cadena indicadora en null.
@ParameterizedTest
@CsvSource(value = {
"Alice | 30 | ADMIN",
"Bob | 25 | USER"
}, delimiterString = "|")
void test_roles(String name, int age, String role) { ... }@CsvFileSource: archivos de datos externos
Cargue los datos de prueba desde un archivo CSV incluido en el classpath. Es útil para conjuntos de datos grandes que saturarían el código de prueba.
@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: parámetros complejos
@MethodSource llama a un método de fábrica estático que devuelve un Stream<Arguments>. Cada Arguments.of() corresponde a una ejecución de prueba. Utilícelo para objetos complejos.
@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: probar todos los valores de un enum
@EnumSource ejecuta la prueba una vez por cada constante del enum. Utilice mode y names para incluir o excluir valores específicos.
@ParameterizedTest
@EnumSource(value = UserStatus.class, mode = EnumSource.Mode.EXCLUDE, names = "DELETED")
void test_active_statuses(UserStatus status) {
assertTrue(notificationService.shouldNotify(status));
}@NullAndEmptySource
Es una forma abreviada de probar entradas null y cadenas vacías. Combínelo con @ValueSource mediante @NullSource + @EmptySource o utilice la anotación combinada @NullAndEmptySource.
@ParameterizedTest
@NullAndEmptySource
void null_and_empty_are_invalid(String input) {
assertFalse(validator.isValid(input));
}Nombres de visualización personalizados
Utilice name en @ParameterizedTest para dar formato al nombre de visualización de la prueba. Marcadores de posición: {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) { ... }Combinar fuentes con @ArgumentsSource
Implemente ArgumentsProvider para generar argumentos de forma completamente personalizada: datos dinámicos de bases de datos, archivos o API.
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) { ... }Pruebas parametrizadas para valores límite
Pruebe sistemáticamente las condiciones límite: min-1, min, max y max+1. Las pruebas parametrizadas hacen que la cobertura de límites sea fácil de leer y mantener.
@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));
}Comprobación rápida
¿Qué tipo devuelve @MethodSource para proporcionar los argumentos de cada ejecución de prueba?
Resumen
Utilice @CsvSource para datos tabulares en línea, @MethodSource para objetos complejos, @EnumSource para todos los valores de un enum y @NullAndEmptySource para casos límite con valores null o vacíos. Los nombres personalizados con name= mejoran la legibilidad de las pruebas.
Preguntas frecuentes
¿La lección «Pruebas parametrizadas con @CsvSource y @MethodSource» es gratis?
Sí — el texto completo de «Pruebas parametrizadas con @CsvSource y @MethodSource» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Java Academy, actualiza a CoddyKit PRO. El curso de Java Academy incluye 4 lecciones en total.
¿Qué aprenderé en «Pruebas parametrizadas con @CsvSource y @MethodSource»?
Ejecute la misma prueba con varios conjuntos de entradas mediante @ParameterizedTest, @CsvSource y @MethodSource. Practicas Java Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Java Academy?
No se requiere experiencia previa. Java Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 1 de 4.
¿Cuánto tiempo toma la lección «Pruebas parametrizadas con @CsvSource y @MethodSource»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Java Academy?
Sí. Cada lección de Java Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Pruebas parametrizadas con @CsvSource y @MethodSource
- Mockito avanzado: capturadores de argumentos y spies
- Slices de prueba de Spring Boot: @WebMvcTest y @DataJpaTest
- Testcontainers: pruebas de integración con una base de datos real