Apache Camel在其主页上 (以及Camel用户指南中 )将其描述为“基于已知企业集成模式的通用开源集成框架”。 Camel框架基于《 企业集成模式 》一书,并提供了该书中描述的模式的实现 。 我看一下这篇文章中使用Camel的“ Hello World”类型示例。
Camel网页和用户指南还引用了StackOverflow线程Apache Camel到底是什么? 其中包括对Apache Camel的一些很好的描述。 David Newcomb在那儿描述了骆驼:
Apache Camel是消息传递技术与路由的结合。 它将消息的起点和终点连接在一起,从而允许将消息从不同的源传输到不同的目的地。 例如:JMS-> JSON,HTTP-> JMS或渠道FTP-> JMS,HTTP-> JMS,JMS => JSON。
在本文中,我介绍了一种简单的Camel用法,它不需要使用JMS提供程序,甚至不需要FTP或HTTP。 保持简单的示例可以使您更清楚地使用Camel。 本示例使用Camel自动将文件从指定目录传输到其他指定目录。 将演示三种情况。
在第一种情况下,放置在“输入”目录中的文件会自动复制到“输出”目录,而不会影响源文件。 在第二种情况下,放置在“输入”目录中的文件会自动复制到“输出”目录,然后将“输入”目录中的文件存储在“输入”目录下的特殊“ .camel”子目录中。 第三种情况是在复制到“输出”目录时(实际上是“移动”操作)从“输入”目录中删除文件。 这三种情况都是用几乎相同的代码实现的。 两者之间的唯一区别在于指定Camel如何处理文件传输的一行。
下一个代码清单显示使用Camel自动将放置在输入目录中的文件复制到Camel所需要的基本代码。
/**
* Simple executable function to demonstrate Camel file transfer.
*
* @param arguments Command line arguments; excepting duration in milliseconds
* as single argument.
*/
public static void main(final String[] arguments)
{
final long durationMs = extractDurationMsFromCommandLineArgs(arguments);
final CamelContext camelContext = new DefaultCamelContext();
try
{
camelContext.addRoutes(
new RouteBuilder()
{
@Override
public void configure() throws Exception
{
from('file:C:\\datafiles\\input?noop=true').to('file:C:\\datafiles\\output');
}
});
camelContext.start();
Thread.sleep(durationMs);
camelContext.stop();
}
catch (Exception camelException)
{
LOGGER.log(
Level.SEVERE,
'Exception trying to copy files - {0}',
camelException.toString());
}
}
上面的代码演示了对Camel API和Camel的Java DSL支持的最小使用。 CamelContext是使用DefaultCamelContext的实例定义的(第10行)。 第13-21行将骆驼路线添加到此实例化的上下文中,第22行开始上下文,第24行停止上下文。 这一切都非常简单,但是对我来说最有趣的部分是第19行的路由规范。
因为实现提供给Camel Context的RoutesBuilder接口的实例仅需要覆盖其抽象configure方法,所以通过调用CamelContext.addRoutes(RoutesBuilder)来将其实例化为一个匿名类很容易类。 这是我在上面的代码中所做的,也是在许多在线提供的Camel示例中所做的事情。
第19行显示了高度可读的语法,描述了路由的“从”和“到”部分。 在这种情况下,放置在输入目录(“ from”)中的文件将被复制到输出目录(“ to”)。 “文件”协议可用于“发件人”和“发件人”部分,因为文件系统是“消息”的发件人和发件人。 “ from”调用中的“?noop = true”表示“输入”目录中的文件不应进行任何更改(处理应对源文件产生“ noop”作用)。
如前所述,上面代码中的第19行指示Camel将“输入”目录中已经存在或放置的文件复制到指定的“输出”目录,而不会影响“输入”目录中的文件。 在某些情况下,我可能想“移动”文件而不是“复制”它们。 在这种情况下,当指定“ from”端点时,可以指定?delete=true
而不是?noop=true
。 换句话说,上面的第19行可以替换为将文件放置在“输出”目录中时从“输入”目录中删除文件。 如果未在输入上指定任何参数( ?noop=true
或?delete=true
),则将发生介于两者之间的操作:“ input”目录中的文件将移动到目录下的一个专门创建的新子目录中。 “输入”目录称为.camel
。 接下来将突出显示这三种情况。
从数据文件\输入复制到数据文件\输出的文件,而不会影响原始文件
from('file:C:\\datafiles\\input?noop=true').to('file:C:\\datafiles\\output');
文件从数据文件\输入移至数据文件\输出
from('file:C:\\datafiles\\input?delete=true').to('file:C:\\datafiles\\output');
从datafiles \ input复制到datafiles \ output的文件,并将原始文件移到.camel子目录
from('file:C:\\datafiles\\input').to('file:C:\\datafiles\\output');
附带说明一下,流畅的'from'和'to'的使用是Camel的Java DSL的示例。 Camel通过实现继承(在RouteBuilder类中定义了诸如“ from”和“ to”之类的方法)而不是通过静态导入 ( 通常用于基于Java的DSL的方法) 来实现此目的。
尽管将RouteBuilder
匿名实例RouteBuilder
给Camel Context是很常见的,但这不是RouteBuilder
的。 在某些情况下,拥有扩展RouteBuilder
独立类以及将这些扩展类的实例传递给Camel Context的情况是有利的。 我将使用这种方法来演示我之前描述的所有三种情况。 下一个代码清单显示了扩展RouteBuilder
的类。 在许多情况下,我将使用无参数构造函数,但是在这种情况下,我将使用构造函数来确定骆驼路线应支持哪种类型的文件传输。
下一个代码清单显示了一个命名的独立类,该类处理上述所有三种情况(复制,使用输入文件归档进行复制以及移动)。 RouteBuilder
单个扩展在其构造函数中使用一个枚举来确定如何配置输入端点。
package dustin.examples.camel;
import org.apache.camel.builder.RouteBuilder;
/**
* Camel-based Route Builder for transferring files.
*
* @author Dustin
*/
public class FileTransferRouteBuilder extends RouteBuilder
{
public enum FileTransferType
{
COPY_WITHOUT_IMPACTING_ORIGINALS('C'),
COPY_WITH_ARCHIVED_ORIGINALS('A'),
MOVE('M');
private final String letter;
FileTransferType(final String newLetter)
{
this.letter = newLetter;
}
public String getLetter()
{
return this.letter;
}
public static FileTransferType fromLetter(final String letter)
{
FileTransferType match = null;
for (final FileTransferType type : FileTransferType.values())
{
if (type.getLetter().equalsIgnoreCase(letter))
{
match = type;
break;
}
}
return match;
}
}
private final String fromEndPointString;
private final static String FROM_BASE = 'file:C:\\datafiles\\input';
private final static String FROM_NOOP = FROM_BASE + '?noop=true';
private final static String FROM_MOVE = FROM_BASE + '?delete=true';
public FileTransferRouteBuilder(final FileTransferType newFileTransferType)
{
if (newFileTransferType != null)
{
switch (newFileTransferType)
{
case COPY_WITHOUT_IMPACTING_ORIGINALS :
this.fromEndPointString = FROM_NOOP;
break;
case COPY_WITH_ARCHIVED_ORIGINALS :
this.fromEndPointString = FROM_BASE;
break;
case MOVE :
this.fromEndPointString = FROM_MOVE;
break;
default :
this.fromEndPointString = FROM_NOOP;
}
}
else
{
fromEndPointString = FROM_NOOP;
}
}
@Override
public void configure() throws Exception
{
from(this.fromEndPointString).to('file:C:\\datafiles\\output');
}
}
这篇博客文章演示了如何使用Camel轻松地将文件从一个目录路由到另一个目录。 骆驼支持许多其他的传输机制和数据格式,这里没有显示。 骆驼还支持转换要路由的消息/数据的功能,此处也未显示。 这篇文章重点介绍了如何以有用的方式应用Camel的最简单的示例,但是Camel支持的远远超过此简单示例中所示。
参考: Hello Camel: JCG合作伙伴 Dustin Marx在Inspired by Actual Events博客上的自动文件传输 。
翻译自: https://www.javacodegeeks.com/2013/02/hello-camel-automatic-file-transfer.html