openapi-generator

项目概述

OpenAPI Generator 是一个开源项目，旨在根据 OpenAPI 规范（v2.0 和 v3.0）自动生成 API 客户端（SDK）、服务器端桩代码、文档和配置。它支持数十种语言和框架。

主要功能

• 生成 API 客户端库（SDK）
• 生成服务器端桩代码
• 自动生成 API 文档和配置
• 支持 OpenAPI 2.0 和 3.0 规范
• 覆盖 ActionScript、Ada、C、C++、C#、Dart、Go、Java、Python、Ruby、Rust 等多种编程语言

适用人群

• 希望自动化 API 客户端和服务器代码生成的开发者
• 使用 OpenAPI 规范进行 API 设计的团队

快速上手

OpenAPI Generator 提供了多种使用方式：

• 通过 CLI 使用：openapi-generator-cli generate -i petstore.yaml -g java -o /tmp/client
• 通过 npm：npm install @openapitools/openapi-generator-cli -g
• 作为 Maven 或 Gradle 插件 集成到构建流程中

核心优势

• 支持广泛的编程语言和框架
• 高度可定制的代码生成模板
• 活跃的社区和持续的开发支持