Apache Camel pour Java : guide complet avec exemples

1. Qu'est-ce qu'Apache Camel et pourquoi l'utiliser ?

Apache Camel est un framework d'intégration d'applications open source puissant qui implémente les modèles d'intégration d'entreprise (Enterprise Integration Patterns, EIP). Si vous avez déjà dû connecter plusieurs systèmes échangeant des données via différents protocoles (HTTP, JMS, FTP, fichiers, bases de données), vous savez à quelle vitesse cela peut se transformer en "code spaghetti". Camel résout ce problème en fournissant un DSL (Domain Specific Language) déclaratif et unifié pour décrire les routes de données.

L'idée principale de Camel est que vous définissez des routes (routes) le long desquelles les messages (messages) circulent. Chaque route est composée de "points d'entrée" (from), de "processeurs" (processors) et de "points de sortie" (to). Camel se charge de tout le travail "ennuyeux" : connexion aux sources, transformation des formats (JSON, XML, CSV), marshalling/demarshalling, gestion des erreurs et routage basé sur le contenu. Cela permet au développeur de se concentrer sur la logique métier, plutôt que d'écrire des tonnes de code boilerplate pour les communications réseau.

En pratique, Apache Camel est utilisé pour construire des ESB (Enterprise Service Bus), des architectures de microservices, des processus ETL, l'intégration avec des services cloud (AWS, Google Cloud) et même pour créer de simples "observateurs" de fichiers. Le framework prend en charge plus de 300 composants pour travailler avec diverses technologies, ce qui en fait un "couteau suisse" de l'intégration dans le monde Java.

2. Installation

Apache Camel est distribué sous forme d'un ensemble de fichiers JAR. La façon la plus simple de commencer est d'utiliser un système de build comme Maven ou Gradle. Voici la commande pour ajouter les dépendances dans Maven (pom.xml) :

<!-- Moteur principal Camel -->
<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-core</artifactId>
    <version>4.6.0</version> <!-- Vérifiez la version actuelle sur le site -->
</dependency>

<!-- Composant pour travailler avec HTTP (par exemple, pour les API REST) -->
<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-http</artifactId>
    <version>4.6.0</version>
</dependency>

<!-- Composant pour travailler avec les fichiers -->
<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-file</artifactId>
    <version>4.6.0</version>
</dependency>

<!-- Composant pour travailler avec JSON (Jackson) -->
<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-jackson</artifactId>
    <version>4.6.0</version>
</dependency>

Pour Gradle (build.gradle) :

implementation 'org.apache.camel:camel-core:4.6.0'
implementation 'org.apache.camel:camel-http:4.6.0'
implementation 'org.apache.camel:camel-file:4.6.0'
implementation 'org.apache.camel:camel-jackson:4.6.0'

Important : Les versions des composants doivent correspondre. Il est recommandé d'utiliser toujours la dernière version stable disponible sur le site officiel.

3. Démarrage rapide — un exemple minimal fonctionnel

Créez une route simple qui lit les fichiers d'un dossier et les copie dans un autre, en ajoutant le préfixe "COPY_" au nom du fichier.

import org.apache.camel.CamelContext;
import org.apache.camel.builder.RouteBuilder;
import org.apache.camel.impl.DefaultCamelContext;

public class QuickStart {
    public static void main(String[] args) throws Exception {
        // 1. Créer le contexte Camel
        try (CamelContext context = new DefaultCamelContext()) {
            // 2. Ajouter la route
            context.addRoutes(new RouteBuilder() {
                @Override
                public void confi