在 Java EE 組件中使用 Camel Routes

摘要：你能夠經過集成 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種不一樣的方式定義和部署：

1. 在 standalone-camel.xml 和 domain.xml 中做爲子系統的一部分來定義；
2. 在一個支持它們的 deployment artifact 進行部署，固然這個 deployment artifact 必須包含後綴爲 -camel-context.xml 的文件；
3. 經過 RouteBilder 和 CDI integration 定義部署並提供路由信息。

一個定義的 CamelContext 能夠經過兩種不一樣的方式被使用：

1. 經過Camel-CDI注入
2. 經過 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 官方博客。