Apache Camel en Java: guía completa con ejemplos prácticos

1. ¿Qué es y para qué sirve?

Apache Camel es un potente framework de integración de aplicaciones de código abierto que implementa los Patrones de Integración Empresarial (Enterprise Integration Patterns, EIP). Si alguna vez has tenido que conectar varios sistemas que intercambian datos a través de diferentes protocolos (HTTP, JMS, FTP, archivos, bases de datos), sabes lo rápido que esto se convierte en un "código espagueti". Camel resuelve este problema proporcionando un DSL (Domain Specific Language) único y declarativo para describir rutas de datos.

La idea principal de Camel es que tú defines las rutas (routes) por las que viajan los mensajes (messages). Cada ruta consta de "puntos de entrada" (from), "procesadores" (processors) y "puntos de salida" (to). Camel se encarga de todo el trabajo "tedioso": conexión a fuentes, transformación de formatos (JSON, XML, CSV), marshalling/unmarshalling, manejo de errores y enrutamiento basado en contenido. Esto permite al desarrollador centrarse en la lógica de negocio, en lugar de escribir toneladas de código repetitivo para la comunicación en red.

En la práctica, Apache Camel se utiliza para construir ESB (Enterprise Service Bus), arquitecturas de microservicios, procesos ETL, integración con servicios en la nube (AWS, Google Cloud) e incluso para crear simples "vigilantes" de archivos. El framework soporta más de 300 componentes para trabajar con diversas tecnologías, lo que lo convierte en una "navaja suiza" para la integración en el mundo Java.

2. Instalación

Apache Camel se distribuye como un conjunto de archivos JAR. La forma más sencilla de empezar es usar el sistema de compilación Maven o Gradle. A continuación, se muestra el comando para agregar las dependencias en Maven (pom.xml):

<!-- Motor principal de Camel -->
<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-core</artifactId>
    <version>4.6.0</version> <!-- Verifica la versión actual en el sitio web -->
</dependency>

<!-- Componente para trabajar con HTTP (por ejemplo, para API REST) -->
<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-http</artifactId>
    <version>4.6.0</version>
</dependency>

<!-- Componente para trabajar con archivos -->
<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-file</artifactId>
    <version>4.6.0</version>
</dependency>

<!-- Componente para trabajar con 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: Las versiones de los componentes deben coincidir. Se recomienda usar siempre la última versión estable desde el sitio oficial.

3. Inicio rápido — ejemplo mínimo funcional

Crea una ruta simple que lea archivos de una carpeta y los copie a otra, añadiendo el prefijo "COPY_" al nombre del archivo.

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. Creamos el contexto de Camel
        try (CamelContext context = new DefaultCamelContext()) {
            // 2. Agregamos la ruta
            context.addRoutes(new RouteBuilder() {
                @Override
                public void confi