Accueil › Fullstack Angular + Spring Boot › Simuler le back, et vérifier que le contrat tient
Simuler le back, et vérifier que le contrat tient
Faire tourner les deux ensembleintermediaire
Deux besoins distincts, souvent confondus :
- Développer le front sans attendre le back → un simulateur.
- S'assurer que le vrai back respecte le contrat → un test de contrat.
Le simulateur le plus simple, pour commencer : un intercepteur actif seulement en développement.
export const simulateurInterceptor: HttpInterceptorFn = (requete, suivant) => {
if (environment.production || !requete.url.startsWith('/api/commandes')) {
return suivant(requete);
}
return of(new HttpResponse({ status: 200, body: COMMANDES_EXEMPLE }))
.pipe(delay(300)); // simuler la latence, sinon l'interface paraît trop réactive
};
Et le test de contrat côté back, qui verrouille la forme du JSON :
@WebMvcTest(CommandeController.class)
class CommandeControllerTest {
@Autowired MockMvc mvc;
@MockitoBean CommandeService service;
@Test
void leDetailRespecteLeContrat() throws Exception {
when(service.detail(42L)).thenReturn(new CommandeDto(
42L, "CMD-2026-042", "Jean Dupont",
new BigDecimal("129.80"), StatutCommande.VALIDEE,
LocalDateTime.of(2026, 11, 6, 14, 30)));
mvc.perform(get("/api/commandes/42"))
.andExpect(status().isOk())
.andExpect(content().contentTypeCompatibleWith(MediaType.APPLICATION_JSON))
.andExpect(jsonPath("$.id").value(42))
.andExpect(jsonPath("$.nomClient").value("Jean Dupont"))
.andExpect(jsonPath("$.total").value(129.80))
.andExpect(jsonPath("$.statut").value("VALIDEE"))
.andExpect(jsonPath("$.creeLe").value("2026-11-06T14:30:00"));
}
}
Ce test échoue si quelqu'un renomme nomClient, change le format de date ou le nom d'une valeur d'énumération — c'est-à-dire à chaque modification du contrat, ce qui est exactement le but.
Les termes à connaître
- HttpTestingController
Outil de test Angular (
provideHttpClientTesting()) qui capture les requêtes au lieu de les envoyer, permet de faire des assertions dessus, puis de simuler la réponse avecflush(...)ouerror(...). C'est un test unitaire : aucun back n'est sollicité.- Simulateur de back (mock server)
Serveur HTTP léger qui répond à la place du vrai back pendant le développement du front : fichiers JSON servis statiquement, outil dédié, ou intercepteur de développement. Il débloque le front quand l'API n'existe pas encore.
- Test de contrat
Test qui vérifie que le back produit effectivement la forme de réponse attendue par le front. Il ne vérifie pas la logique métier mais la structure : noms de champs, types, codes de statut, format d'erreur.
- @WebMvcTest
Annotation Spring Boot qui démarre uniquement la couche web (contrôleurs, sérialisation, conseils d'exception) avec les services remplacés par des doubles. Rapide, et c'est exactement le périmètre d'un test de contrat côté back.
- MockMvc
Outil Spring de test de la couche web sans serveur réel : on envoie une requête simulée et on fait des assertions sur le statut, les en-têtes et le JSON produit (
jsonPath). C'est là que l'on verrouille la forme du contrat.- Testcontainers
Bibliothèque qui démarre des conteneurs Docker (base de données, courtier) pour la durée des tests. Elle permet de tester avec la vraie base plutôt qu'une base en mémoire dont le dialecte SQL diffère.
- Jeu de données de référence (fixture)
Réponse JSON figée, stockée dans un fichier et partagée par les tests du front et du back. Si les deux côtés valident la même référence, le contrat est tenu des deux bouts.
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.