Apache Camel简介与入门

StackOverflow上有很多学习Apache Camel的资源，而这里仅仅是使用一个实例来简单的介绍一下Apache Camel

基础

Apache Camel十一个Java库和引擎，有多种不同的整合模式，然而他并不是BPMN或者ESB，虽然可以在此引擎下实现他们。Apache Camel是一个编程人员调节、整合问题的工具。

Message

org.apache.camel.Message是Camel中一个基本的包含数据和路由的实体，Messages包含了

• 唯一的识别（Unique Identifier）--java.lang.String类型
• 头信息（Headers）--会提供一些内容的提示，头信息被组织成名值对的形式，string-->Object
• 内容（body）是一个Object类型的对象，这就意味着，你要确保接收器能够理解消息的内容。当消息发送器和接收器使用不同的内容格式的时候，你可以使用Camel的数据转换机制将其转换为一个特定的格式。在许多情况下预先定义类型可以被自动转换。
• 错误标记(fault flag)使用来标记正常或者错误的标记，通常由一些标准类定义，例如（WSDL）

Exchange

org.apache.camel.Exchange 是一个消息之间通信的抽象的会话。下面列出的就是这样一个会话，使得组件更为全面

• Exchange ID
• MEP 一个类似InOnly或者InOut的消息交换模式。当模式是InOnly的时候，消息交换中只包含IN-Message
• Exception在路由过程中的任何异常
• Properties有点类似与message 的headers ，但是他们将持续到整个exchange结束，Camel还可能利用他们进行一些特殊的通信。
• IN-Message
• OUT-Message

Camel Context

现在让我们来看看一张图，我们看到的是一些不同的相互链接的构件，而在他们中间起链接作用的粘合剂就是Camel Context了。他将实体链接一起，有的时候被称为Camel运行是容器。

Endpoint

是Camel中的一个基本概念，Endpoint作为Camel系统中一个通道的端点，可以发送或者接受消息。在Camel中Endpoint使用URI来配置。在运行时Camel通过URI来查找端点。端点的功能强大、全面而且又可维护。来看一些例子。

//Pooling on data/inbox every 2 seconds
file:data/inbox?delay=2000
//JMS queendpoid with name order
jms:queue:order
//Run's external Application with output.txt as parameter.
exec:archiver.exe?output.txt

Component

Component是一些Endpoints URI的集合。他们通过连接码来链接（例如file:,jms:），而且作为一个endpoint的工厂。现在Camel中又超过80个Component。当然你一可以通过扩展org.apache.camel.impl.DefaultComponent来实现自己的Component

Route

顾名思义，Route，就是路由，它定义了Message如何在一个系统中传输的真实路径或者通道。路由引擎自身并不暴露给开发者，但是开发者可以自己定义路由，并且需要信任引擎可以完成复杂的传输工作。每个路由都有一个唯一的标识符，用来记录日志、调试、监控，以及启动或者停止路由。

路由也有一个输入的Message，因此他们也有效的链接到一个输入端点。路由定义了一种领域特有的语言（DSL）。Camel提供了java、scala和基于XM的Route-DSL。

示例路由：

//simple route.
from("file:data/inbox").to("jms:queue:order")

路由可以使用过滤器、多播、接收列表、并行处理来定义，从而变得非常灵活。由于这篇文章只是简单的介绍Camel，我这里只给出一个注释的例子。这个使用了“direct:”架构，他提供了当消息生产者发出消息后直接的、同步的调用。

//Every 10 seconds timer sends an Exchange to direct:prepare
from("timer://foo?fixedRate=true&period=10000").to("direct:prepare");
// Onother Routes can begin from "direct:prepare"
// This now depends on timer, logging and putting a message to the queue.
from(direct:prepare).to("log:com.mycompany.order?level=DEBUG").to("jms:queue:order?jmsMessageType=Text");

Processor

org.apache.camel.Processor 是一个消息接受者和消息通信的处理器。当然，Processor是Route的一个元素，可用来消息格式转换或者其他的一些变换。

Processor myProcessor = new Processor() {
    public void process(Exchange exchange) {
        exchange.getBody();
        //e.g do something with Body..
    }
};
 
from("file:data/inbox").filter(header("foo").isEqualTo("bar"))
    .process(myProcessor).to("jms:queue:order")

示例

使用maven创建一个Camel项目（Camel 架构概揽）。

mvn  archetype:generate -DgroupId=org.holbreich -DartifactId=filecopy -DarchetypeGroupId=org.apache.camel.archetypes -DarchetypeArtifactId=camel-archetype-java -Dversion=1.0.0-SNAPSHOT

这个项目包换如下代码：

package org.holbreich.filecopy;
import org.apache.camel.main.Main;
 
public class MainApp {
/**
* A main() so we can easily run these routing rules in our IDE
*/
public static void main(String... args) throws Exception {
   Main main = new Main();
   main.enableHangupSupport();
   main.addRouteBuilder(new MyRouteBuilder());
   main.run(args);
   }
}
and
package org.holbreich.filecopy;
import org.apache.camel.builder.RouteBuilder;
 
/**
* A Camel Java DSL Router
*/
public class MyRouteBuilder extends RouteBuilder {
 
/**
* Let's configure the Camel routing rules using Java code...
*/
public void configure() {
    // here is a sample which processes the input files
    // (leaving them in place - see the 'noop' flag)
    // then performs content based routing on the message using XPath
    from("file:src/data?noop=true")
      .choice()
       .when(xpath("/person/city = 'London'"))
        .to("file:target/messages/uk")
        .otherwise()
      .to("file:target/messages/others");
  }
}

这个项目已经是一个可运行的了，赶紧试一试吧！