Accueil › Spring Boot › Appeler et documenter des API
Appeler et documenter des API — entretien Spring Boot
2 questions posées en entretien sur 2 sujets, avec la bonne réponse et son explication.
RestClient
Sans configuration particulière, que fait `retrieve()` quand la réponse a un statut 500 ?
- Il renvoie `null`
- Il lève une `HttpServerErrorException` ✓
- Il lève une `MethodArgumentNotValidException`
- Il renvoie le corps de la réponse tel quel, à charge pour l'appelant de vérifier le statut
Pourquoi : `retrieve()` lève par défaut une exception pour tout statut 4xx (`HttpClientErrorException`) ou 5xx (`HttpServerErrorException`). Pour un comportement différent, il faut le personnaliser avec `onStatus(...)`.
Niveau confirme
Résilience et timeouts
Une équipe ajoute `@Retryable(maxAttempts = 3)` sur une méthode qui envoie un POST de création de commande vers une API de paiement, sans autre précaution. Quel est le principal risque ?
- Aucun : @Retryable ne retente que les GET par défaut
- Si la première tentative a réussi côté serveur mais que la réponse s'est perdue, la reprise peut créer la commande plusieurs fois ✓
- Le code ne compilera pas : @Retryable est réservé aux méthodes qui renvoient void
- La méthode ne sera retentée qu'en cas d'erreur 4xx
Pourquoi : Une reprise automatique suppose que l'opération est idempotente. Un POST de création ne l'est pas par nature : sans clé d'idempotence côté serveur, retenter après un échec réseau (alors que le traitement a peut-être abouti) peut dupliquer l'effet. La règle : ne retenter que des opérations idempotentes, ou s'appuyer sur un mécanisme d'idempotence explicite.
Niveau senior