Accueil › Node.js › Pourquoi une file
Pourquoi une file
Tâches de fond et filesavance
Certains travaux n'ont pas leur place dans le temps d'une requête HTTP.
// ⛔ le client attend le service de courriel
app.post("/inscriptions", async (req, res) => {
const user = await db.creerUtilisateur(req.body);
await courriel.envoyer(user.email, "bienvenue"); // 8 s, ou une panne
res.status(201).json(user);
});
Si le service de courriel répond en huit secondes, l'inscription prend huit secondes. S'il est en panne, l'inscription échoue — alors que l'utilisateur est bel et bien créé en base.
// ✅ l'effet est promis, pas attendu
app.post("/inscriptions", async (req, res) => {
const user = await db.creerUtilisateur(req.body);
await file.ajouter("courriel-bienvenue", { userId: user.id });
res.status(201).json(user);
});
Les quatre travaux qui sortent de la requête
| Travail | Pourquoi dehors |
|---|---|
| Envoyer un courriel, un SMS | dépend d'un tiers indisponible |
| Produire un document, une facture | long, et le client n'en a pas besoin tout de suite |
| Appeler un service lent | sa latence devient la vôtre |
| Recalculer un agrégat, un index | coûteux, et peut être légèrement en retard |
Le contrat change
Ce qui sortait de la requête ne peut plus être rendu dans la requête. On ne
renvoie donc plus 200 avec un résultat, mais 202 et un moyen de suivre :
res.status(202)
.location(`/exports/${tache.id}`)
.json({ id: tache.id, etat: "en-attente" });
Le client interroge ensuite cette adresse, ou reçoit une notification. C'est une décision d'interface, pas un détail technique : elle se négocie avec celui qui écrit le client.
Les termes à connaître
- Tâche de fond
Un travail déclenché par une requête mais exécuté après elle. Le client reçoit une réponse immédiate, le travail se fait ailleurs.
- File de travaux
Une liste persistante de travaux à faire, écrite par un producteur et lue par un ou plusieurs consommateurs. Elle survit au redémarrage du processus.
- Producteur
Le code qui dépose un travail dans la file — en général le gestionnaire de requête HTTP. Il ne sait pas qui l'exécutera, ni quand.
- Consommateur
Un processus séparé qui retire les travaux de la file et les exécute. On en lance plusieurs pour aller plus vite.
- 202 Accepted
Le code de statut qui dit « j'ai pris votre demande, elle n'est pas encore faite ». Accompagné d'un moyen de suivre l'avancement.
- Contre-pression
Ce qui arrive quand la file se remplit plus vite qu'elle ne se vide. La longueur de la file est la métrique qui l'annonce.
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.