Apache Camel para Java: guia completo com exemplos práticos

1. O que é e para que serve

Apache Camel é um poderoso framework de integração de aplicações de código aberto que implementa os Padrões de Integração Corporativa (Enterprise Integration Patterns, EIP). Se você já precisou conectar vários sistemas que trocam dados por meio de diferentes protocolos (HTTP, JMS, FTP, arquivos, bancos de dados), sabe como isso rapidamente se transforma em um "código espaguete". O Camel resolve esse problema fornecendo uma DSL (Domain Specific Language) única e declarativa para descrever rotas de dados.

A ideia principal do Camel é que você define rotas (routes) pelas quais as mensagens (messages) trafegam. Cada rota consiste em "pontos de entrada" (from), "processadores" (processors) e "pontos de saída" (to). O Camel assume todo o trabalho "tedioso": conectar-se a fontes, converter formatos (JSON, XML, CSV), marshalling/unmarshalling, tratamento de erros e roteamento baseado em conteúdo. Isso permite que o desenvolvedor se concentre na lógica de negócios, em vez de escrever toneladas de código boilerplate para comunicação em rede.

Na prática, o Apache Camel é usado para construir ESB (Enterprise Service Bus), arquiteturas de microsserviços, processos ETL, integração com serviços em nuvem (AWS, Google Cloud) e até mesmo para criar "observadores" simples de arquivos. O framework suporta mais de 300 componentes para trabalhar com diversas tecnologias, tornando-se um "canivete suíço" para integração no mundo Java.

2. Instalação

O Apache Camel é distribuído como um conjunto de arquivos JAR. A maneira mais simples de começar é usar o sistema de build Maven ou Gradle. Abaixo está o comando para adicionar as dependências no Maven (pom.xml):

<!-- Mecanismo principal do Camel -->
<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-core</artifactId>
    <version>4.6.0</version> <!-- Verifique a versão mais recente no site -->
</dependency>

<!-- Componente para trabalhar com HTTP (ex.: para REST API) -->
<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-http</artifactId>
    <version>4.6.0</version>
</dependency>

<!-- Componente para trabalhar com arquivos -->
<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-file</artifactId>
    <version>4.6.0</version>
</dependency>

<!-- Componente para trabalhar com JSON (Jackson) -->
<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-jackson</artifactId>
    <version>4.6.0</version>
</dependency>

Para 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'

Importante: As versões dos componentes devem ser iguais. Recomenda-se sempre usar a versão estável mais recente do site oficial.

3. Início rápido — exemplo mínimo funcional

Crie uma rota simples que leia arquivos de uma pasta e os copie para outra, adicionando o prefixo "COPY_" ao nome do arquivo.

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. Cria o contexto Camel
        try (CamelContext context = new DefaultCamelContext()) {
            // 2. Adiciona a rota
            context.addRoutes(new RouteBuilder() {
                @Override
                public void confi