从 Spring MVC 控制器自动将 REST api 文档生成到 RAML 中

Question

我是 Spring Boot 的新手。我想从 Spring MVC 控制器自动将 REST api 文档生成到 RAML 中。有什么可以做的吗？或者有什么指南可以让我用它来将我的 REST API 生成到 RAML 中？

Answer 1

Spring REST Docs 有一个 Spring REST Docs到 RAML 扩展： https: //github.com/ePages-de/restdocs-raml但是，该项目不再维护，作者建议使用他们的新项目https:// github.com/ePages-de/restdocs-openapi转换为 OpenAPI (Swagger) 而不是 RAML。他们提供了如何将 OpenAPI 转换为 RAML 的指南：https://github.com/ePages-de/restdocs-openapi#convert-to-raml有一个示例项目演示了 OpenAPI 和 RAML 的转换https:// github.com/ePages-de/restdocs-openapi/tree/master/samples/restdocs-openapi-sample该扩展的一个限制是它目前仅适用于 Gradle。