Référence des Composants
Vue d’ensemble
Référence complète de tous les composants GoCamel disponibles. Les composants fournissent la connectivité à divers systèmes et services.
Composants Principaux
Direct
Routage synchrone en mémoire entre routes dans le même contexte.
Les endpoints sont identifiés par leur nom uniquement — les paramètres de requête sont ignorés pour l’identité, donc
direct:start et direct:start?x=1 correspondent au même endpoint. Un seul consumer par
endpoint est autorisé.
Timer
Déclenchement périodique simple.
| Option | Type | Défaut | Description |
|---|---|---|---|
period | Duration | 1s | Période entre les déclenchements |
repeatCount | int | 0 | Nombre de répétitions (0=infini) |
fixedRate | bool | false | Mode à fréquence fixe vs délai fixe |
Mock
Endpoint de test, producer uniquement (enregistré par défaut), qui enregistre chaque échange reçu.
À combiner avec Route.AdviceWith pour remplacer les endpoints réels d’une route construite avant Start().
| Méthode | Description |
|---|---|
MessageCount() | Nombre d’échanges reçus |
Message(i) | Instantané du i-ème échange (ordre d’arrivée), nil hors limites |
Body(i) / Header(i, name) | Corps / en-tête In du i-ème échange |
ExpectedMessageCount(n) | Attendre au moins n échanges (davantage est accepté) |
Wait(timeout) | Bloque jusqu’à ce que l’attente soit satisfaite ; erreur avec les compteurs à l’expiration |
Reset() | Efface les échanges reçus et l’attente |
- Les endpoints sont identifiés par leur nom uniquement et mis en cache par contexte :
mock:outdans une route etGetMockEndpoint("out")désignent le même endpoint. - Chaque échange est enregistré sous forme de
DeepCopyprise à l’envoi (ID d’échange d’origine conservé) : une modification ultérieure de l’échange vivant ne change pas l’instantané. - Les endpoints mock n’ont pas de consumer :
From("mock:x")échoue.
AdviceWith substitue les URI exactes des producers statiques To(), y compris le multicast
To(a, b) et les branches Choice / LoadBalancer / Saga. Il ne substitue pas l’endpoint
From(), les templates ToD ni les autres envois dynamiques (RecipientList, RoutingSlip,
DynamicRouter, WireTap, Enrich, DeadLetterChannel). Les URI inconnues sont ignorées ; la
substitution est une passe unique non transitive. Il renvoie une erreur tant que la route est
démarrée (il est de nouveau autorisé après Stop()).
Composants de Transfert de Fichiers
File
Opérations sur le système de fichiers local.
| Option | Type | Défaut | Description |
|---|---|---|---|
delete | bool | false | Supprimer après traitement |
noop | bool | false | Ne pas déplacer/supprimer le fichier |
include | string | "" | Motif d’inclusion de fichiers |
exclude | string | "" | Motif d’exclusion de fichiers |
preMove | string | "" | Déplacer le fichier avant traitement |
move | string | "" | Répertoire où déplacer le fichier après traitement |
moveFailed | string | "" | Répertoire où déplacer le fichier en cas d’échec |
readLock | string | changed | Stratégie de verrouillage (none, changed, rename, markerFile) |
readLockTimeout | Duration | 10s | Délai maximal d’attente pour acquérir le verrou |
readLockCheckInterval | Duration | 100ms | Intervalle entre les vérifications du verrou |
readLockMinLength | int64 | 0 | Taille minimale du fichier en octets |
Un répertoire move / moveFailed relatif est résolu à côté du fichier
consommé : avec From("file:///data/in?move=.done"), /data/in/a.txt aboutit
dans /data/in/.done/a.txt. Un répertoire absolu est utilisé tel quel. Les
fichiers présents dans ces répertoires ne sont jamais reconsommés, y compris
avec recursive=true.
Les fichiers déjà présents au démarrage de la route sont consommés en
arrière-plan : Start() n’attend pas la fin de l’arriéré.
| readLockMinAge | Duration | 0 | Âge minimal du fichier |
| maxSeenEntries | int | 100000 | Fichiers mémorisés pour ignorer les événements en double ; les plus anciens sont évincés en premier (0 = illimité) |
| fileExist | string | Override | Comportement si le fichier destination existe (Override, Append, Fail, Ignore) |
En-têtes
Définis par le Consumer
CamelFileName: Nom relatif du fichierCamelFilePath: Chemin absolu ou complet du fichierCamelFileLength: Taille du fichier en octetsCamelFileLastModified: Date et heure de dernière modification (time.Time)
Consommés par le Producer
CamelFileName: Surcharge le nom du fichier lorsque l’URI cible pointe vers un répertoire. Doit être un chemin relatif : nom vide, chemin absolu, volume Windows et composants..qui sortent du répertoire de l’endpoint sont rejetés.
Le consumer ignore les liens symboliques et refuse les fichiers de plus de 32 Mio
(DefaultMaxBodySize).
Verrou de lecture (Read Lock)
GoCamel fournit plusieurs stratégies de verrou de lecture pour s’assurer que les fichiers sont complètement écrits et exclusifs avant traitement :
readLock=changed: Le consumer échantillonne la taille et la date de modification surreadLockCheckIntervalet lit dès que deux échantillons consécutifs coïncident dans la limite dereadLockTimeout.readLock=rename: Renomme temporairement le fichier sous un nom exclusif (.camelExclusiveReadLock) pendant le traitement.readLock=markerFile: Crée un fichier marqueur.camelLockpendant le traitement et le supprime une fois terminé.readLock=none: Désactive toute vérification de verrou.
Préférez un passage de relais atomique
Le verrou de lecture changed est une heuristique : un écrivain qui s’interrompt plus
longtemps que l’intervalle d’échantillonnage en cours d’écriture peut encore
être observé comme stable. Pour un passage de relais garanti, faites écrire
le producteur sous un nom temporaire puis effectuez un rename vers le
répertoire surveillé — le rename est atomique.
FTP / FTPS
Transfert de fichiers via le protocole FTP.
Variables d’environnement :
FTP_USERNAME- Nom d’utilisateurFTP_PASSWORD- Mot de passe
| Option | Type | Défaut | Description |
|---|---|---|---|
username | string | "" | Nom d’utilisateur FTP |
password | string | "" | Mot de passe FTP |
binary | bool | true | Mode de transfert binaire |
passiveMode | bool | true | Utiliser le mode passif |
maxMessageSize | int | 0 | Taille max d’un fichier pollé en octets (0 = illimité) |
readLock | string | none | Stratégie de verrou (none, changed, rename, markerFile) |
readLockTimeout | Duration | 10s | Délai maximal d’attente pour acquérir le verrou |
readLockCheckInterval | Duration | 1s | Intervalle entre les vérifications du verrou |
readLockMinLength | int64 | 0 | Taille minimale du fichier en octets |
readLockMinAge | Duration | 0 | Âge minimal du fichier |
Avec fileExist=Append, le producer télécharge le fichier distant existant
puis renvoie l’envoi de la concaténation. Un téléchargement partiel fait
échouer l’envoi plutôt que de renvoyer silencieusement un contenu tronqué.
Lorsque le chemin de l’URI est un répertoire, CamelFileName est joint avec
JoinRemotePath : noms absolus et traversée de répertoires sont rejetés.
SFTP
Transfert de fichiers sécurisé via SSH.
Méthodes d’authentification :
- Par mot de passe : via le paramètre
passwordou la variable d’environnementSFTP_PASSWORD - Par clé : via le paramètre
privateKeyFileouSFTP_PRIVATE_KEY_FILE
| Option | Type | Défaut | Description |
|---|---|---|---|
username | string | "" | Nom d’utilisateur SSH |
password | string | "" | Mot de passe SSH |
privateKeyFile | string | "" | Chemin vers la clé privée |
privateKeyPassphrase | string | "" | Phrase secrète de la clé privée |
maxMessageSize | int | 0 | Taille max d’un fichier pollé en octets (0 = illimité) |
readLock | string | none | Stratégie de verrou (none, changed, rename, markerFile) |
readLockTimeout | Duration | 10s | Délai maximal d’attente pour acquérir le verrou |
readLockCheckInterval | Duration | 1s | Intervalle entre les vérifications du verrou |
readLockMinLength | int64 | 0 | Taille minimale du fichier en octets |
readLockMinAge | Duration | 0 | Âge minimal du fichier |
Comme pour FTP, fileExist=Append concatène au fichier distant existant et
fait échouer l’envoi si sa lecture échoue en cours de route. CamelFileName
est confiné comme pour FTP (JoinRemotePath).
SMB
Accès aux partages Windows/Samba.
| Option | Type | Défaut | Description |
|---|---|---|---|
username | string | "" | Nom d’utilisateur du domaine |
password | string | "" | Mot de passe du domaine |
share | string | requis | Nom du partage |
maxMessageSize | int | 0 | Taille max d’un fichier pollé en octets (0 = illimité) |
readLock | string | none | Stratégie de verrou (none, changed, rename, markerFile) |
readLockTimeout | Duration | 10s | Délai maximal d’attente pour acquérir le verrou |
readLockCheckInterval | Duration | 1s | Intervalle entre les vérifications du verrou |
readLockMinLength | int64 | 0 | Taille minimale du fichier en octets |
readLockMinAge | Duration | 0 | Âge minimal du fichier |
La sémantique de fileExist=Append est identique à celle de FTP/SFTP.
CamelFileName est confiné avec JoinRemotePath (noms absolus et ..
rejetés ; le producer n’utilise pas filepath.Join, qui jetterait le chemin
du partage si le header était absolu).
Composants Réseau
HTTP
Support serveur et client HTTP.
Le scheme https est producer uniquement. From("https://...") échoue à
la création du consumer : le listener est du HTTP en clair. Terminez le TLS
devant un consumer http:// (reverse proxy, HTTPComponent.SetMiddleware, etc.).
Plusieurs routes peuvent écouter sur le même host:port avec des chemins
différents : les consumers d’un même HTTPComponent partagent le listener, qui
est fermé à l’arrêt du dernier. Servir deux fois le même chemin sur un port
échoue au démarrage.
Headers posés par le consumer
| Header | Source |
|---|---|
CamelHttpMethod | Méthode de la requête (GET, POST, …) |
CamelHttpPath | Chemin de l’URL |
CamelHttpQuery | Query string brute |
CamelHttpUrl | url.URL.String() de la requête |
Le producer envoie en POST sauf si CamelHttpMethod est posé sur
l’exchange (un pont From(http).To(http) transmet donc la méthode entrante).
Les headers de la requête entrante sont aussi copiés sur l’exchange (voir headers de réponse ci-dessous).
Authentification, TLS, limitation de débit (middleware consumer)
Le consumer HTTP est livré sans authentification. Ne l’exposez à un réseau non fiable
que derrière un middleware qui applique le modèle de sécurité dont vous avez besoin
(vérification de token, mTLS, OAuth, allowlist d’IP, rate limit, …). Installez le
middleware sur le HTTPComponent avant le démarrage de la route :
Le middleware enveloppe chaque handler installé par un consumer http:// dans ce
contexte. Il s’exécute pour les requêtes routées vers un consumer ; un chemin
qu’aucun consumer ne sert répond 404 sans passer par lui.
Sanitisation des headers sortants
Le producer HTTP (To) et le chemin de réponse du consumer rejettent les noms et
valeurs de header contenant \r ou \n (CRLF) pour empêcher le HTTP response
splitting (CWE-113). Un exchange qui tente de définir un tel header reçoit une
erreur de la part de Send().
Headers de réponse
Le corps de la réponse provient de Out (ou de In si aucun Out n’a été
défini, selon la sémantique InOut de Camel). Les corps []byte et string
sont écrits tels quels ; tout autre corps non nil est écrit en utilisant sa
représentation %v.
Comme le consumer copie tous les headers de la requête entrante sur l’exchange,
une route qui ne définit pas Out répondrait avec les headers de la requête
elle-même. Deux filtres l’en empêchent :
- Les headers entrants inchangés ne sont pas renvoyés. Un header qui
revient identique à celui reçu est écarté :
CookieetAuthorizationne sont donc jamais réfléchis vers le client. Un header posé ou modifié par la route est toujours émis.Content-Typefait exception : il décrit le corps de la réponse et est toujours émis, si bien qu’une route qui répond du JSON à une requête JSON garde sonapplication/json(et une route qui ne le pose pas renvoie celui de la requête). - Les headers hop-by-hop et de cadrage ne sont jamais émis (
Connection,Keep-Alive,Transfer-Encoding,Content-Length,Host, …). Renvoyer leContent-Lengthde la requête corrompait le cadrage de la réponse. - Les headers internes
Camel*ne franchissent jamais la frontière HTTP. Ils ne sont pas émis dans la réponse (CamelHttpQueryrenvoyait les secrets de la query string etCamelFileNamedes chemins internes), et un client ne peut pas les poser sur l’exchange : les headers de requête commençant parCamelsont ignorés.
Un header contenant un []string est émis comme header répété (par exemple
plusieurs Set-Cookie). Symétriquement, le producer stocke un header de
réponse répété sous forme de []string sur Out ; les headers à valeur
unique restent des string.
Le même filtre s’applique au producer : un pont From(http://...) →
To(http://...) ne transmet donc pas le Content-Length ni le Host entrants
au service amont. Les headers propres aux réponses (Set-Cookie, Server,
WWW-Authenticate, Location, ETag, Status-Code…) ne sont pas envoyés
non plus : dans To("http://a").To("http://b"), les headers de réponse de a
restent sur le message et parvenaient à b, ce qui transmettait le cookie de
session de a à un autre service.
Le producer n’envoie jamais les headers internes Camel* au service amont. Il
transmet les autres headers, avec une exception pour les identifiants : les
valeurs Authorization et Cookie envoyées par un client au consumer HTTP ne
sont pas relayées telles quelles vers l’amont, afin qu’un pont
From(http://...) → To(http://...) ne fasse pas fuiter les identifiants d’un
client vers un tiers. Un identifiant posé par la route elle-même (par exemple
un jeton de service) est toujours envoyé. Pour un proxy qui doit volontairement
relayer l’authentification du client, activez l’option :
Pour retirer Authorization et Cookie de toutes les requêtes sortantes du
composant, y compris celles posées par la route :
Corps de la requête. Le producer envoie les corps []byte, string et
io.Reader ; un corps nil n’envoie aucun contenu. Tout autre type (map,
struct) est rejeté avec une erreur au lieu d’être envoyé silencieusement comme
un corps vide : sérialisez-le d’abord (par exemple MarshalJSON).
Statut de la réponse
Une route fixe le code de statut via le header CamelHttpResponseCode sur le
message de réponse (l’ancien header Status-Code reste accepté). Les valeurs
hors de 100–599 sont ignorées :
Gestion des erreurs du producer
Une réponse amont de statut ≥ 300 est une erreur (comportement par défaut
d’Apache Camel). L’erreur enveloppe gocamel.ErrHTTPStatus, et le corps ainsi
que les headers de la réponse restent publiés sur Out pour inspection :
Pour considérer toute réponse comme un succès et traiter le statut soi-même :
Le producer renseigne également CamelHttpResponseCode (int) et
CamelHttpResponseText (ex. "500 Internal Server Error") sur Out.
Durcissement
Le serveur embarqué définit un
ReadHeaderTimeoutde 10 secondes (attaques d’en-têtes lents), unReadTimeoutde 60 secondes (attaques de corps lents) et unIdleTimeoutde 60 secondes (connexions keep-alive inactives).Les corps de requête et de réponse sont lus au travers d’une limite de taille —
DefaultMaxBodySize(32 Mio) — afin qu’une charge utile surdimensionnée ne puisse pas épuiser la mémoire du processus (CWE-400). Une requête trop volumineuse reçoit un413 Request Entity Too Large. Ajustez ou désactivez la limite par composant :Les erreurs de route ne sont pas renvoyées au client : le handler répond par un
500 internal server errorgénérique et journalise le détail, qui peut contenir du texte SQL, des chemins de fichiers ou des messages de driver.
Arrêt
La goroutine du consumer est suivie par un WaitGroup interne et Stop()
attend que http.Server.Shutdown se termine (borné par un délai interne de
30 secondes) avant de retourner. Stop() est idempotent.
Net (TCP/UDP)
Sockets TCP et UDP bruts, construits sur la bibliothèque standard — l’équivalent
Go des composants netty/mina d’Apache Camel. Le consumer écoute et alimente
la route avec les messages entrants ; le producer se connecte et envoie le
corps du message.
| Option | Type | Défaut | Description |
|---|---|---|---|
sync | bool | true | Requête-réponse : le consumer renvoie la réponse de la route au pair ; le producer attend une réponse |
textline | bool | true | Messages délimités par saut de ligne (TCP uniquement) : requêtes et réponses se terminent par \n. false = un message par lecture |
bufferSize | int | 8192 | Taille maximale d’un message/datagramme en octets |
timeout | int | 30000 | Délai d’attente de connexion/réponse du producer en ms (0 = aucun) |
keepAlive | bool | false | Keepalive TCP sur les connexions |
readTimeout | int | 60000 | Délai de lecture du consumer en ms (0 = aucun) |
maxConnections | int | 1024 | Nombre maximal de connexions TCP simultanées du consumer (0 = illimité) ; les connexions en trop sont fermées immédiatement |
Formes d’URI — net:tcp://hôte:port et net:tcp:hôte:port sont acceptées ;
idem pour udp. Un hôte omis prend la valeur localhost. Le port 0 demande
un port éphémère à l’OS : lisez l’adresse réellement liée via
NetConsumer.Address().
Cadrage. TCP est un flux d’octets : le composant a donc besoin d’une limite
de message. Avec textline=true (défaut), chaque ligne terminée par un saut
de ligne est un message (le \r\n ou \n final est retiré). Le producer
ajoute un \n à une requête qui n’en a pas et lit sa réponse jusqu’au \n
suivant ; le consumer termine chaque réponse par \n de la même façon, de
sorte qu’un producer et un consumer GoCamel dialoguent avec les options par
défaut. Avec textline=false, chaque lecture est un message. Les datagrammes UDP n’ont
pas besoin de cadrage : chaque datagramme est un message.
Headers. Le consumer définit CamelNetRemoteAddress et
CamelNetLocalAddress (hôte:port) sur le message In.
Durcissement
- Les lectures de messages sont bornées par
bufferSize. Un message textline plus long que la limite est une erreur de protocole : la connexion est fermée plutôt que de mettre en tampon des données illimitées (CWE-400). Les datagrammes UDP plus grands que la limite sont tronqués. - La lecture de la réponse du producer en mode sync est bornée par
bufferSizeet par le délaitimeout, afin qu’un pair muet ne puisse pas bloquer la route indéfiniment. - Le consumer fixe un
readTimeout(défaut 60 s) sur chaque connexion afin qu’un client de type slowloris ne puisse pas monopoliser une goroutine indéfiniment ; mettez-le à0pour le désactiver. maxConnections(défaut 1024) borne le nombre de connexions TCP simultanées, afin qu’un afflux de clients ne puisse pas épuiser les descripteurs de fichiers du processus.- Une erreur transitoire d’
Accept(commeEMFILE, trop de fichiers ouverts) n’arrête plus le consumer : il journalise un avertissement et réessaie avec un délai croissant plafonné à une seconde, commenet/http.Server. - Les paniques dans les processeurs de route sont contenues
(
ProcessSafely) : une route défectueuse échoue son exchange, jamais le consumer.
Composants de Messagerie
Telegram
Intégration de l’API Telegram Bot pour la réception et l’envoi de messages.
Variables d’environnement :
TELEGRAM_AUTHORIZATIONTOKEN- Token de l’API Bot
| Option | Type | Défaut | Description |
|---|---|---|---|
authorizationToken | string | env var | Token de l’API Bot |
NATS
Messagerie asynchrone orientée événements avec NATS. Publisher et subscriber haute performance avec le client Go NATS.
Avertissement
Lors de l’écriture des URIs, utilisez toujours des doubles barres obliques (ex. nats://orders) au lieu de nats:orders, sinon url.Parse traite l’URI comme une URI opaque, ce qui contamine la chaîne du sujet avec les paramètres de requête.
| Option | Type | Défaut | Description |
|---|---|---|---|
servers | string | nats://127.0.0.1:4222 | Adresses des serveurs NATS (séparées par virgules) |
subject | string | parsé depuis le chemin | Sujet NATS pour la subscription/publication |
Headers d’Exchange :
CamelNATSSubject- Sujet du message reçu ou sujet cible pour la publication.
Kafka
Diffusion d’événements distribuée à haut débit avec Apache Kafka via segmentio/kafka-go (pur Go).
| Option | Type | Défaut | Description |
|---|---|---|---|
brokers | string | localhost:9092 | Adresses des brokers Kafka séparées par des virgules |
groupId | string | "" | Identifiant du consumer group Kafka |
partition | int | -1 | Partition cible (hors consumer group) |
clientId | string | "" | Identifiant client |
allowHeaderOverride | bool | false | Autorise CamelKafkaTopic, CamelKafkaPartitionKey et CamelKafkaKey à remplacer l’URI en production |
forwardHeaders | string | "" | Liste de noms de headers (séparés par des virgules) propagés comme headers de record Kafka ; si définie, SEULS ces headers sont propagés |
maxRedeliveries | int | 10 | Consommateur : nombre de redélivraisons d’un message dont la route échoue avant de le journaliser et de l’acquitter malgré tout (-1 = réessai sans fin, 0 = acquittement dès le premier échec) |
redeliveryDelay | int | 100 | Consommateur : délai de la première redélivraison en ms, doublé à chaque tentative |
maxRedeliveryDelay | int | 30000 | Consommateur : plafond du backoff de redélivraison en ms |
Headers d’Exchange :
CamelKafkaTopic- Surcharge (avecallowHeaderOverride=true) ou lecture du topic cible.CamelKafkaPartitionKey/CamelKafkaKey- Clé de partitionnement Kafka (honorée avecallowHeaderOverride=true).CamelKafkaPartition- Index de la partition.CamelKafkaOffset- Offset du message.CamelKafkaTimestamp- Horodatage du message.
⚠️ Sécurité : le topic et la clé configurés dans l’URI constituent une configuration de confiance. Les surcharges par headers sont ignorées sauf si l’endpoint active explicitement
allowHeaderOverride=true. Ne l’activez que si les headers ne peuvent pas être influencés par une entrée non fiable.Les headers sortants de l’exchange sont filtrés avant d’atteindre le broker :
Authorization,Cookie,Proxy-Authorization,Set-CookieetWWW-Authenticate(insensible à la casse) ne sont jamais propagés, afin qu’un producteur en aval du consommateur HTTP ne fuite pas les identifiants du client. DéfinissezforwardHeaderspour une liste explicite si vous souhaitez un contrôle plus strict.Les headers de record entrants nommés
Camel*(insensible à la casse) sont ignorés par le consommateur : quiconque peut écrire dans le topic ne doit pas piloter des headers internes commeCamelFileNameouCamelHttpMethod.
Quand un groupId est configuré, chaque message traité avec succès est
committé auprès du groupe de consommateurs. Un échec de commit est journalisé
(avec topic/partition/offset) plutôt qu’ignoré silencieusement : le message
sera redélivré après un rééquilibrage ou un redémarrage, et la ligne de journal
est le seul signal de ce traitement dupliqué.
STOMP
Production et consommation de messages avec tout broker compatible STOMP 1.0/1.1/1.2 — ActiveMQ, ActiveMQ Artemis, RabbitMQ, Apollo — via le client go-stomp. Idéal pour les destinations JMS de type file (/queue/...) et topic (/topic/...).
| Option | Type | Défaut | Description |
|---|---|---|---|
host | string | localhost:61613 | Adresse du broker host:port (connecteur STOMP ActiveMQ) |
destination | string | analysée depuis le chemin | Destination STOMP (/queue/..., /topic/...) |
login | string | "" | Identifiant envoyé dans la trame CONNECT STOMP |
passcode | string | "" | Mot de passe envoyé dans la trame CONNECT STOMP (préférez la variable d’environnement STOMP_PASSCODE) |
ack | string | auto | Mode d’accusé de réception : auto, client, client-individual (consommateur uniquement) |
allowHeaderOverride | bool | false | Autorise CamelStompDestination à remplacer l’URI en production |
forwardHeaders | string | "" | Liste de noms de headers (séparés par des virgules) propagés comme headers de trame STOMP ; si définie, SEULS ces headers sont propagés |
maxRedeliveries | int | 10 | Consommateur : nombre de redélivraisons d’un message dont la route échoue avant de le journaliser et de l’acquitter malgré tout (-1 = réessai sans fin, 0 = acquittement dès le premier échec) |
redeliveryDelay | int | 100 | Consommateur : délai de la première redélivraison en ms, doublé à chaque tentative |
maxRedeliveryDelay | int | 30000 | Consommateur : plafond du backoff de redélivraison en ms |
connectTimeout | durée | 30s | Délai maximal de la connexion TCP et des handshakes TLS et STOMP. Le consommateur se reconnecte et se réabonne (backoff de 100 ms à 5 s) en cas de perte de connexion au broker ou de frame ERROR |
ssl | bool | false | Connexion au broker via TLS |
sslCAFile | string | racines système | Fichier PEM de l’autorité de certification vérifiant le certificat du broker |
sslCertFile | string | "" | Fichier PEM du certificat client pour le TLS mutuel (nécessite sslKeyFile) |
sslKeyFile | string | "" | Fichier PEM de la clé privée client pour le TLS mutuel (nécessite sslCertFile) |
sslServerName | string | hôte du broker | Nom du serveur utilisé pour le SNI et la vérification du certificat |
sslInsecureSkipVerify | bool | false | Désactive la vérification du certificat du broker (environnements contrôlés uniquement) |
Headers d’Exchange :
CamelStompDestination- Destination d’origine du message reçu, ou destination cible en production (honorée avecallowHeaderOverride=true).CamelStompContentType- Type MIME envoyé avec le message ou reçu du broker.
⚠️ Sécurité : la destination configurée dans l’URI constitue une configuration de confiance. Les surcharges par headers sont ignorées sauf si l’endpoint active explicitement
allowHeaderOverride=true. Ne l’activez que si les headers ne peuvent pas être influencés par une entrée non fiable.Les headers sortants de l’exchange sont filtrés avant d’atteindre le broker :
Authorization,Cookie,Proxy-Authorization,Set-CookieetWWW-Authenticate(insensible à la casse) ne sont jamais propagés, afin qu’un producteur en aval du consommateur HTTP ne fuite pas les identifiants du client. DéfinissezforwardHeaderspour une liste explicite si vous souhaitez un contrôle plus strict.Les headers de trame entrants nommés
Camel*(insensible à la casse) sont ignorés par le consommateur : un client qui envoie vers la destination ne doit pas piloter des headers internes commeCamelFileNameouCamelHttpMethod.
Avec ack=client ou ack=client-individual, un message n’est accusé reçu
qu’après que la route l’ait traité avec succès ; un échec de traitement est
retenté (voir maxRedeliveries) avant tout accusé de réception, le broker redélivre donc le message si
la connexion tombe entre-temps. Avec ack=auto (défaut), le broker considère
le message comme délivré dès son envoi.
SSL/TLS : activez ssl=true pour vous connecter au broker via TLS (par
exemple le connecteur STOMP+SSL d’ActiveMQ sur le port 61614). Le certificat
du serveur est vérifié contre les racines système par défaut, ou contre le
fichier CA fourni via sslCAFile. Le TLS mutuel utilise
sslCertFile/sslKeyFile. La configuration TLS est validée à la création de
l’endpoint : un fichier CA manquant ou une paire de clés invalide échoue
immédiatement.
Avertissement
sslInsecureSkipVerify=true désactive la vérification du certificat du
serveur et expose la connexion à des attaques de l’homme du milieu. Ne
l’utilisez que dans des environnements contrôlés (développement local,
bancs de test).
gRPC
Intégration client et serveur RPC haute performance via google.golang.org/grpc.
| Option | Type | Défaut | Description |
|---|---|---|---|
service | string | parsé depuis le chemin | Nom complet du service gRPC |
method | string | parsé depuis le chemin | Nom de la méthode RPC |
insecure | bool | true | Utiliser un transport texte en clair sans TLS ; à false, TLS 1.2+ est utilisé avec le pool de CA système |
caCert | string | "" | Chemin d’un certificat CA au format PEM approuvé pour la vérification du serveur quand insecure=false (ex. serveur auto-signé) |
forwardHeaders | string | "" | Liste de noms de headers (séparés par des virgules) propagés comme métadonnées RPC sortantes ; si définie, SEULS ces headers sont propagés |
Headers d’Exchange :
CamelGrpcMethod- Méthode gRPC invoquée.CamelGrpcStatusCode- Code d’état gRPC (ex: 0 pour OK).CamelGrpcStatusDescription- Message descriptif du statut gRPC.
⚠️ Sécurité : les headers sortants de l’exchange sont filtrés avant d’être envoyés comme métadonnées RPC :
Authorization,Cookie,Proxy-Authorization,Set-CookieetWWW-Authenticate(insensible à la casse) ne sont jamais propagés, afin qu’un producteur en aval du consommateur HTTP ne fuite pas les identifiants du client. DéfinissezforwardHeaderspour une liste explicite si vous souhaitez un contrôle plus strict.
Redis
Envoi de commandes (SET, GET, DEL, PUBLISH) ou abonnement aux canaux Redis Pub/Sub.
Commandes supportées :
SET: Enregistre le corps de l’exchange comme valeur dekey.GET: Récupère la valeur dekeyet l’écrit dansOut.Body.DEL: Supprimekeyet écrit le nombre de clés affectées dansOut.Body.PUBLISH: Publie le corps de l’exchange vers le canal/clé spécifié.
Headers d’Exchange (surcharge des paramètres URI) :
CamelRedisCommand- La commande Redis à exécuter (ex."GET").CamelRedisKey- La clé Redis cible.CamelRedisChannel- Canal Pub/Sub cible pour la publication ou canal source pour l’abonnement.
| Option | Type | Défaut | Description |
|---|---|---|---|
command | string | SET | Commande Redis pour le producer |
key | string | "" | Clé Redis sur laquelle opérer |
channel | string | "" | Canal Redis Pub/Sub |
subscribe | bool | false | Si true, agit comme un consumer Pub/Sub |
Dépôt Idempotent Redis
Le Dépôt Idempotent Redis fournit une implémentation distribuée de l’interface IdempotentRepository, permettant à plusieurs instances GoCamel dans un cluster de se coordonner et d’éviter le traitement de messages dupliqués.
Go Channel
Composant d’intégration intra-processus natif et ultra-rapide utilisant les canaux Go natifs. Il permet de découpler les segments de route de manière asynchrone au sein du même processus.
| Option | Type | Défaut | Description |
|---|---|---|---|
bufferSize | int | 100 | Capacité du canal interne bufferisé |
shutdownTimeout | int | 30000 | Durée pendant laquelle Stop continue de traiter les exchanges en file, en ms (0 = les abandonner) |
Notes :
- Les endpoints sont mis en cache par nom de canal : chaque producer et consumer
utilisant le même nom partage un endpoint, et un seul consumer par canal est
autorisé (un second
From("chan:orders")échoue au démarrage). - Les options URI sont appliquées lorsque l’endpoint est créé pour la première fois ; les références ultérieures avec des options différentes émettent un avertissement et réutilisent l’endpoint existant.
- Le consumer traite chaque exchange sous son propre contexte, et non celui de l’émetteur : une requête HTTP qui a mis un message en file puis s’est terminée n’annule pas la partie asynchrone.
Stoprefuse les nouveaux envois, puis termine les exchanges déjà en file pendant au plusshutdownTimeoutavant d’annuler le reste (voir SEDA dans la page EIP).
Composants IA
OpenAI
Intégration de l’API OpenAI pour ChatGPT/GPT-4. Tout endpoint compatible
OpenAI est pris en charge via l’option baseURL (OpenRouter, Groq, Together,
Mistral, vLLM, LM Studio, couche de compatibilité OpenAI d’Ollama, …).
Utiliser un fournisseur compatible OpenAI :
Variables d’environnement :
OPENAI_AUTHORIZATIONTOKENouOPENAI_API_KEY- Clé API
| Option | Type | Défaut | Description |
|---|---|---|---|
model | string | gpt-3.5-turbo | Modèle à utiliser |
authorizationToken | string | variable d’env | Clé API (alias : apiKey) |
baseURL | string | https://api.openai.com/v1 | URL de base compatible OpenAI personnalisée (OpenRouter, Groq, …) |
Le timeout HTTP du SDK est de 60 secondes. Bornez davantage les appels
longs avec exchange.Context.
Anthropic
Intégration native de l’API Messages d’Anthropic (Claude). Contrairement au
composant OpenAI, c’est un connecteur dédié à la forme native de l’API
Claude — paramètre system séparé, blocs de contenu, en-têtes de cache de
prompt et raisons d’arrêt spécifiques.
Variables d’environnement :
ANTHROPIC_API_KEY- Clé API (recommandé plutôt que l’intégrer dans l’URI)
| Option | Type | Défaut | Description |
|---|---|---|---|
apiKey | string | variable d’env | Clé API (alias : authorizationToken). Masquée par RedactURI. |
model | string | requis | Nom du modèle, ex. claude-sonnet-4-5 |
maxTokens | int | 1024 | Nombre maximum de tokens à générer |
system | string | "" | Prompt système |
temperature | float | non défini | Température d’échantillonnage (0.0-1.0) |
baseURL | string | API Anthropic | URL de base personnalisée (proxies, passerelles). Doit être http(s). |
allowHeaderOverride | bool | false | Autorise les en-têtes de surcharge Anthropic* ci-dessous à remplacer la configuration de l’URI |
Le timeout HTTP du SDK est de 60 secondes.
En-têtes de surcharge par message (message In, pris en compte uniquement avec allowHeaderOverride=true) :
| En-tête | Type | Description |
|---|---|---|
AnthropicSystem | string | Surcharge le system de l’URI |
AnthropicModel | string | Surcharge le model de l’URI |
AnthropicMaxTokens | string | Surcharge le maxTokens de l’URI |
AnthropicTemperature | string | Surcharge le temperature de l’URI |
⚠️ Sécurité : le prompt système, le modèle, le budget de tokens et la température configurés dans l’URI sont de la configuration de confiance. Les en-têtes de surcharge sont ignorés sauf si l’endpoint l’autorise avec
allowHeaderOverride=true. Ne l’activez que lorsque les en-têtes ne peuvent pas être influencés par une entrée non fiable : un émetteur pourrait sinon remplacer le prompt système (injection de prompt) ou choisir un modèle et un budget de tokens plus coûteux.
En-têtes Out (définis sur la réponse) :
| En-tête | Type | Description |
|---|---|---|
AnthropicUsageInputTokens | int64 | Tokens d’entrée facturés |
AnthropicUsageOutputTokens | int64 | Tokens de sortie facturés |
AnthropicStopReason | string | end_turn, max_tokens, … |
AnthropicModel | string | Modèle ayant produit la réponse |
Jev (API Decisions d’OpenRouter)
Producer pour le modèle de décision TypeSafe Jev via l’API Decisions d’OpenRouter. Jev lit le langage naturel comme un LLM mais renvoie des jugements typés (probabilités, choix, scores) au lieu de texte généré ; les seuils de décision restent dans votre route. Le module n’a aucune dépendance tierce.
Le corps de l’exchange est l’état à juger (string, []byte ou toute valeur
sérialisable en JSON). Le corps Out est un map[string]jev.Answer indexé par
identifiant de question. Answer.Type vaut noul (renseigne Noul), choice
(Choice, Probabilities, Confidence) ou score (Value, Legend, Confidence).
Variables d’environnement :
OPENROUTER_API_KEY- clé API (recommandé plutôt que de l’inclure dans l’URI)
| Option | Type | Défaut | Description |
|---|---|---|---|
apiKey | string | variable d’env | Clé API (alias : authorizationToken). Masquée par RedactURI. |
questions | JSON | requis* | Objet associant identifiants de questions et questions Jev, envoyé tel quel |
model | string | typesafe/jev-1.13 | Modèle Jev |
baseURL | string | https://openrouter.ai/api/alpha | Racine de l’API (proxies, tests). Doit être http(s). |
timeout | duration | 30s | Délai maximal par requête |
allowHeaderOverride | bool | false | Autorise les en-têtes Jev* à remplacer la configuration de l’URI |
* Facultatif avec allowHeaderOverride=true et l’en-tête JevQuestions.
En-têtes de surcharge (message In, pris en compte uniquement avec allowHeaderOverride=true) :
JevQuestions (chaîne JSON ou map) et JevModel.
⚠️ Sécurité : les questions et le modèle sont une configuration de confiance. N’activez la surcharge que si les en-têtes ne peuvent pas être influencés par une entrée non fiable.
En-têtes Out : JevModel (modèle utilisé), JevElapsed (time.Duration, durée de l’appel).
Ollama
Intégration native avec un serveur Ollama local via son
client Go officiel (github.com/ollama/ollama/api). Trois modes sont
sélectionnés par le chemin de l’URI :
ollama:chat(défaut) — API de chat multi-tours (/api/chat)ollama:generate— génération one-shot (/api/generate)ollama:embed— embeddings (/api/embed)
Générer des embeddings localement :
Variables d’environnement :
OLLAMA_HOST- hôte par défaut lorsque l’option URIhostest omise
| Option | Type | Défaut | Description |
|---|---|---|---|
model | string | requis (chat/generate) | Nom du modèle |
host | string | http://localhost:11434 | URL de base du serveur Ollama (doit être http(s)) |
system | string | "" | Prompt système (mode generate uniquement) |
keepAlive | durée | non défini | Rétention du modèle en mémoire (ex. 5m, 30s) |
think | string | non défini | Effort de raisonnement : true/false/low/medium/high/max |
format | string | non défini | Format de sortie structuré (ex. json) |
allowHeaderOverride | bool | false | Autorise les en-têtes OllamaModel et OllamaSystem à remplacer la configuration de l’URI |
En-têtes de surcharge par message (message In, pris en compte uniquement avec allowHeaderOverride=true) :
| En-tête | Type | Description |
|---|---|---|
OllamaModel | string | Surcharge le model de l’URI |
OllamaSystem | string | Surcharge le system de l’URI (chat/generate) |
⚠️ Sécurité : le modèle et le prompt système configurés dans l’URI sont de la configuration de confiance. Les en-têtes de surcharge sont ignorés sauf si l’endpoint l’autorise avec
allowHeaderOverride=true. Ne l’activez que lorsque les en-têtes ne peuvent pas être influencés par une entrée non fiable : un émetteur pourrait sinon remplacer le prompt système (injection de prompt) ou choisir un autre modèle.
En-têtes Out (définis sur la réponse) :
| En-tête | Type | Description (chat/generate) |
|---|---|---|
OllamaModel | string | Modèle ayant produit la réponse |
OllamaDoneReason | string | stop, length, … |
OllamaTotalDuration | int64 | Durée totale (ns) |
OllamaPromptEvalCount | int | Tokens d’entrée évalués |
OllamaEvalCount | int | Tokens de sortie générés |
Le composant Ollama n’expose pas les opérations de cycle de vie des modèles (Pull/List/Delete). Utilisez la CLI
ollamaou l’API HTTP directement pour la gestion des modèles ; le producer GoCamel est limité à l’inférence.
Composants d’Ordonnancement
Cron
Ordonnancement avancé avec expressions cron ou intervalles simples.
Format d’expression cron (6 champs) :
| Option | Type | Défaut | Description |
|---|---|---|---|
cron | string | "" | Expression cron à 6 champs |
trigger.repeatInterval | int | "" | Intervalle en ms (déclencheur simple) |
trigger.repeatCount | int | -1 | Nombre maximum de répétitions |
triggerStartDelay | int | 500 | Délai initial en ms |
stateful | bool | false | Empêcher l’exécution concurrente |
Headers d’Exchange :
fireTime- Heure d’exécution du déclencheurnextFireTime- Prochaine heure planifiéetriggerName- Identifiant du déclencheur
À l’appel de Stop(), un job dont le triggerStartDelay n’est pas encore
écoulé n’est jamais enregistré sur le scheduler partagé : la demande d’arrêt
gagne la course avec l’enregistrement différé, aucun job orphelin ne peut donc
rester à se déclencher indéfiniment.
Composants de Messagerie Électronique
SMTP/SMTPS (Envoi)
Envoi d’emails via SMTP.
| Option | Type | Défaut | Description |
|---|---|---|---|
username | string | "" | Nom d’utilisateur SMTP |
password | string | "" | Mot de passe SMTP |
to | string | "" | Destinataire(s) |
subject | string | "" | Sujet de l’email |
contentType | string | "text/plain" | Type MIME |
IMAP/IMAPS (Réception)
Réception d’emails via IMAP avec support IDLE.
| Option | Type | Défaut | Description |
|---|---|---|---|
username | string | "" | Nom d’utilisateur IMAP |
password | string | "" | Mot de passe IMAP |
folderName | string | "INBOX" | Dossier à surveiller |
unseen | bool | true | Messages non lus uniquement |
idle | bool | false | Utiliser le mode IMAP IDLE |
delete | bool | false | Supprimer après traitement |
fetchSize | int | -1 | Messages par interrogation |
pollDelay | int | 60000 | Intervalle d’interrogation (ms) |
maxMessageSize | int | 0 | Taille max d’un message en octets (0 = illimité) |
POP3/POP3S (Réception)
Réception d’emails via POP3.
Le consumer POP3 accepte la même option maxMessageSize qu’IMAP (défaut 0 =
illimité) pour borner la taille d’un message téléchargé.
Avec disconnect=false (défaut), la connexion POP3 est conservée entre les
polls, comme pour le consumer IMAP. Définissez disconnect=true pour vous
ré-authentifier à chaque poll (utile avec les serveurs qui coupent les
connexions inactives).
Composants de Base de Données
SQL
Exécution de requêtes SQL via database/sql.
Format d’URI :
| Option | Type | Défaut | Description |
|---|---|---|---|
query | string | requis | Chaîne de requête SQL |
dataSourceRef | string | chemin hôte | Nom de la datasource |
outputType | string | SelectList | SelectList ou SelectOne |
batch | bool | false | Mode d’exécution par lot |
transacted | bool | false | Encapsuler dans une transaction |
allowHeaderOverride | bool | false | Autoriser CamelSqlQuery à remplacer la requête |
Paramètres de requête :
Fournis via le header CamelSqlParameters ou le corps comme []any.
La requête est une configuration de confiance
La requête n’est jamais interpolée avec les données de l’Exchange :
substituer ${header.X} dans la chaîne SQL annulerait le bénéfice des
requêtes paramétrées et ouvrirait la porte à l’injection SQL. Liez toujours
les valeurs dynamiques via CamelSqlParameters (placeholders positionnels
?) ou un corps []any.
Le header CamelSqlQuery remplace la requête dans son intégralité :
depuis la v0.2 il est donc ignoré sauf si l’endpoint l’active avec
allowHeaderOverride=true. Ne l’activez que là où les headers ne peuvent
pas être influencés par une entrée non fiable — sinon tout composant
reportant des métadonnées externes sur les headers donne à l’appelant le
contrôle total de la requête.
Une instruction suivie d’une autre (SELECT 1; DROP TABLE t) est rejetée.
Selon la base, \' échappe ou non une apostrophe (MySQL : oui ; SQLite,
PostgreSQL : non) ; un ; hors littéral dans l’une ou l’autre lecture est
donc rejeté : échappez les apostrophes avec '', accepté partout.
Headers de sortie :
CamelSqlRowCount- Lignes retournées/affectéesCamelSqlColumnNames- Noms des colonnes (SELECT)
Corps du résultat :
| Cas | Type de Out.Body |
|---|---|
SELECT + SelectList | []map[string]any |
SELECT + SelectOne | map[string]any ou nil |
INSERT/UPDATE/DELETE | int64 (lignes affectées) |
Classification des requêtes :
Le choix entre exécution en lecture (jeu de résultats) et en écriture (lignes
affectées) se fait sur le premier mot-clé, en ignorant les commentaires et
parenthèses de tête. SELECT, WITH (CTE), VALUES, TABLE, SHOW,
EXPLAIN, DESCRIBE et PRAGMA renvoient des lignes, tout comme une requête
portant une clause RETURNING :
SQL-Stored
Exécution de procédures stockées avec support des paramètres IN, OUT et INOUT.
Format d’URI :
| Option | Type | Défaut | Description |
|---|---|---|---|
procedure | string | requis | Nom de la procédure stockée |
dataSourceRef | string | chemin hôte | Nom de la datasource |
outputType | string | SelectList | SelectList ou SelectOne |
transacted | bool | false | Exécuter dans une transaction |
noop | bool | false | Mode test (pas d’exécution) |
allowHeaderOverride | bool | false | Autoriser CamelSqlStoredProcedureName à remplacer le nom |
Le nom de procédure est un identifiant de confiance
Le nom de procédure est inséré dans la requête CALL et n’est jamais
interpolé avec les données de l’exchange. Le header
CamelSqlStoredProcedureName est ignoré sauf si l’endpoint opte avec
allowHeaderOverride=true ; dans ce cas, la valeur est validée contre un
motif d’identifiant strict ([A-Za-z_][A-Za-z0-9_.]*). N’activez la
surcharge que là où les headers ne peuvent pas être influencés par une entrée
non fiable.
Directions des paramètres :
| Direction | Description |
|---|---|
ParamDirectionIn | Entrée uniquement |
ParamDirectionOut | Sortie uniquement |
ParamDirectionInOut | Entrée et sortie |
Exemple :
MongoDB
Intégration MongoDB pour les opérations CRUD. Producer uniquement.
Format d’URI
Options
| Option | Type | Requis | Description |
|---|---|---|---|
database | string | Oui | Nom de la base de données |
collection | string | Oui | Nom de la collection |
operation | string | Oui | Opération : find, findOne, insert, insertOne, save, update, remove, count |
connectionRef | string | Non | Référence de connexion enregistrée |
allowDeleteAll | bool | Non | Autorise remove avec un filtre vide (défaut : false) |
allowUpdateAll | bool | Non | Autorise update avec un filtre vide, c’est-à-dire une mise à jour massive de toute la collection (défaut : false) |
allowHeaderOverride | bool | Non | Autorise CamelMongoDbDatabase, CamelMongoDbCollection, CamelMongoDbOperation et CamelMongoDbCriteria à remplacer la configuration de l’URI (défaut : false) |
maxResults | int | Non | Nombre maximal de documents renvoyés par un find (défaut : 10000, 0 = illimité). Au-delà, le résultat est tronqué, un avertissement est journalisé et CamelMongoDbResultsTruncated vaut true |
Par sécurité, remove refuse les filtres nuls ou vides. Définissez
allowDeleteAll=true explicitement uniquement si la suppression de toute la
collection est intentionnelle. De même, update refuse un filtre absent ou
vide (nil, {}, bson.M / bson.D vides, chaîne vide) : chacun
mettrait à jour tous les documents. Définissez allowUpdateAll=true
explicitement uniquement si c’est intentionnel.
⚠️ Sécurité : la base, la collection et l’opération configurées dans l’URI constituent une configuration de confiance. Les headers
CamelMongoDbDatabase,CamelMongoDbCollection,CamelMongoDbOperationetCamelMongoDbCriteriasont ignorés sauf si l’endpoint active explicitementallowHeaderOverride=true. Ne l’activez que si les headers ne peuvent pas être influencés par une entrée non fiable.
Headers d’entrée
| Header | Mode | Description |
|---|---|---|
CamelMongoDbDatabase | R/W | Nom de la base de données |
CamelMongoDbCollection | R/W | Nom de la collection |
CamelMongoDbOperation | R/W | Opération à exécuter |
CamelMongoDbCriteria | Écriture | Filtre/critère (map[string]any ou JSON) |
CamelMongoDbLimit | Écriture | Limite de résultats |
CamelMongoDbSkip | Écriture | Sauter N documents |
CamelMongoDbSort | Écriture | Ordre de tri (json: {“field”: 1}) |
Headers de sortie
| Header | Description |
|---|---|
CamelMongoDbResultTotal | Total des documents trouvés/affectés |
CamelMongoDbOid | ObjectID du document inséré |
CamelMongoDbResultsTruncated | true quand un find s’est arrêté à maxResults |
Exemple
Composants de Transformation
XSLT
Transformation XML via feuille de style XSL.
| Option | Type | Défaut | Description |
|---|---|---|---|
transformerFactory | string | "" | Classe de transformateur personnalisée |
XSD
Validation de schéma XML.
| Option | Type | Défaut | Description |
|---|---|---|---|
schemaResource | string | requis | Chemin du schéma XSD |
Template
Traitement de templates Go (inspiré d’Apache Camel Velocity).
| Option | Type | Défaut | Description |
|---|---|---|---|
contentCache | bool | false | Mettre en cache le template en mémoire |
allowTemplateFromHeader | bool | false | Autoriser la surcharge via le header CamelTemplatePath |
startDelimiter | string | {{ | Délimiteur de début |
endDelimiter | string | }} | Délimiteur de fin |
Variables de template :
Fonctions de template :
json encode n’importe quelle valeur (chaîne, nombre, map, slice) avec
encoding/json. Sa sortie échappe <, > et & : elle est donc sûre en HTML
comme dans une charge utile JSON. Dans un bloc <script>, écrivez plutôt
{{.Body}} : le moteur de templates y encode déjà les valeurs en JavaScript.
Le cache des templates compilés (contentCache) est indexé par chemin et
par délimiteurs.
Composants d’Exécution
Exec
Exécuter des commandes système.
| Option | Type | Défaut | Description |
|---|---|---|---|
args | string | "" | Arguments de la commande |
workingDir | string | "" | Répertoire de travail |
timeout | int | 0 | Délai d’attente en ms (0=pas de délai) |
outFile | string | "" | Lire le résultat depuis ce fichier au lieu de stdout |
useStderrOnEmpty | bool | false | Utiliser stderr comme corps quand stdout est vide |
allowHeaderOverride | bool | false | Autoriser les headers CamelExecCommand* à surcharger l’URI |
allowedExecutables | string | "" | Noms de commandes simples, séparés par des virgules, qu’un header CamelExecCommandExecutable peut choisir en plus de l’exécutable de l’URI |
maxOutputSize | int | 33554432 | Octets conservés de stdout et de stderr (32 Mio, 0 = illimité) ; le reste est ignoré |
Surcharges par message (opt-in) :
Quand allowHeaderOverride=true, ces headers surchargent les paramètres URI pour un seul message :
| Header | Surcharge |
|---|---|
CamelExecCommandExecutable | Exécutable |
CamelExecCommandArgs | Arguments |
CamelExecCommandWorkingDir | Répertoire de travail |
CamelExecCommandTimeout | Délai d’attente (ms) |
Sécurité
Les surcharges de header permettent à un message de choisir quel binaire est exécuté. Elles sont
désactivées par défaut ; n’activez allowHeaderOverride=true que lorsque les headers de message
ne peuvent pas être influencés par une entrée non fiable (ex. headers provenant d’un consumer
HTTP ou mail).
L’exécutable et le répertoire de travail sont validés contre les
métacaractères shell et le path traversal. Un exécutable fourni par header
doit en outre être un nom de commande simple (sans chemin, résolu via
PATH), et soit l’exécutable de l’URI, soit l’un de ceux listés dans
allowedExecutables ; tout autre est rejeté. Un nom simple ne suffisait pas :
sh ou python3 avec des arguments de header comme -c ... exécutent du
code arbitraire, ne listez donc jamais un shell ni un interpréteur. Les arguments ne le sont
pas : les commandes sont lancées via execve, sans shell, donc |, &,
$, < et > n’ont aucune signification particulière et parviennent
verbatim au processus fils — c’est précisément l’intention. Les rejeter
bloquait des valeurs légitimes (un document JSON, un mot de passe contenant
$, un chemin relatif) sans empêcher la moindre injection. Le caractère NUL
et les autres caractères de contrôle restent rejetés.
Sortie :
Out.Body= stdout de la commande (également recopié surInpour la rétrocompatibilité, afin qu’une route InOut voie la sortie de la commande)- Header
CamelExecExitValue= code de sortie - Headers
CamelExecStdout/CamelExecStderr= sortie brute de la commande - Header
CamelExecOutputTruncated=truequand stdout ou stderr a dépassémaxOutputSizeet a été tronqué (la commande s’exécute tout de même jusqu’au bout)
Configuration des Composants
Authentification
Les identifiants peuvent être fournis via des variables d’environnement :
Options communes
De nombreux composants partagent des options d’interrogation communes :
| Option | Type | Défaut | Description |
|---|---|---|---|
delay | Duration | varie | Intervalle d’interrogation |
include | string | "" | Motif d’inclusion |
exclude | string | "" | Motif d’exclusion |
Tableau Récapitulatif des Composants
| Composant | Catégorie | Consumer | Producer | Motif d’URI |
|---|---|---|---|---|
| Direct | Core | ✅ | ✅ | direct:name |
| Timer | Core | ✅ | ❌ | timer:name |
| File | Fichier | ✅ | ✅ | file://path |
| FTP | Fichier | ✅ | ✅ | ftp://host/path |
| SFTP | Fichier | ✅ | ✅ | sftp://host/path |
| SMB | Fichier | ✅ | ✅ | smb://host/share |
| HTTP | Réseau | ✅ | ✅ | http://host:port/path |
| Net | Réseau | ✅ | ✅ | net:tcp://host:port |
| Kafka | Messagerie | ✅ | ✅ | kafka:topic |
| gRPC | Réseau | ✅ | ✅ | grpc://host:port/Service/Method |
| Telegram | Messagerie | ✅ | ✅ | telegram:bots |
| OpenAI | IA | ❌ | ✅ | openai:chat |
| Anthropic | IA | ❌ | ✅ | anthropic:messages |
| Ollama | IA | ❌ | ✅ | ollama:chat/generate/embed |
| Jev | IA | ❌ | ✅ | jev:decisions |
| Cron | Ordonnancement | ✅ | ❌ | cron://group/job |
| SMTP | ❌ | ✅ | smtp://host:port | |
| IMAP | ✅ | ❌ | imap://host:port | |
| POP3 | ✅ | ❌ | pop3://host:port | |
| SQL | Base de données | ❌ | ✅ | sql://datasource |
| SQL-Stored | Base de données | ❌ | ✅ | sql-stored://datasource |
| MongoDB | Base de données | ❌ | ✅ | mongodb:connectionName |
| XSLT | Transformation | ❌ | ✅ | xslt:template |
| XSD | Transformation | ❌ | ✅ | xsd:schema |
| Template | Transformation | ❌ | ✅ | template:template |
| Exec | Exécution | ❌ | ✅ | exec:command |
| NATS | Messagerie | ✅ | ✅ | nats://subject |
| Redis | Messagerie | ✅ | ✅ | redis://host:port |
| Go Channel | Core | ✅ | ✅ | chan:channelName |
Détails de livraison et de cycle de vie
- Kafka / STOMP : un traitement en échec est réessayé avec un nouvel échange avant la lecture du record (Kafka) ou du message (STOMP) suivant, avec un backoff exponentiel de
redeliveryDelayjusqu’àmaxRedeliveryDelay. AprèsmaxRedeliveriesredélivraisons (10par défaut, environ 80 s avec les délais par défaut), le consommateur abandonne le message : il le journalise en erreur puis le commite/acquitte pour ne pas bloquer indéfiniment la partition ou l’abonnement. Utilisez unDeadLetterChannelpour conserver ces messages, oumaxRedeliveries=-1pour réessayer jusqu’au succès de la route (le consommateur reste alors bloqué sur un message en échec permanent). Un message que la route a envoyé dans unDeadLetterChannelest commité/acquitté immédiatement et jamais redélivré, même avecDeadLetterHandled(false): le redélivrer l’enverrait en double dans la DLQ à chaque tentative. Un commit Kafka en échec est réessayé toutes les 100 ms sans refaire le traitement réussi. Les erreurs de lecture Kafka sont journalisées et réessayées toutes les 100 ms ; le consommateur ne s’arrête que lorsque l’arrêt de la route ferme son reader (une erreur contenantclosedouEOFl’arrêtait alors que la route semblait toujours démarrée). Le topic Kafka résolu est porté par chaque message ; les topics configurés et surchargés par en-tête fonctionnent ensemble. - FTP : chaque producteur réserve sa connexion exclusivement pendant tout le transfert. Les envois concurrents et
Stopne peuvent pas entrelacer les commandes FTP ; un envoi en attente de réservation peut être annulé. - MongoDB :
savepréserve le_iddu document entrant, même si le remplacement échoue ; le retry cible ainsi le même document. - Mail : IMAP IDLE réagit aux notifications de boîte en terminant IDLE, en recherchant les messages puis en reprenant IDLE. Une première recherche traite les messages déjà présents.
- Cron :
Stopempêche de nouvelles exécutions et attend les jobs actifs avant de retourner, y compris lors d’une pause. - Redis : les producteurs et consommateurs actifs partagent leurs clients, fermés au départ du dernier utilisateur. Arrêter un producteur laisse les autres utilisables ; les consommateurs arrêtés libèrent leur enregistrement pour permettre le redémarrage de la route.
- File : une URI terminée par
/désigne un répertoire même s’il n’existe pas encore ;CamelFileNamesélectionne le fichier à l’intérieur. - Net : le timeout configuré borne les écritures établies ainsi que la lecture des réponses. Annuler l’échange ferme sa connexion et interrompt ces opérations.
- Prometheus : des appels répétés à
Metrics()ouMetricsWith(registry)réutilisent les collecteurs compatibles déjà enregistrés, ce qui permet des intercepteurs distincts sur plusieurs routes. Les définitions incompatibles échouent toujours à l’enregistrement.