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). PlusieursandExpectpeuvent s'enchaîner sur un mêmeperform.- JsonPath
Syntaxe pour naviguer dans un JSON par chemin, comme XPath pour le XML.
$.nomlit le champnomà la racine,$.lignes[0].prixle 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 leServiceattendu 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.
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.