通过服务器代码生成,您可以从
OpenAPI 3 规范生成服务器端样板代码。这启用了 API 优先的开发方法,您可以在其中下载基于
API 规范的正在运行的服务器,并将其用作开发业务逻辑的起点。
支持的语言和框架包括:
- Go - Chi 服务器
- NodeJS - 表达
- Java - JAX-RS
- Python - 烧瓶
生成服务器代码
要从您的 OpenAPI 3 规范生成服务器端样板:
1.导航到 API 选项卡。
2.选择一个包含 OpenAPI 3 规范的 API。
3.在右侧边栏中,选择代码生成图标</>。
4.在“代码生成”面板中,选择要为其生成样板的语言和框架,然后选择“生成代码”按钮。
生成的代码将自动下载为 zip 存档。您可能需要打开浏览器的“下载”选项才能找到存档。文件的名称包括生成代码的
API 的名称以及选择的语言和框架。
使用生成的代码
生成的代码结构将取决于您选择的语言。所有受支持的语言都将涵盖 OpenAPI 3.0 规范中的一些主要功能。以下是您可以从生成的代码中获得的一些功能:
- 所有操作都将在您的服务器样板中生成为路由,每个端点都有一段代码,您可以在其中添加业务逻辑。此存根可能包括默认响应,通常取自关联端点的
API 定义响应部分。
- 您可以在适用时访问每个路由中的请求正文、参数、路径参数和标头,并在您的业务逻辑中使用它们。
- 您可以从此生成的代码启动服务器。将有一个README.md文件描述启动服务器的先决条件和说明。
- 有关配置或自定义生成代码的更多详细信息,请参阅框架的相关文档。
仅生成路由和接口
除了为每个端点的实现配置路由和存根生成的代码外,生成的代码还将包括其他文件,如README.md、依赖项列表、服务器设置代码以及所选特定框架所需的其他项目。这些生成的文件很可能会在代码生成后由您编辑和自定义。
下载生成的代码时,您可以选择仅生成路由和接口选项。这只会生成与
OpenAPI 模式中的路径和组件相关的代码,而忽略所有其他文件。这将使您能够仅更新与新的或更改的端点相关的文件,并避免使用生成的样板代码覆盖您的自定义文件。
|