Apache Camel 简介与入门
Apache Camel 是一个基于知名的企业应用模式(Enterprise Integration Patterns)多功能的整合框架.
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"); } }
这个项目已经是一个可运行的了,赶紧试一试吧!
OSChina.NET原创翻译/原文链接