這教程演示如何在OSGi伺服器Apache Karaf上執行camel路由。與CXF類似，我們使用blueprint啟動camel。本教程演示三個例子：一個簡單的blueprint路由、一個jms2rest介面卡和一個有序處理的例子。

安裝Camel特性

• 啟動bin\karaf.bat或者bin/karaf（unix）

在Karaf中，鍵入如下命令：

你應該能看到camel特性已經準備好安裝了。

獲取示例程式碼，並構建

所以你可以clone git倉庫，或者就下載下來，然後解壓到某個目錄。要構建程式碼，只需要這麼做：

cd camel

mvn clean install

啟動簡單示例（用純blueprint部署）

我們的第一個例子甚至不需要一個java工程。在Karaf中，可以部署純blueprint xml檔案。由於camel與blueprint很好的整合，所以你可以在簡單的blueprint檔案中定義一個帶有路由的完整的camel上下文。

camel上下文的blueprint xml非常類似於spring。主要是名稱空間不同。Blueprint發現依賴於camel，所以它會自動安裝camel-blueprint特性。路由中的Camel元件作為OSGi服務被發現。所以只要camel元件使用So as soon as

所以要安裝上面的基於blueprint的camel整合，你只需做下面的幾步：

feature:install camel-blueprint camel-stream

複製simple-camel-blueprint.xml到karaf的deploy目錄。你應該能在控制檯看到每5秒列印一次"Hello Camel"。

Blueprint檔案會被自動監視，只要它發生變化，這些改變就會反映到Karaf中。為了嘗試一下，用編輯器開啟deploy/simple-camel-blueprint.xml檔案,將"stream:out"修改為"log:test"

JMS to REST Adapter (jms2rest)

這個例子不是獨立的。前提要先安裝Karaf教程第4部分中的person服務例子。

這個例子演示如何將訊息世界橋接到REST服務上。它是足夠簡單的，你可能只需要定義個純blueprint檔案，就像上面的例子那樣。任何更大的整合需要一些Java程式碼的，我都選擇使用java工程。

像大多數情況一樣，我們主要使用預設配置的maven bundle plugin將工程打包為bundle。Camel上下文使用blueprint檔案啟動，路由定義在java類中。

路由

第一個路由是監視目錄"in"，將該目錄下的任何檔案的內容寫入到jms佇列"person"。它不是嚴格必須的，但是這樣手動測試示例會更加簡單。

第2個路由是實際的jms2rest介面卡。它監聽jms佇列person，期望獲取person的xml內容，就像PersonService中用到的那樣。在路由中，person的id是從xml中抓取的，並存儲到camel訊息頭中。這個頭然後被用於構建rest的uri。由於最後一步，訊息的內容被用PUT請求傳送到rest uri。所以它告訴服務用給定的id和資料儲存person。

使用Properties

除了純路由，這個例子說明了一些在camel中需要的通用的東西。所以將我們訪問的url具體化是最佳實踐。Camel使用Properties元件完成這個任務。

這能讓我們用簡單的語言在終端點寫入{{personServiceUri}}或者${properties:personServiceUri}。

在blueprint上下文中，Properties元件是自動從Config Admin服務注入的。 我們使用cm:property-placeholder定義注入config admin pid "net.lr.tutorial.karaf.cxf.personservice"的屬性。由於可能沒有這樣的pid，我們也定義了personServiceUri的預設值，所以部署整合部需要進一步配置。

JMS元件

我們在路由中使用camel jms元件。這是一個需要進一步配置才能工作的元件。我們在blueprint上下文中通過定義JmsComponent和注入連線工廠進行配置。在OSGi中，最佳實踐是不要在bundle中定義連線工廠或資料來源工廠，相反我們簡單地使用OSGi服務引用引用它。

部署並測試jms2rest介面卡

在karaf控制檯鍵入如下命令：

這會安裝activemq和camel特性檔案。activemq:create命令在deploy資料夾建立代理定義。這個代理會自動啟動。代理定義也為適合的連線工廠釋出OSGi服務。這個稍後會在我們的bundle中引用。

最後一步，安裝了我們自己的camel路由bundle。

當鍵入如下命令時，應該能看到路由：

現在將檔案src/test/resources/person1.xml複製到karaf目錄下的"in"資料夾。這個檔案應該被第一條路由傳送到佇列person，然後被第二條路由傳送到rest服務。

如果安裝了personservice，你應該能看到類似於"Update request received for ..."的訊息。如果沒有安裝personservice服務，那麼當訪問rest服務時，你應該能看到404錯誤。

訂單處理示例

這個例子中的業務案例是一個商店，這個商店與外部商販一起工作。

我們接收到一個xml檔案的訂單(參見。這個訂單包含一個customer元素和幾個item元素。每一個item指定一個商販。這個item要麼是"direct"（自己派送item），要麼是外部的商販名字。如果item的商販是direct，那麼這個item應該被匯出檔案到用customer名字命名的目錄中。所有其他的item都是通過郵件傳送。郵件內容應該是可自定義的，郵件地址是從將商販名字對映到郵件地址的服務獲取的。

它是怎麼工作的

這個例子再次使用maven構建，用上下文啟動camel，java類構建camel路由。所以從OSGi的角度看，它跟jms2rest例子幾乎是一樣的。

路由定義在net.lr.tutorial.karaf.camel.order.OrderRouteBuilder中。"order"路由監聽目錄"orderin"，期望xml訂單檔案放置到這個目錄。路由使用xpath將訂單的屬性提取到訊息頭。分離器用於分別處理每一個(/order/item)。然後基於內容的router用於處理來自其他路由的不同的"direct" item。

至於direct item，recipientlist模式被用於使用簡單語言表示式動態構建目的資料夾。

如果商販不是"direct"，那麼路由"mailtovendor"會被呼叫，以建立併發送郵件到商販。主題和目的地址使用特殊的郵件元件能夠理解的頭名字設定。訊息體期望是郵件的內容。由於訊息體應該是可配置的，velocity元件用於向檔案填寫來自頭的值（期望的）。

部署到karaf

部署類似於之前的例子，但是更簡單點，我們不需要jms。在karaf中鍵入下面的命令 ：

為了能收到郵件，你還需要編譯配置pid。你也可以將屬性檔案放到etc/net.lr.tutorial.karaf.cxf.personservice.cfg，或者使用karaf webconsole編譯配置pid。(參見Karaf教程第2部分和第3部分).

從根本上說，你需要設定在你自己的郵件環境中設定這些屬性。

測試訂單示例

將檔案複製到karaf目錄下的資料夾"ordersin"。

Karaf控制檯將會顯示：:

這與你郵箱的收件箱裡是一樣的。同時，ordersout/Christian Schneider/order1.xml檔案會被建立，檔案中包含book item。

總結和展望

這些示例演示了camel可以完成相當複雜的整合，可以很好地部署到Apache Karaf容器。這些示例也演示了一些配置管理、jms連線工廠和自定義模板的最佳實踐。這些示例也為你自己整合工程提供了好的起點。許多人在生成環境中使用OSGi還是很猶豫的。我希望這些示例可以說明在實踐中是多麼容易。當然，問題總是有的。如果有問題，建議從供應商例如Talend獲得支援。整個Talend Integration portfolio是基於Apache Karaf，所以我們這個領域是很有經驗的。

在這個教程中，我沒有考慮Apache Camel比較大的使用場景-資料庫整合。這是一個很大的領域， 保證很快就與單獨的教程。我也會解釋如何處理那些和OSGi不相容的driver的資料來源和連線工廠。