Formations — 1 037 leçons en français

Accueil › Fullstack Angular + Spring Boot › Le parcours d'une requête, du clic à la base

Le parcours d'une requête, du clic à la base

Le contrat d'APIdebutant

Dans un projet fullstack découplé, vous développez deux applications qui ne partagent rien d'autre qu'un contrat HTTP. Angular tourne dans le navigateur de l'utilisateur, Spring Boot sur un serveur : aucun appel de méthode, aucun type partagé, aucune transaction commune.

Le parcours complet d'un clic :

  1. L'utilisateur clique. Un composant Angular appelle une méthode d'un service.
  2. Le service émet une requête HTTP avec HttpClient. Rien ne part tant que personne n'est abonné à l'Observable.
  3. Le navigateur envoie la requête. Si l'origine diffère de celle de la page, il applique les règles CORS.
  4. Spring Boot reçoit la requête : filtres de sécurité, routage vers le contrôleur, désérialisation du corps par Jackson, validation.
  5. Le contrôleur appelle un service, qui ouvre une transaction et interroge la base via un repository.
  6. Le service renvoie un DTO, Jackson le sérialise en JSON, le contrôleur choisit un code de statut.
  7. Angular reçoit la réponse, la place dans un signal, le template se met à jour.
NAVIGATEUR — chez l'utilisateur SERVEUR — Spring Boot 1 Clic sur « Valider » le composant appelle le service 2 Service : http.post(…) froid : rien ne part sans abonnement 3 · requête HTTP : jeton ajouté, CORS si autre origine 4 Filtres de sécurité → contrôleur signature et expiration du jeton vérifiées Jackson désérialise, @Valid valide 5 Service @Transactional règles métier appliquées repository → base de données 6 · réponse : DTO sérialisé en JSON + code de statut 7 Signal mis à jour le template se redessine
Chacune des sept étapes échoue indépendamment des autres : c'est ce qui rend le débogage fullstack particulier.
@GetMapping("/api/commandes/{id}")
public CommandeDetailDto detail(@PathVariable long id) {
    return service.detail(id); // Jackson sérialise, 200 OK par défaut
}
export class CommandeService {
  private http = inject(HttpClient);

  detail(id: number) {
    return this.http.get<CommandeDetail>(`/api/commandes/${id}`);
  }
}

Chaque étape peut échouer indépendamment, et c'est ce qui rend le débogage fullstack particulier : une erreur affichée dans le navigateur peut provenir de sept endroits différents.

Les termes à connaître

Origine (origin)

Le triplet schéma + domaine + port d'une URL (https://boutique.fr:443). Deux URL qui diffèrent sur l'un des trois sont d'origines différentes, ce qui déclenche les règles CORS du navigateur. localhost:4200 et localhost:8080 sont deux origines distinctes.

Front séparé (découplé)

Architecture où le front Angular est une application à part, servie par son propre serveur (ou un CDN), qui dialogue avec le back par HTTP/JSON. À l'opposé d'un rendu de pages par le serveur (Thymeleaf, JSP) où front et back ne font qu'un.

Contrat d'API

L'ensemble de ce sur quoi les deux côtés se sont mis d'accord : URL, méthode HTTP, forme du corps envoyé, forme de la réponse, codes de statut, format des erreurs. C'est le seul point de rencontre entre les deux applications : tout le reste est un détail d'implémentation.

DTO (Data Transfer Object)

Objet dont le seul rôle est de transporter des données à travers le contrat, dans un sens ou dans l'autre. Côté Spring Boot, c'est souvent un record. Il est distinct de l'entité JPA, qui représente une ligne en base.

Sérialisation / désérialisation

Sérialisation : transformer un objet Java en JSON (fait par Jackson au retour du contrôleur). Désérialisation : reconstruire un objet Java à partir du JSON reçu. Côté front, le navigateur fait l'équivalent, mais le type TypeScript annoncé n'est jamais vérifié à l'exécution.

Aller-retour (round trip)

Un cycle complet requête → traitement → réponse. Compter les allers-retours nécessaires à l'affichage d'un écran est le premier réflexe de performance d'une application fullstack.

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.