编辑推荐: |
本文来自于csdn,
文章使用一个实例来简单的介绍一下Apache Camel,详细请看下文。 |
|
StackOverflow上有很多学习Apache Camel的资源,而这里仅仅是使用一个实例来简单的介绍一下Apache
Camel
基础
Apache Camel十一个Java库和引擎,有多种不同的整合模式,然而他并不是BPMN或者ESB,虽然可以在此引擎下实现他们。Apache
Camel是一个编程人员调节、整合问题的工具。
Message
org.apache.camel.Message是Camel中一个基本的包含数据和路由的实体,Messages包含了
1.唯一的识别(Unique Identifier)--java.lang.String类型
2.头信息(Headers)--会提供一些内容的提示,头信息被组织成名值对的形式,string-->Object
3.内容(body)是一个Object类型的对象,这就意味着,你要确保接收器能够理解消息的内容。当消息发送器和接收器使用不同的内容格式的时候,你可以使用Camel的数据转换机制将其转换为一个特定的格式。在许多情况下预先定义类型可以被自动转换。
4.错误标记(fault flag)使用来标记正常或者错误的标记,通常由一些标准类定义,例如(WSDL)
Exchange
org.apache.camel.Exchange 是一个消息之间通信的抽象的会话。下面列出的就是这样一个会话,使得组件更为全面
1.Exchange ID
2.MEP 一个类似InOnly或者InOut的消息交换模式。当模式是InOnly的时候,消息交换中只包含IN-Message
3.Exception在路由过程中的任何异常
4.Properties有点类似与message 的headers
,但是他们将持续到整个exchange结束,Camel还可能利用他们进行一些特殊的通信。
5.IN-Message
6.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"); |
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");
}
}
|
|