幾個月前，我在博客中發(fā)布了有關(guān)即將發(fā)布的2.15版本的信息，該功能包括獲取有關(guān)在端點上配置的每個屬性的詳細信息的功能-Apache Camel，請向我解釋這些端點選項的含義 。

我們沿著這條道路繼續(xù)前進，今天，我們將其從端點擴展到了EIP，數(shù)據(jù)格式和語言。 簡而言之，您幾乎在Camel應(yīng)用程序中使用和配置的所有內(nèi)容現(xiàn)在都具有在運行時立即提供文檔的功能。 此外，所有這些都與標簽相關(guān)聯(lián)，我們將其用作分類的一種方式。 因此，您可以列出數(shù)據(jù)庫，云，http，rest，消息傳遞等的所有組件。

由于在駱駝核心中提供了EIP，因此所有它們的選項都已被完整記錄，包括有關(guān)其默認值的詳細信息，是否需要該選項，是否不建議使用該選項以及當(dāng)然還包括類型信息等。僅記錄了簡短摘要。

由于Camel包含大約175個組件，因此將需要一些時間來包含有關(guān)每個組件的文檔。 但是我們將在Apache Camel的構(gòu)建過程中設(shè)置一個報告，該報告輸出哪些組件缺少文檔。

好的，一張圖片值得一千個單詞，所以讓我在使用hawtio的Web控制臺中進行一些實際操作 。

首先是EIP的示例，例如具有許多選項的聚合EIP。

在我們的Camel應(yīng)用程序中顯示聚合EIP的屬性，
包括開箱即用的文檔

請注意，頂部有以下復(fù)選框：

• 顯示/隱藏文檔（文檔始終作為工具提示提供）
• 顯示/隱藏默認值（不是在當(dāng)前屏幕截圖中，而是剛剛添加的）
• 顯示/隱藏未使用的值

另一個屏幕快照顯示了端點的屬性：

在我們的Camel應(yīng)用程序中顯示端點的屬性，
包括開箱即用的文檔

該頁面類似于EIP頁面。 它還將包含相同的復(fù)選框以進行過濾。

還要注意那些灰色的徽章，它們代表該端點已與之關(guān)聯(lián)的標簽。 如我們所見，這是核心的端點及其調(diào)度。

所有這些信息都可以在運行時和設(shè)計時訪問。 在運行時，有來自camel-core的Java和JMX API。 并且在設(shè)計時，信息包含在一個新的駝色目錄JAR中，該JAR具有每個EIP，組件等的json模式文件。 同樣，也可以使用Java和JMX API在運行時從camel-core檢索這些json模式文件。

因此，換句話說，這允許最終用戶和工具都可以訪問此信息。

有關(guān)更多信息，請閱讀我以前的博客，我在此博客文章的頂部引用了該博客。

下一步是什么

作為Apache Camel的構(gòu)建過程的一部分，我們尚未實現(xiàn)maven插件，該插件會將EIP文檔注入XSD模式中的Spring和Blueprint XML DSL。 到位后，任何IDE工具都應(yīng)該能夠利用它，因此在編輯這些XML文件時，該工具可以為您提供幫助并提供文檔等。

翻譯自: https://www.javacodegeeks.com/2015/02/your-apache-camel-applications-now-includes-out-of-the-box-documentation.html

總結(jié)

以上是生活随笔為你收集整理的您的Apache Camel应用程序现在包括现成的文档的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。