rest - 良好的剩余代码生成和文档工具

Question

已结束。此问题正在寻求书籍、工具、软件库等的推荐。它不满足 Stack Overflow guidelines 。目前不接受答案。

---

我们不允许提出寻求书籍、工具、软件库等推荐的问题。您可以编辑问题，以便用事实和引文来回答。

已关闭 7 年前。

Improve this question

我一直在考虑使用一种文档工具来构建 Web 服务的后端，以便与 OAuth 一起在多个客户端中使用，并且可以进行多次修订。我已经了解养蜂场，但做了一些研究，我发现其他相当不错的solutions有着丰厚的 promise 。

RAML 似乎有望实现良好的代码生成和 API 可重用性。但它似乎无法创建模拟服务器。我不明白为什么 apiblueprint 不能用于生成 REST API 的客户端库和服务器端框架。

对我们来说，最好的用例是基于 API 文档，可以自动生成用于使用服务的客户端 iOS/Android/wp/js 库以及提供编写代码框架的 Node Express/restify 应用程序。以及 API 测试和负载测试。

RAML/Swagger/Apiary 中的哪种解决方案最适合这个问题？

Answer 1

请查看Swagger Codegen (免费、开源)，它可以生成不同语言的服务器 stub 和 API 客户端。

许多公司/项目正在生产中使用它:https://github.com/swagger-api/swagger-codegen#companiesprojects-using-swagger-codegen

支持的语言/框架:

API 客户端:ActionScript、Bash、C#(.net 2.0、4.0 或更高版本)、C++(cpprest、Qt5、Tizen)、Clojure、Dart、Elixir、Go、Groovy、Haskell、Java (Jersey1.x、Jersey2.x、OkHttp、Retrofit1.x、Retrofit2.x、Feign)、Node.js(ES5、ES6、带有 Google Closure 编译器注释的 AngularJS)Objective-C、Perl、PHP、Python、Ruby、Scala 、Swift(2.x、3.x)、Typescript(Angular1.x、Angular2.x、Fetch、jQuery、Node)

服务器 stub :C#(ASP.NET Core、NancyFx)、Erlang、Go、Haskell、Java(MSF4J、Spring、Undertow、JAX-RS:CDI、CXF、Inflector、RestEasy)、 PHP(Lumen、Slim、Silex、Zend Expressive)、Python(Flask)、NodeJS、Ruby(Sinatra、Rails5)、Scala(Finch、Scalatra)

API 文档生成器:HTML、Confluence Wiki

免责声明:我是开源项目的主要贡献者之一。

更新:2018 年 5 月，Swagger Codegen 的约 50 位顶级贡献者和模板创建者决定 fork Swagger Codegen 以维护一个名为 OpenAPI Generator 的社区驱动版本。 。请引用Q&A了解更多信息。