Cómo configurar y crear tests de JUnit 5 en Eclipse

Configurar y crear tests con JUnit 5 en Eclipse puede parecer un proceso algo enrevesado, especialmente si no usamos herramientas como Maven o Gradle que automatizan muchas tareas. Sin embargo, es totalmente posible trabajar con un proyecto Java estándar en Eclipse y añadir JUnit 5 para realizar pruebas unitarias de forma sencilla.

Para empezar, creamos un proyecto Java normal, por ejemplo llamado Ejemplo. Aunque Eclipse ofrece muchas opciones durante la creación, la mayoría no afectan directamente a la configuración de JUnit, así que podemos ajustar lo que queramos sin preocuparnos demasiado. Un paso importante es asegurarnos de que JUnit 5 esté incluido en el classpath del proyecto. Para ello, en la configuración del proyecto, vamos a la pestaña de Libraries dentro de Build Path y añadimos la biblioteca JUnit. Elegimos específicamente JUnit 5 para aprovechar las características de esta versión, aunque si quisiéramos, también podríamos usar JUnit 4, que tiene una API diferente.

Además, es buena práctica crear una carpeta separada para los tests. En Eclipse, podemos añadir una nueva Source Folder llamada Test. Así mantenemos el código fuente en src y los tests en Test, lo que ayuda a organizar mejor el proyecto. Cuando ejecutemos los tests, Eclipse combinará ambas carpetas para que todo funcione correctamente.

Con esta estructura lista, podemos crear una clase para probar. Por ejemplo, dentro del paquete ejemplo, creamos una clase Rectángulo con algún método que queramos testear. Luego, en la carpeta Test, generamos un nuevo test case de JUnit 5 (Jupiter). Si no aparece la opción directamente, podemos buscarla en el menú Other bajo la categoría JUnit. Al crear el test, es recomendable usar el mismo paquete ejemplo para evitar tener que importar la clase que vamos a probar.

Dentro del test, podemos escribir aserciones para verificar el comportamiento de la clase Rectángulo. Por ejemplo, si Rectángulo tiene métodos para calcular área y perímetro, podemos hacer algo así:

package ejemplo;

import static org.junit.jupiter.api.Assertions.assertEquals;

import org.junit.jupiter.api.Test;

public class RectanguloTest {

    @Test
    void testAreaYPerimetro() {
        Rectangulo r = new Rectangulo(3, 4);
        assertEquals(12, r.area());
        assertEquals(14, r.perimetro());
    }
}

Para ejecutar los tests, simplemente hacemos clic derecho sobre el proyecto o la clase de test y seleccionamos Run As > JUnit Test. Eclipse ejecutará las pruebas y nos mostrará si han pasado o fallado, con los resultados en verde o rojo respectivamente.

Si ya tenemos un proyecto creado sin la carpeta de tests o sin JUnit configurado, no hay problema. Podemos añadir la carpeta Test en cualquier momento desde el menú contextual del proyecto, eligiendo Build Path > New Source Folder. También, si intentamos crear un test sin tener JUnit en el classpath, Eclipse nos ofrecerá automáticamente añadirlo, facilitando la configuración.

Con estos pasos podemos montar un entorno de pruebas con JUnit 5 en Eclipse sin complicaciones, manteniendo el código y los tests organizados y ejecutando nuestras pruebas unitarias de forma rápida y sencilla.