在 Java EE 組件中使用 Camel Routes

標籤：java   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 應用伺服器的Integration Environment。它允許你添加 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 並且注入。

@Namedpublic 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 官方部落格。

著作權聲明：本文為博主原創文章，未經博主允許不得轉載。

在 Java EE 組件中使用 Camel Routes