v0.20.0
La version v0.20.0, datée du 16 novembre 2026, fait suite à une revue de code du moteur de routage et du composant file. Plusieurs routes HTTP peuvent désormais partager un même port, neuf constats sont corrigés et quelques comportements visibles changent. Chaque module de composant et d’observabilité en v0.20.0 exige le cœur v0.20.0.
Changements de comportement
- Routes HTTP sur un même port : les consumers d’un même
HTTPComponentdont les URI partagent unhost:portpartagent désormais un seul listener et se distinguent par leur chemin ;From("http://0.0.0.0:8080/orders")etFrom("http://0.0.0.0:8080/health")peuvent donc cohabiter dans un contexte. Le port est libéré à l’arrêt du dernier consumer, et un chemin déjà servi sur le port est refusé auStart. Le middleware du consumer enveloppe maintenant le handler de chaque consumer : un chemin qu’aucun consumer ne sert répond 404 sans passer par lui. - Ordre de démarrage des routes :
CamelContext.Startdémarre d’abord les routes qui consomment depuisdirect:, puis les autres, chaque groupe dans l’ordre de déclaration. Un consumer qui route un exchange dès son démarrage trouve les routesdirect:qu’il appelle déjà démarrées. file—move/moveFailedrelatifs : un répertoire relatif est résolu à côté du fichier consommé (move=.doneenvoie/data/in/a.txtdans/data/in/.done/a.txt) et non plus par rapport au répertoire courant du processus. Les fichiers présents dans ces répertoires ne sont jamais reconsommés, y compris avecrecursive=true.file— arriéré au démarrage : les fichiers déjà présents dans le répertoire sont consommés par la goroutine du consumer et non plus depuisStart(); un arriéré ne bloque donc plus le démarrage de la route et du contexte.- Erreurs de
ParseURI: l’erreur ne cite plus l’URI brute ni le fragment fautif ; elle indique l’URI masquée et le type d’échec (invalid URI "ftp://user:xxxxx@host/dir": invalid percent-encoding).
Corrections
Content-TypeHTTP : unContent-Typeque la route pose à la valeur portée par la requête était écarté comme header entrant renvoyé en écho ; une API JSON répondant à une requête JSON répondait donc entext/plain.Content-Typeest désormais exclu du filtre anti-écho ; une route qui ne le pose pas renvoie celui de la requête.LoopetStop(): le Stop EIP dans une boucle était avalé et les étapes placées après la boucle s’exécutaient quand même.Stop()termine maintenant le routage de l’exchange ; tout autre signal d’arrêt (Filter,Sample…) ne termine toujours que la boucle.- Contexte du
Resequencer: les exchanges mis en tampon gardaient le contexte de la requête qui les avait apportés et étaient délivrés en aval avec un contexte annulé une fois cette requête terminée. Ils sont désormais délivrés sous le contexte de cycle de vie de la route. - Erreurs du
Resequencer: l’échec en aval d’un exchange du tampon était remonté à l’exchange qui avait déclenché la livraison, ce qui faisait échouer (et redélivrer) le mauvais message. Seul l’échec propre à un exchange lui est remonté ; les autres sont journalisés. - Idempotent Consumer : la clé d’un exchange en échec était retirée avec le contexte de l’exchange, souvent déjà annulé ; un dépôt sensible au contexte (Redis) conservait donc la clé et le message redélivré était écarté comme doublon. Le retrait ignore maintenant l’annulation et est borné à 30 s.
- Masquage des identifiants :
RedactURIrenvoyait telle quelle, identifiants compris, une URI qu’il ne parvenait pas à parser (un mot de passe contenant un%isolé). Ces URI sont maintenant masquées textuellement.
Mise à niveau
- Une route
filequi comptait sur unmove/moveFailedrelatif résolu par rapport au répertoire courant du processus doit passer à un chemin absolu. - Le code qui compare le texte d’une erreur de
ParseURIdoit être adapté. - Une route HTTP qui change le corps sans poser de
Content-Typerenvoie désormais celui de la requête au lieu d’un type deviné : posez-le explicitement.
Voir le CHANGELOG pour la liste complète des changements.