Accueil › Spring Boot › Créer une API REST
Créer une API REST — entretien Spring Boot
6 questions posées en entretien sur 4 sujets, avec la bonne réponse et son explication.
Contrôleurs REST
Que fait `@RestController` que `@Controller` seul ne fait pas ?
- Il active le component scan
- Il ajoute `@ResponseBody` : les retours des méthodes sont écrits directement dans le corps de la réponse (JSON), au lieu d'être interprétés comme un nom de vue ✓
- Il active automatiquement la validation
- Il rend le contrôleur singleton
Pourquoi : `@RestController` = `@Controller` + `@ResponseBody`. Sans `@ResponseBody`, Spring MVC cherche une vue portant le nom de la chaîne retournée.
Niveau junior
Lire la requête
Pour l'URL `GET /commandes/12/lignes?statut=EN_ATTENTE`, quelles annotations utiliser ?
- `@RequestParam` pour `12`, `@PathVariable` pour `statut`
- `@PathVariable` pour `12`, `@RequestParam` pour `statut` ✓
- `@RequestBody` pour les deux
- `@PathVariable` pour les deux
Pourquoi : `12` fait partie du chemin de l'URL (identifie la commande) : `@PathVariable`. `statut` est un paramètre de filtrage après le `?` : `@RequestParam`.
Niveau junior
Réponses HTTP
Quel code HTTP renvoyer après une création de ressource réussie via `POST` ?
- 200 OK
- 201 Created ✓
- 204 No Content
- 202 Accepted
Pourquoi : 201 signale qu'une nouvelle ressource a été créée. Par convention, la réponse inclut aussi l'en-tête `Location` pointant vers cette ressource.
Niveau junior
Pourquoi préférer `ResponseEntity<Produit>` à un simple retour `Produit` quand la ressource peut être absente ?
@GetMapping("/{id}")
public Produit get(@PathVariable Long id) {
return service.trouver(id).orElseThrow();
}
- Les deux se comportent exactement pareil
- `ResponseEntity` permet de renvoyer explicitement un 404 (via `notFound().build()`) au lieu de laisser une exception non gérée remonter en 500 ✓
- `Produit` ne peut pas être sérialisé en JSON sans `ResponseEntity`
- `ResponseEntity` est obligatoire dès qu'on utilise `@RestController`
Pourquoi : Un simple retour d'objet est toujours 200 s'il n'y a pas d'exception ; ici, `orElseThrow()` sans exception personnalisée lève une `NoSuchElementException` non gérée par défaut, donc 500. `ResponseEntity` (ou une exception métier traduite en 404) exprime clairement l'absence de la ressource.
Niveau confirme
Validation
Quelle annotation refuse à la fois `null`, `""` et `" "` pour un champ `String` ?
- `@NotNull`
- `@NotEmpty`
- `@NotBlank` ✓
- `@Size(min = 1)`
Pourquoi : `@NotNull` laisse passer une chaîne vide. `@NotEmpty` laisse passer une chaîne composée uniquement d'espaces. Seul `@NotBlank` rejette les trois cas.
Niveau confirme
Un `@RequestParam @Min(1) int page` reçoit `page=0`. Que se passe-t-il avec Spring Framework 6.1+ ?
@GetMapping("/produits")
public List<Produit> lister(@RequestParam @Min(1) int page) {
return service.lister(page);
}
- Rien : les contraintes sur `@RequestParam` ne sont jamais vérifiées
- 500, car la validation de paramètre nécessite obligatoirement `@Validated` sur la classe
- 400 Bad Request : une `HandlerMethodValidationException` est levée automatiquement, sans configuration supplémentaire ✓
- La méthode s'exécute avec `page = 1` (valeur minimale forcée)
Pourquoi : Depuis Spring Framework 6.1 (Spring Boot 3.2), Spring MVC valide nativement les `@RequestParam`/`@PathVariable` porteurs d'une contrainte et traduit l'échec en 400 via `HandlerMethodValidationException`, sans avoir besoin de `@Validated` sur la classe (nécessaire avant cette version).
Niveau senior