摘要：你可以通過集成 Camel 和 WildFly 應用服務器（使用 WildFly-Camel 子系統）在 Java EE 組件中開始使用 Apache Camel Routes。
【編者按】作者 Markus Eisele 是 Red Hat 的 Developer Advocate，主要從事 JBoss Middleware 相關研究，擁有超過14年的 Java EE 工作經驗。本篇博文中， Markus 主要分享了基于 Java EE 組件的 Camel Routes 應用實踐。
以下為譯文:
在生產環境中使用 Camel 有一段時間后，我愈發的喜歡上它的簡單。在 Java EE 上使用它確實存在一些挑戰，而在最近一次演講中我也提到了如何實現這一點。在 Java EE 中，我們可以通過不同的途徑來使用 Camel 的，其中比較推薦的是使用 WildFly-Camel 子系統。在接下來的一個系列中，我將探索實現它的不同方法，并提供一些在演講中沒有涉及的例子。很期待能夠通過留言或者在 Twitter上@myfear 的方式獲得你的反饋和提問。
Camel On WildFly 8.2入門
WildFly-Camel 子系統提供了 Apache Camel 和 WildFly 應用服務器的集成環境。它允許你添加 Camel Routes（路由）作為 WildFly 配置的一部分。Routes 可以作為 Java EE 應用程序的一部分部署。Java EE 組件能夠使用 Camel 的核心 API 和多個 Camel Component APIs。你的企業級集成解決方案可以架構于 Java EE 和 Camel 的聯合功能之上。
備注：最新的 WildFly9 預期將由 WildFly-Camel 的 3.x 版本支持。
準備階段
下載并解壓 WildFly 8.2.0.Final 到你指定的目錄下，下載并解壓 wildfly-camel patch(2.3.0) 到 wildfly 目錄下。通過以下命令啟動 WildFly：
bin/standalone[.bat|.sh] -c standalone-camel.xml
最快速的啟動和運行方式是使用 Docker 和 WildFly Camel image。這里的 image 需要預先安裝好 WindFly8.1 和 Camel 子系統。
定義和使用Camel Context
CamelContext 代表著一個 Camel 路由規則庫。使用 CamelContext 和使用 Spring ApplicationContext 的方式是十分相似的。它包含針對你應用的所有路由。你可以根據需求使用任意數量的 CamelContext，當然它們需要使用不同的名稱來定義。
WildFly-Camel 可以通過下面3種不同的方式定義和部署：
- 在 standalone-camel.xml 和 domain.xml 中作為子系統的一部分來定義；
- 在一個支持它們的 deployment artifact 進行部署，當然這個 deployment artifact 必須包含后綴為 -camel-context.xml 的文件；
- 通過 RouteBilder 和 CDI integration 定義部署并提供路由信息。
一個定義的 CamelContext 可以通過兩種不同的方式被使用：
- 通過Camel-CDI注入
- 通過 JNDI 樹進入。
Context 和 Route 示例
在接下來的例子中，我將使用一個關聯路由的 context，通過 CDI 和 RouteBuilder 提供。是一個應用級別的 bean，在應用啟動的時候自動啟動。@ContextName 注解給了 CamelContext 一個特定的名字。
@ApplicationScoped
@Startup
@ContextName("cdi-context")
public class HelloRouteBuilder extends RouteBuilder {
@Inject
HelloBean helloBean;
@Override
public void configure() throws Exception {
from("direct:start").transform(body().prepend(helloBean.sayHello()).append(" user."));
}
}
路由本身并不真的具有挑戰性。它有一個空的信息主體 from direct:start 并且用 CDI bean 方法 "sayHello" prepends 輸出，再 append 字符串" user."。作為參照，完整的代碼可以在我的GitHub（https://github.com/myfear/camel-javaee）中找到。因此，接下來我們需要知道的是，如何在各種Java EE組件中使用這個路由。
在 CDI 中使用 Camel
Camel 自從2.10 版本即支持 CDI。在沒有子系統之前，它需要被 bootstrapped。不過現在不需要了，你可以僅僅用一個已部署或者已定義的 CamelContext 在 @Named CDI bean 中通過簡單的 @Injecting 注入它的 name 實現。
@Inject
@ContextName("cdi-context")
private CamelContext context;
在 JSF、JAX-RS 和 EJBs 中使用 Camel
有了對在 CDI 中如何使用 CamelContext 的了解，你可能會想，在 類似 JSF 中使用應該一樣的簡單，事實卻并不如此——你無法將它注入 ManagedBeans 或者和 JSF 組件綁定的 CDI Beans。此外，它在 EJB 中也不能使用。這里我并沒有深挖細節，但是認為它在邊界控制上確實需要改進。一個合理的解決方法，事實上，更好的應用程序設計是將一個完整的 Camel 邏輯放入一個單獨的 CDI bean 并且注入。
@Named
public class HelloCamel {
@Inject
@ContextName("cdi-context")
private CamelContext context;
private final static Logger LOGGER = Logger.getLogger(HelloCamel.class.getName());
public String doSomeWorkFor(String name) {
ProducerTemplate producer = context.createProducerTemplate();
String result = producer.requestBody("direct:start", name, String.class);
LOGGER.log(Level.INFO, result);
return result;
}
}
ProducerTemplate 接口允許你從 Java 代碼發送信息交換到 endpoint，通過多種不同的方式使得同 Camel Endpoint 實例協作非常容易。在這種特殊情況下，它僅僅是啟動路由并且添加上代表我使用組件名稱的字符串到 body 中。
CDI Bean，對于使用它的組件來說扮演著 backing-bean 的角色：
@Inject
HelloCamel helloCamel;
public String getName() {
return helloCamel.doSomeWorkFor("JSF");
}
返回的字符串是 "Hello JSF user."，同時也寫進了 WildFly 的服務器日志。對于其他 Java EE 組件來講這個方法同樣是最好的。
在 EJB 中使用 Camel
如果你正在使用EJB作為你的主要應用組件模塊，那么使用JNDI方法也是合理的：
CamelContext camelctx =
(CamelContext) inicxt.lookup("java:jboss/camel/context/cdi-context");
Hawtio：一個 Camel 控制臺
在子系統中另一個隱藏的寶貝就是 Hawtio 控制臺。這是一個模塊化的 Web 控制臺，用來管理你的 Java 組件，它有一個 Apache Camel 插件來可視化你的上下文和路由信息。記住，它是自動配置的，安全起見，你在使用它之前需要先添加一個管理用戶。
原文地址：Using Camel Routes In Java EE Components
本文系 OneAPM 工程師編譯整理。OneAPM 是應用性能管理領域的新興領軍企業，能幫助企業用戶和開發者輕松實現：緩慢的程序代碼和 SQL 語句的實時抓取。想閱讀更多技術文章，請訪問 OneAPM 官方博客。
