rest - 为 Restful Web 服务的自定义实现生成文档

Question

我的项目为我们的 API（一些 6k 奇怪的服务）定制了 Rest 实现——我们不遵循JAX-RS规范。

我正在寻找一种为这些服务生成Swagger (Yaml) 文档或 WADL 文档的方法，以便我们可以在 API 管理平台上列出我们的 API。

有没有一种方法可以实现这一点，或者我可以使用任何工具为我自动生成这些？我遇到了一些 maven 插件，但这些插件要么用于实现 JAX-RS 规范的框架，要么我需要使用 Swagger 注释手动注释我的类。

任何帮助/指针将不胜感激。谢谢。

Answer 1

好的，有了 swagger 社区的一些初步建议，我们能够实现这一目标。

我们已经为我们的 Rest API 实现了一个自定义阅读器。我们修改了这个阅读器以生成 swagger JSON 文件和 wala - 我们有我们想要的输出。