Formations — 1 037 leçons en français

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 :

  1. Développer le front sans attendre le back → un simulateur.
  2. 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 avec flush(...) ou error(...). 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.

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.