在单独的目录下使用相同控制器名称的 grails 上使用 swaggydoc 记录 API 的多个版本答案

【问题标题】：document multiple version of API using swaggydoc on grails with same controller name under separate directory在单独的目录下使用相同控制器名称的 grails 上使用 swaggydoc 记录 API 的多个版本
【发布时间】：2017-04-05 15:38:29
【问题描述】：

我在我的 grails 应用程序上使用 swaggydoc 插件来记录 REST API。我有两个版本的 API，v0 和 v1 以及具有相同名称的相应控制器，每个版本一个，例如： directory structure 我有像"/my2api/v1"(controller:"api",namespace:'v1') "/myapi/v0" (controller:"api", namespace:'v0')这样的Url映射并将两个版本的 API 端点列为 /myapi/v0/activeContracts like here。所以我的问题是，我怎样才能让 API 端点列出正确的 URL 和相应的版本，如/myapi/v0/activeContracts & /myapi/v1/activeContracts，正如我提到的我已经尝试了映射，但它只是拾取第一个最后一个映射并将其分配给两个版本。任何帮助将不胜感激。

【问题讨论】：

你看过springfox吗？如果没有，很想得到您的反馈。
@DilipKrishnan 我在环顾四周时确实遇到了它，但我没有尝试过，因为我想让 swaggydoc 工作，因为它已经在应用程序中使用了一段时间。 SpringFox 在 API 版本控制方面的表现如何？。记住我的用例，我可以用 springfox 实现这一点吗因为我很高兴尝试它并给你反馈。

标签： api grails swagger grails-plugin swagger-2.0

【解决方案1】：

对于面临相同问题的人，我找不到使用 swaggyDocs 的解决方案，并且还看到一些帖子表明它不支持 API 版本控制，因此最终切换到提供更多控制的Grails RestApiDoc（更改API conf 仅通过编辑 json）比我能够在 swaggyDocs 上获得。但是，如果有人知道在 swaggyDoc 中解决问题的方法，请发布。

【讨论】：