Formations — 1 037 leçons en français

Accueil › Java › Doubles de test avec Mockito

Doubles de test avec Mockito

Tests et qualitéintermediaire

Un test unitaire vérifie une classe isolée, sans ses vraies dépendances (base de données, appel réseau, horloge…). Mockito crée des doublures de test qui les remplacent : on leur dit quoi répondre, puis on vérifie qu'elles ont été sollicitées comme prévu.

Grâce à l'injection par constructeur, créer un objet testé avec des doublures ne demande aucun framework :

@ExtendWith(MockitoExtension.class)
class ProduitServiceTest {

    @Mock
    private ProduitRepository repository;

    @InjectMocks
    private ProduitService service;

    @Test
    void trouver_renvoie_le_produit_existant() {
        Produit produit = new Produit(1L, "Clavier", 49.90);
        when(repository.findById(1L)).thenReturn(Optional.of(produit));

        Produit resultat = service.trouver(1L);

        Assertions.assertEquals("Clavier", resultat.nom());
        verify(repository).findById(1L);
    }
}

@Mock crée un mock du dépôt, @InjectMocks instancie réellement ProduitService et lui passe ce mock via son constructeur. when(...).thenReturn(...) configure la réponse (étape Given), l'appel à service.trouver(1L) exécute le code testé (When), et verify contrôle l'interaction attendue (Then).

<dependency>
    <groupId>org.mockito</groupId>
    <artifactId>mockito-junit-jupiter</artifactId>
    <version>5.23.0</version>
    <scope>test</scope>
</dependency>

Les termes à connaître

Doublure de test (mock, stub, spy…)

Terme générique pour tout objet qui remplace une vraie dépendance en test. On distingue : dummy (objet passé pour satisfaire une signature, jamais utilisé), fake (implémentation simplifiée mais fonctionnelle, ex. une liste en mémoire à la place d'une base), stub (renvoie des réponses préprogrammées), mock (comme un stub, mais dont on vérifie aussi les appels reçus), spy (objet réel dont on surveille ou modifie certains appels).

mock()

Crée une doublure à partir d'une interface ou d'une classe : ProduitRepository repository = mock(ProduitRepository.class). Tant qu'une méthode n'est pas configurée, elle renvoie une valeur neutre (null, 0, une collection vide…).

when / thenReturn / thenThrow

Configurent la réponse d'un mock à un appel précis : when(repository.findById(1L)).thenReturn(Optional.of(produit)), ou thenThrow(new ProduitIntrouvableException()) pour simuler une erreur.

verify

Vérifie qu'une méthode du mock a bien été appelée, avec éventuellement un nombre d'appels précis : verify(repository).save(produit), verify(repository, times(2)).save(any()), verify(repository, never()).delete(any()).

ArgumentCaptor

Capture la valeur exacte d'un argument reçu par le mock lors d'un appel, pour l'inspecter ensuite en détail. Utile quand l'objet passé est construit à l'intérieur de la méthode testée et donc inconnu à l'avance.

Matcher (any, eq)

Remplace un argument précis par une condition plus large dans when/verify (any(), anyString(), eq(valeur)…). Règle stricte : dès qu'un matcher est utilisé pour un argument d'un appel, tous les autres arguments de ce même appel doivent aussi être des matchers.

@Mock / @InjectMocks

Avec @ExtendWith(MockitoExtension.class), @Mock crée un mock pour le champ annoté et @InjectMocks instancie réellement la classe testée en lui injectant 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.