这个项目能做什么
OpenAPI Generator 是一个开源代码生成工具,采用 Apache 2.0 许可证分发。给定 OpenAPI 规范(支持 2.0 和 3.0 版本),它会自动生成 API 客户端库(SDK 生成)、服务器存根、API 文档和配置文件。
支持的输出类别包括:
- 适用于多种语言和框架的 API 客户端,例如 C、C#、C++、Go、Java、Kotlin、Node.js/JavaScript、PHP、Python、Ruby、Rust、Scala、Swift 和 TypeScript,每种语言提供多种 HTTP 库选项。
- 服务器存根,适用于 ASP.NET Core、Go(net/http、Gin、Echo)、Java(Spring、JAX-RS、Vert.x 等)、Kotlin(Spring Boot、Ktor)、PHP(Laravel、Slim、Symfony)、Python(FastAPI、Flask)、NodeJS、Ruby(Sinatra、Rails5)和 Rust 等框架。
- API 文档生成器,支持 HTML、Confluence Wiki、Asciidoc、Markdown 和 PlantUML 格式。
- 其他输出,如 GraphQL、JMeter、MySQL Schema、Postman Collection、Protocol Buffer 和 WSDL。
README 中描述的安装选项包括下载 JAR 文件、启动脚本、从源码构建、Homebrew 以及 Docker 镜像(CLI 和在线版)。该项目提供了从 Swagger Codegen 迁移的指南、维基、FAQ 和面向初学者的电子书。它由 OpenAPI Tools 维护,并注明与 OpenAPI Initiative 无关联。README 还警告,在生成前应审查不受信任的 OpenAPI 规范、模板或输入,以避免潜在的安全问题,如代码注入。
评论
0 评分人数达到10人后显示
登录后参与讨论。