文档多个版本的API使用swaggydoc在单独目录下具有相同控制器名称的grails

问题描述:

我在我的grails应用程序上使用swaggydoc插件来记录REST API。我有两个版本的API,v0和v1以及相应的控制器,名称相同,每个版本都有一个版本,例如: directory structure 和我有Url映射,如"/my2api/v1"(controller:"api",namespace:'v1') "/myapi/v0" (controller:"api", namespace:'v0') 并将API端点的两个版本都列为/ myapi/v0/activecontracts​​。 所以我的问题是,我如何才能获得列出的API端点与正确的URL与对应的版本像/myapi/v0/activeContracts & /myapi/v1/activeContracts正如我所提到的我试过的映射,但它只是捡起第一个最后的映射,并将其分配给两个版本。 任何帮助将不胜感激。文档多个版本的API使用swaggydoc在单独目录下具有相同控制器名称的grails

+0

你看过[springfox](https://github.com/springfox/springfox-grails-integration)吗?如果不是,将很乐意获得您的反馈意见。 –

+0

@DilipKrishnan我看到周围的时候遇到过它,但我没有尝试过,因为我想让swaggydoc工作,因为它已经在应用程序中使用了一段时间了。 SpringFox在API版本控制方面的表现如何?记住我的用例,我可以通过springfox实现这一点,因为我很乐意尝试并给你反馈。 – PSingh

对于面临相同概率的人,我找不到使用swaggyDocs的解决方案,并且还遇到一些帖子,提示它不支持API版本控制,因此最终切换到Grails RestApiDoc,该版本提供了更多控制(更改API只需编辑json就可以了)比我在swaggyDocs上获得的更多。但是,如果有人知道在swaggyDoc中使用它的方法,请发帖。