Idempotence et mécanismes de nouvelle tentative
Concevez des opérations d’API idempotentes et mettez en œuvre des mécanismes intelligents de nouvelle tentative pour gérer élégamment les défaillances transitoires sans effets secondaires.
Idempotence et mécanismes de nouvelle tentative est une leçon API Rate Limiting & Scalability Patterns gratuite sur CoddyKit. Ceci est la leçon 2 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage API Rate Limiting & Scalability Patterns, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours API Rate Limiting & Scalability Patterns comprend 4 leçons au total.
Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.
What is Idempotency?
In distributed systems, operations can sometimes fail or be interrupted. Idempotency is a property of an operation that means applying it multiple times produces the same result as applying it once.
Think of it like repeatedly pressing an 'On/Off' button. If it's truly idempotent, the first press changes the state, but subsequent presses (without an intervening 'Off') don't change it further. The end state remains the same.
Why Idempotency Matters
Idempotency is crucial for building robust and reliable APIs, especially when dealing with network issues or transient server errors.
- Prevents Duplicate Actions: If a request fails mid-way, and the client retries it, idempotency ensures the operation isn't performed twice.
- Ensures Data Consistency: Avoids creating duplicate records or incorrect state changes.
- Supports Retries: It's a foundational concept that allows clients to safely retry requests without unintended side effects.
Idempotent vs. Non-Idempotent
Let's look at common HTTP methods and their idempotency:
- GET: Always idempotent. Retrieving data multiple times doesn't change it.
- PUT: Idempotent. Updating an entire resource multiple times results in the same final state.
- DELETE: Idempotent. Deleting a resource multiple times has the same effect as deleting it once (it remains deleted).
- POST: Generally not idempotent. Creating a new resource multiple times usually creates multiple new resources.
The key is the result, not the action itself.
Implementing Idempotency Keys
For non-idempotent operations like POST (e.g., creating an order or processing a payment), we can introduce an idempotency key.
This is a unique identifier (often a UUID) generated by the client and sent with the request. The server then uses this key to detect and ignore duplicate requests within a certain time frame.
Server-Side Idempotency Check
Here's a conceptual look at how a server might handle an idempotency key. The server checks if the key has already been processed for that specific operation.
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
public class PaymentProcessor {
private Map<String, Boolean> processedKeys = new ConcurrentHashMap<>();
public String processPayment(String idempotencyKey, double amount) {
if (processedKeys.containsKey(idempotencyKey)) {
System.out.println("Duplicate request for key: " + idempotencyKey + ". Returning previous result.");
return "Payment already processed for key " + idempotencyKey;
}
// Simulate payment processing
System.out.println("Processing payment of $" + amount + " with key: " + idempotencyKey);
try {
Thread.sleep(100); // Simulate work
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
}
processedKeys.put(idempotencyKey, true);
return "Payment successful for key " + idempotencyKey;
}
public static void main(String[] args) {
PaymentProcessor processor = new PaymentProcessor();
// First attempt with a key
System.out.println(processor.processPayment("uuid-123", 100.00));
// Retry with the same key (should be ignored)
System.out.println(processor.processPayment("uuid-123", 100.00));
// New request with a different key
System.out.println(processor.processPayment("uuid-456", 50.00));
}
}Introduction to Retries
Even with idempotent operations, requests can still fail due to temporary issues like network timeouts, server overload, or brief service outages. This is where retry mechanisms come in.
A retry mechanism automatically re-attempts a failed operation after a short delay. Its goal is to overcome transient (temporary) failures and improve the reliability of API calls.
Basic Retry Logic
The simplest retry mechanism involves a fixed number of retries with a constant delay between attempts. While straightforward, this can sometimes overwhelm a recovering service if many clients retry simultaneously.
public class SimpleRetry {
public static void makeApiCall() {
int maxRetries = 3;
int retryCount = 0;
long delayMillis = 1000; // 1 second
while (retryCount < maxRetries) {
try {
System.out.println("Attempt " + (retryCount + 1) + ": Making API call...");
// Simulate an API call that might fail
if (Math.random() > 0.6) { // 40% chance of success
System.out.println("API call successful!");
return; // Exit if successful
} else {
throw new RuntimeException("Simulated API failure.");
}
} catch (RuntimeException e) {
System.out.println("API call failed: " + e.getMessage());
retryCount++;
if (retryCount < maxRetries) {
try {
System.out.println("Retrying in " + delayMillis + "ms...");
Thread.sleep(delayMillis);
} catch (InterruptedException ie) {
Thread.currentThread().interrupt();
System.out.println("Retry interrupted.");
break;
}
}
}
}
System.out.println("All retry attempts failed.");
}
public static void main(String[] args) {
makeApiCall();
}
}Exponential Backoff
To avoid overwhelming services and to give them more time to recover, exponential backoff is a better strategy. It progressively increases the delay between retry attempts.
For example, delays could be 1s, 2s, 4s, 8s, etc. This reduces the load on a struggling service and spreads out retry attempts over time.
Backoff with Jitter
Even with exponential backoff, if many clients fail and retry at the exact same exponential intervals, they can still create a 'thundering herd' problem, all hitting the service at the same time.
Jitter adds a random component to the backoff delay. This helps to smooth out the retry attempts, distributing them more evenly and preventing synchronized bursts of traffic.
import java.util.Random;
public class ExponentialBackoffRetry {
private static final Random random = new Random();
public static void makeApiCallWithBackoff() {
int maxRetries = 5;
long baseDelay = 500; // milliseconds
long maxDelay = 16000; // cap the delay at 16 seconds
for (int retryCount = 0; retryCount < maxRetries; retryCount++) {
try {
System.out.println("Attempt " + (retryCount + 1) + ": Making API call...");
// Simulate an API call that might fail
if (Math.random() > 0.7) { // 30% chance of success
System.out.println("API call successful!");
return; // Exit if successful
} else {
throw new RuntimeException("Simulated API failure.");
}
} catch (RuntimeException e) {
System.out.println("API call failed: " + e.getMessage());
if (retryCount < maxRetries - 1) {
long delay = baseDelay * (long) Math.pow(2, retryCount);
delay = Math.min(delay, maxDelay);
// Add jitter: random value between 0 and delay
long jitteredDelay = random.nextInt((int) delay);
try {
System.out.println("Retrying in " + jitteredDelay + "ms (base: " + delay + ")...");
Thread.sleep(jitteredDelay);
} catch (InterruptedException ie) {
Thread.currentThread().interrupt();
System.out.println("Retry interrupted.");
break;
}
}
}
}
System.out.println("All retry attempts failed after " + maxRetries + " retries.");
}
public static void main(String[] args) {
makeApiCallWithBackoff();
}
}Idempotency & Retries Together
Idempotency and retry mechanisms are a powerful combination for building resilient distributed systems.
- Retries handle transient network or service failures, increasing the chance of an operation succeeding.
- Idempotency ensures that if a retry happens for an operation that actually succeeded (but the client didn't receive confirmation), no harmful duplicate side effects occur.
Together, they allow clients to make API calls with confidence, knowing that temporary issues won't lead to data corruption or incorrect states.
Check Your Understanding
Which of the following statements about idempotency and retry mechanisms are TRUE?
Recap: Robust APIs
In this lesson, we explored two critical concepts for building highly scalable and resilient APIs:
- Idempotency: Operations that produce the same result whether applied once or multiple times, crucial for preventing duplicate side effects.
- Retry Mechanisms: Strategies like exponential backoff with jitter that allow clients to gracefully handle transient failures by re-attempting requests with increasing, randomized delays.
By combining idempotency with intelligent retry logic, you can design API interactions that are robust, reliable, and tolerant of the unpredictable nature of distributed systems.
Apprends API Rate Limiting & Scalability Patterns avec un tuteur IA — gratuit
Écris et exécute du vrai code dans ton navigateur, obtiens de l'aide instantanée d'un tuteur IA disponible 24h/24, et reprends là où tu t'es arrêté sur le web ou dans l'app.
- Cours
- 12
- Leçons
- 48
Questions Fréquemment Posées
La leçon « Idempotence et mécanismes de nouvelle tentative » est-elle gratuite ?
Oui — le texte complet de « Idempotence et mécanismes de nouvelle tentative » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours API Rate Limiting & Scalability Patterns, passe à CoddyKit PRO. Le cours API Rate Limiting & Scalability Patterns comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Idempotence et mécanismes de nouvelle tentative » ?
Concevez des opérations d’API idempotentes et mettez en œuvre des mécanismes intelligents de nouvelle tentative pour gérer élégamment les défaillances transitoires sans effets secondaires. Tu pratiques API Rate Limiting & Scalability Patterns avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer API Rate Limiting & Scalability Patterns ?
Aucune expérience préalable n'est requise. API Rate Limiting & Scalability Patterns sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 4.
Combien de temps prend la leçon « Idempotence et mécanismes de nouvelle tentative » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon API Rate Limiting & Scalability Patterns ?
Oui. Chaque leçon API Rate Limiting & Scalability Patterns inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Disjoncteurs et cloisons étanches
- Idempotence et mécanismes de nouvelle tentative
- API géodistribuées et reprise après sinistre
- Réduction de charge fondée sur le débit et contrôle de la pression