Formations — 1 037 leçons en français

Accueil › Spring Boot › Tester un contrôleur avec @WebMvcTest et MockMvc

Tester un contrôleur avec @WebMvcTest et MockMvc

Tester son applicationdebutant

@WebMvcTest est un test slice : il ne charge que la couche web (contrôleurs, Jackson, validation, gestion des erreurs), pas les services ni les repositories. Beaucoup plus rapide qu'un @SpringBootTest complet, tout en testant le vrai comportement HTTP.

@WebMvcTest(ProduitController.class)
class ProduitControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @MockitoBean
    private ProduitService produitService; // le service n'est pas chargé, on le mocke

    @Test
    void getProduit_renvoie_le_produit() throws Exception {
        when(produitService.trouver(1L)).thenReturn(new Produit(1L, "Clavier", 49.90));

        mockMvc.perform(get("/produits/1"))
            .andExpect(status().isOk())
            .andExpect(jsonPath("$.nom").value("Clavier"))
            .andExpect(jsonPath("$.prix").value(49.90));
    }
}

MockMvc simule une requête HTTP sans ouvrir de port réseau : perform(get(...)) envoie la requête, andExpect(...) vérifie la réponse (statut, en-têtes, corps JSON via jsonPath). Comme le service n'est pas dans ce contexte réduit, @MockitoBean fournit un mock à la place du vrai bean, injecté dans le contrôleur.

Les termes à connaître

Test slice

Un test qui ne charge qu'une partie du contexte Spring, ciblée sur une couche (web, JPA…), au lieu de toute l'application. Plus rapide que @SpringBootTest, tout en testant du vrai code Spring (pas seulement une classe isolée).

@WebMvcTest

Test slice pour la couche web : charge uniquement les contrôleurs, la configuration MVC (Jackson, validation, gestion des erreurs) et un MockMvc, sans les couches service ou repository. @WebMvcTest(CommandeController.class) cible un seul contrôleur ; sans argument, tous les contrôleurs sont chargés.

MockMvc

Client qui simule des requêtes HTTP sans démarrer de serveur réel. mockMvc.perform(get("/commandes/1")) envoie la requête au contrôleur, en passant par la vraie chaîne Spring MVC (désérialisation, validation, sérialisation JSON).

andExpect

Vérifie un aspect de la réponse simulée : status().isOk(), jsonPath("$.nom").value("Clavier"), content().contentType(MediaType.APPLICATION_JSON). Plusieurs andExpect peuvent s'enchaîner sur un même perform.

JsonPath

Syntaxe pour naviguer dans un JSON par chemin, comme XPath pour le XML. $.nom lit le champ nom à la racine, $.lignes[0].prix le prix de la première ligne d'un tableau.

@MockitoBean (dans un test slice)

Comme dans @SpringBootTest, remplace un bean par un mock. Dans un @WebMvcTest, indispensable pour fournir le Service attendu par le contrôleur : ce bean n'existe pas dans ce contexte réduit, il faut le mocker.

ObjectMapper

Composant Jackson qui convertit un objet Java en JSON et inversement. Dans un test, objectMapper.writeValueAsString(dto) prépare le corps JSON d'une requête POST simulée.

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.