En aquesta secció, aprendrem a escriure el nostre primer test utilitzant JUnit. Aquest és un pas fonamental per començar a treballar amb JUnit i entendre com funciona el procés de testing en Java.

Objectius

  • Configurar un projecte Java per utilitzar JUnit.
  • Escriure i executar un test bàsic amb JUnit.
  • Entendre els conceptes bàsics de les assertions.

  1. Configuració del Projecte

1.1. Crear un Projecte Java

Primer, necessitem crear un projecte Java. Pots utilitzar qualsevol entorn de desenvolupament integrat (IDE) com IntelliJ IDEA, Eclipse o NetBeans. Aquí utilitzarem IntelliJ IDEA com a exemple.

  1. Obre IntelliJ IDEA.
  2. Crea un nou projecte seleccionant File > New > Project.
  3. Selecciona Java i assegura't que el JDK estigui configurat correctament.
  4. Dona un nom al projecte i selecciona la ubicació on vols guardar-lo.

1.2. Afegir JUnit al Projecte

Per utilitzar JUnit, necessitem afegir la seva dependència al nostre projecte. Si estàs utilitzant Maven o Gradle, pots afegir la dependència al fitxer pom.xml o build.gradle respectivament.

Maven

Afegeix la següent dependència al teu pom.xml:

<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-engine</artifactId>
    <version>5.8.1</version>
    <scope>test</scope>
</dependency>

Gradle

Afegeix la següent dependència al teu build.gradle:

testImplementation 'org.junit.jupiter:junit-jupiter-engine:5.8.1'

  1. Escriure el Primer Test

2.1. Crear una Classe de Test

Crea una nova classe de test dins del directori src/test/java. Anomena la classe CalculatorTest.

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

public class CalculatorTest {

    @Test
    public void testAddition() {
        Calculator calculator = new Calculator();
        int result = calculator.add(2, 3);
        assertEquals(5, result, "2 + 3 hauria de ser 5");
    }
}

2.2. Crear la Classe Calculator

Crea una classe Calculator dins del directori src/main/java amb el següent codi:

public class Calculator {

    public int add(int a, int b) {
        return a + b;
    }
}

2.3. Explicació del Codi

  • Classe de Test (CalculatorTest): Aquesta classe conté els nostres tests. Utilitzem l'anotació @Test per indicar que el mètode testAddition és un test.
  • Mètode de Test (testAddition): Aquest mètode crea una instància de Calculator i comprova si el mètode add retorna el resultat esperat.
  • Assertion (assertEquals): Utilitzem assertEquals per verificar que el resultat de calculator.add(2, 3) és 5. Si el resultat no és 5, el test fallarà.

  1. Executar el Test

3.1. Executar el Test des de l'IDE

  1. Fes clic dret sobre la classe CalculatorTest.
  2. Selecciona Run 'CalculatorTest'.

3.2. Resultats del Test

Si tot està configurat correctament, hauries de veure que el test passa sense errors. Això significa que el mètode add de la classe Calculator funciona com s'esperava.

  1. Exercici Pràctic

Exercici

Crea un nou mètode a la classe Calculator anomenat subtract que resti dos nombres. Escriu un test per verificar que aquest mètode funciona correctament.

Solució

Classe Calculator

public class Calculator {

    public int add(int a, int b) {
        return a + b;
    }

    public int subtract(int a, int b) {
        return a - b;
    }
}

Classe CalculatorTest

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

public class CalculatorTest {

    @Test
    public void testAddition() {
        Calculator calculator = new Calculator();
        int result = calculator.add(2, 3);
        assertEquals(5, result, "2 + 3 hauria de ser 5");
    }

    @Test
    public void testSubtraction() {
        Calculator calculator = new Calculator();
        int result = calculator.subtract(5, 3);
        assertEquals(2, result, "5 - 3 hauria de ser 2");
    }
}

Conclusió

En aquesta secció, hem après a configurar un projecte Java per utilitzar JUnit, escriure el nostre primer test i executar-lo. També hem vist com utilitzar les assertions per verificar els resultats dels nostres tests. A la següent secció, explorarem les anotacions bàsiques de JUnit per millorar els nostres tests.

© Copyright 2024. Tots els drets reservats