asp.net-core - 如何从 OpenAPI 3.0 架构生成 ASP.NET Core 2 控制器？

Question

我有一个 OpenAPI 3.0 架构 YAML 文档，它定义了一些包含所有必需参数和响应的 API 端点。

现在，我想生成一些样板的服务器端代码：控制器及其方法。我的 API 将使用 ASP.NET Core 2 编写。那么，是否可以使用某种生成器，还是应该手动执行？

PS我知道我可以生成客户端代码，但我现在不需要它......

Answer 1

请尝试OpenAPI Generator，它是 Swagger Codegen 的社区驱动版本，同时支持 OpenAPI 规范 v2、v3。

有关我们（主要贡献者）为什么分叉它的更多信息，请参阅问答

如果你已经安装了 docker，你可以使用以下命令轻松尝试

docker run --rm -v ${PWD}:/local openapitools/openapi-generator-cli generate \
    -i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml \
    -g aspnetcore \
    -o /local/out/aspnetcore

如有任何问题或反馈，请通过https://github.com/OpenAPITools/openapi-generator/issues/new开票

公共聊天室：https ://join.slack.com/t/openapi-generator/shared_invite/enQtNzAyNDMyOTU0OTE1LTY5ZDBiNDI5NzI5ZjQ1Y2E5OWVjMjZkYzY1ZGM2MWQ4YWFjMzcyNDY5MGI4NjQxNDBiMTlmZTc5NjY2ZTQ5MGM

Answer 2

我认为 NSwag 存在一些生成服务器端代码的工具。

源代码：https ://docs.microsoft.com/en-us/aspnet/core/tutorials/getting-started-with-nswag?view=aspnetcore-5.0&tabs=visual-studio

工具 NSwagStudio 还有一个用于控制器生成的选项