您的Apache Camel应用程序现在包括现成的文档
幾個月前,我在博客中發布了有關即將發布的2.15版本的信息,該功能包括獲取有關在端點上配置的每個屬性的詳細信息的功能-Apache Camel,請向我解釋這些端點選項的含義 。
我們沿著這條道路繼續前進,今天,我們將其從端點擴展到了EIP,數據格式和語言。 簡而言之,您幾乎在Camel應用程序中使用和配置的所有內容現在都具有在運行時立即提供文檔的功能。 此外,所有這些都與標簽相關聯,我們將其用作分類的一種方式。 因此,您可以列出數據庫,云,http,rest,消息傳遞等的所有組件。
由于在駱駝核心中提供了EIP,因此所有它們的選項都已被完整記錄,包括有關其默認值的詳細信息,是否需要該選項,是否不建議使用該選項以及當然還包括類型信息等。僅記錄了簡短摘要。
由于Camel包含大約175個組件,因此將需要一些時間來包含有關每個組件的文檔。 但是我們將在Apache Camel的構建過程中設置一個報告,該報告輸出哪些組件缺少文檔。
好的,一張圖片值得一千個單詞,所以讓我在使用hawtio的Web控制臺中進行一些實際操作 。
首先是EIP的示例,例如具有許多選項的聚合EIP。
在我們的Camel應用程序中顯示聚合EIP的屬性,
包括開箱即用的文檔
請注意,頂部有以下復選框:
- 顯示/隱藏文檔(文檔始終作為工具提示提供)
- 顯示/隱藏默認值(不是在當前屏幕截圖中,而是剛剛添加的)
- 顯示/隱藏未使用的值
另一個屏幕快照顯示了端點的屬性:
在我們的Camel應用程序中顯示端點的屬性,
包括開箱即用的文檔
該頁面類似于EIP頁面。 它還將包含相同的復選框以進行過濾。
還要注意那些灰色的徽章,它們代表該端點已與之關聯的標簽。 如我們所見,這是核心的端點及其調度。
所有這些信息都可以在運行時和設計時訪問。 在運行時,有來自camel-core的Java和JMX API。 并且在設計時,信息包含在一個新的駝色目錄JAR中,該JAR具有每個EIP,組件等的json模式文件。 同樣,也可以使用Java和JMX API在運行時從camel-core檢索這些json模式文件。
因此,換句話說,這允許最終用戶和工具都可以訪問此信息。
有關更多信息,請閱讀我以前的博客,我在此博客文章的頂部引用了該博客。
下一步是什么
作為Apache Camel的構建過程的一部分,我們尚未實現maven插件,該插件會將EIP文檔注入XSD模式中的Spring和Blueprint XML DSL。 到位后,任何IDE工具都應該能夠利用它,因此在編輯這些XML文件時,該工具可以為您提供幫助并提供文檔等。
翻譯自: https://www.javacodegeeks.com/2015/02/your-apache-camel-applications-now-includes-out-of-the-box-documentation.html
總結
以上是生活随笔為你收集整理的您的Apache Camel应用程序现在包括现成的文档的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 仙剑1安卓版(仙剑1安卓)
- 下一篇: (wait linux)