使用 swagger-codegen 生成后端代码可行吗

2021-09-14 11:20:47 +08:00
 walleL

有没有大佬实践过使用 swagger-codegen( https://github.com/swagger-api/swagger-codegen) 来生成后端代码?

看代码库中有一些示例,比如: https://github.com/swagger-api/swagger-codegen/tree/master/modules/swagger-codegen/src/main/resources/go-server

这样开发流程就变成了:

  1. 通过 swagger 定义接口文档
  2. 基于接口文档生成接口 handler 函数和 request 、response model
  3. 在 handler 函数中调用业务逻辑的实现

这种方式有什么坑吗?有没有实践案例或者相关文章推荐?

1047 次点击
所在节点    程序员
2 条回复
dayeye2006199
2021-09-15 05:58:53 +08:00
这个模式很常见,interface-based 编程。

后端做 grpc 服务基本都是这么弄的。用 protobuf 先把 data model 和服务接口写出来; protoc 生成 client 和 server 端的教授叫代码;去 server 端填各种具体实现。

swagger-codegen 我的理解就是把 protobuf 替换成 swagger spec,code-gen 替换了 protoc,接口调用编程了普通的 http 调用;但整体思路是一样的。
walleL
2021-09-16 14:43:45 +08:00
@dayeye2006199 #1 好像是可以这么理解,看来我可以参考一下 protoc 的实践,多谢

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/801713

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX