我们使用Swagger来记录我们的RESTful端点。显然这个文档很有用。但是,我们的Camel路由不是RESTful。什么是自动生成Camel路线使用文档的好工具?我们有需要描述的Rabbit消息,以及有关路由将应用的转换的信息。
编辑 - 以前的类似问题是8岁;现在肯定有比在内部编写工具更好的选择。另外,我不仅仅想要Route文档,我希望能够指定兔子消息结构,而且我希望该工具能够生成网页或其他一些易于消耗的输出。
编辑2 - 我的意思是" Rabbit消息结构"? HTTP协议具有结构。有一个动词,有查询参数,请求体参数,错误状态,授权令牌等。也就是说,在客户端和端点之间来回传递的消息具有明确定义的结构或协议。在我的Camel路由之间传递的RabbitMQ消息同样复杂,因为它们最终实现了RESTful请求。如果两个服务(Camel路由)需要一个搜索字符串,那么消息中应该只有一个位置可以找到它。此外,搜索参数应该是明确定义的格式。此外,还有一些特定于某些服务的项目。我想知道如何指定这些值,并阅读它们的用途,而无需深入研究代码。
另一个例子,很多服务都需要一个用户ID。我不想要一个名为" user_id"的地图密钥。在一项服务中," userid"在另一个," uid"在另一个。这个非常常见的数据将存在于邮件头中,并且具有明确定义的名称,所有这些都将使用。