Un endpoint REST dans Spring Boot est une méthode d'un @RestController, associée à un verbe HTTP et à un chemin. @RestController = @Controller + @ResponseBody, si bien que les valeurs de retour sont sérialisées directement dans le corps de la réponse (JSON via Jackson) au lieu d'être résolues vers une vue.
@RestController
@RequestMapping("/api/users") // chemin de base pour chaque méthode ci-dessous
public class UserController {
private final UserService service;
public UserController(UserService service) { this.service = service; }
@GetMapping("/{id}") // GET /api/users/42
public UserDto get(@PathVariable Long id) { // lie {id} depuis l'URL
return service.findById(id); // objet renvoyé -> JSON
}
@PostMapping // POST /api/users
@ResponseStatus(HttpStatus.CREATED) // 201 au lieu de 200
public UserDto create(@Valid @RequestBody UserDto body) { // JSON -> objet
return service.create(body);
}
@GetMapping // GET /api/users?role=admin
public List<UserDto> list(@RequestParam(required = false) String role) {
return service.findByRole(role);
}
}
Annotations clés : @PathVariable extrait une valeur du chemin, @RequestParam lit un paramètre de query-string, et @RequestBody désérialise la charge utile JSON. Ajouter @Valid déclenche la Bean Validation (@NotNull, @Email…) sur le DTO entrant avant l'exécution de votre méthode.
@GetMapping("/{id}")
public ResponseEntity<UserDto> get(@PathVariable Long id) {
return service.find(id)
.map(ResponseEntity::ok) // 200 + corps
.orElse(ResponseEntity.notFound().build()); // 404, sans corps
}
C'est du travail backend de base, aussi les recruteurs attendent-ils de l'aisance. Les réponses solides évoquent l'usage de DTO plutôt que l'exposition des entités JPA, la validation des entrées avec @Valid, et le renvoi de codes de statut corrects avec ResponseEntity — la différence entre un endpoint jouet et une vraie API.
Une bibliothèque de questions d'entretien IT avec des réponses détaillées — du Junior au Senior.
Faire un don