Formations — 1 037 leçons en français

Accueil › Spring Boot › Tests unitaires avec JUnit 5 et Mockito

Tests unitaires avec JUnit 5 et Mockito

Tester son applicationdebutant

spring-boot-starter-test apporte tout ce qu'il faut pour écrire des tests : JUnit 5 (le moteur de test), AssertJ (assertions lisibles), Mockito (mocks) et quelques utilitaires JSON.

Un test unitaire vérifie une classe isolée, sans démarrer Spring. Grâce à l'injection par constructeur, on peut créer l'objet testé avec un simple new et lui passer des mocks à la place de ses vraies dépendances :

@ExtendWith(MockitoExtension.class)
class CommandeServiceTest {

    @Mock
    private CommandeRepository repository;

    @InjectMocks
    private CommandeService service;

    @Test
    void trouver_renvoie_la_commande_existante() {
        // Given
        Commande commande = new Commande(1L, "En cours");
        when(repository.findById(1L)).thenReturn(Optional.of(commande));

        // When
        Commande resultat = service.trouver(1L);

        // Then
        assertThat(resultat.getStatut()).isEqualTo("En cours");
        verify(repository).findById(1L);
    }
}

La structure Given / When / Then (ou Arrange / Act / Assert) organise chaque test : préparer les données et le comportement des mocks, appeler la méthode testée, puis vérifier le résultat. Ce type de test s'exécute en quelques millisecondes : aucun contexte Spring, aucune base de données.

Les termes à connaître

spring-boot-starter-test

Le starter qui apporte tout ce qu'il faut pour tester : JUnit Jupiter (JUnit 5), AssertJ (assertions fluides), Mockito (mocks), Hamcrest, JSONassert et JsonPath. Un seul <dependency> (scope test), généré par défaut par Spring Initializr.

@Test

Marque une méthode comme un test JUnit 5 (package org.junit.jupiter.api). La méthode doit être publique ou package-private, sans paramètre, et ne renvoie rien.

@BeforeEach

Exécute la méthode annotée avant chaque test de la classe. Sert à préparer un état commun (créer les mocks, instancier l'objet testé) pour éviter la duplication.

@ParameterizedTest

Exécute le même test avec plusieurs jeux de données, fournis par exemple avec @ValueSource ou @CsvSource. Évite de dupliquer un test presque identique.

AssertJ (assertThat)

Bibliothèque d'assertions fluides et chaînables : assertThat(total).isEqualTo(42). Messages d'erreur plus lisibles que Assertions.assertEquals de JUnit, et beaucoup de méthodes dédiées (isEmpty(), containsExactly(), hasSize()…).

Mock (Mockito)

Un objet simulé qui remplace une vraie dépendance : on lui dit quoi répondre (when(...).thenReturn(...)) et on vérifie ensuite qu'il a été appelé (verify(...)). Permet de tester une classe isolément, sans ses dépendances réelles (base de données, appel HTTP…).

@ExtendWith(MockitoExtension.class)

Extension JUnit 5 qui active Mockito dans la classe de test : elle initialise les champs annotés @Mock et @InjectMocks, et vérifie que les mocks inutilisés (« unnecessary stubbing ») lèvent une erreur.

@Mock et @InjectMocks

@Mock crée un mock pour le champ annoté. @InjectMocks crée une vraie instance de la classe testée et y injecte les champs @Mock correspondants (par le constructeur si possible).

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.