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 HTTPComponent dont les URI partagent un host:port partagent désormais un seul listener et se distinguent par leur chemin ; From("http://0.0.0.0:8080/orders") et From("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é au Start. 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.Start démarre d’abord les routes qui consomment depuis direct:, puis les autres, chaque groupe dans l’ordre de déclaration. Un consumer qui route un exchange dès son démarrage trouve les routes direct: qu’il appelle déjà démarrées.
  • file — move / moveFailed relatifs : un répertoire relatif est résolu à côté du fichier consommé (move=.done envoie /data/in/a.txt dans /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 avec recursive=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 depuis Start() ; 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-Type HTTP : un Content-Type que 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 en text/plain. Content-Type est désormais exclu du filtre anti-écho ; une route qui ne le pose pas renvoie celui de la requête.
  • Loop et Stop() : 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 : RedactURI renvoyait 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 file qui comptait sur un move / moveFailed relatif 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 ParseURI doit être adapté.
  • Une route HTTP qui change le corps sans poser de Content-Type renvoie 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.