V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
walleL
V2EX  ›  程序员

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

  •  
  •   walleL · 2021-09-14 11:20:47 +08:00 · 1190 次点击
    这是一个创建于 1172 天前的主题,其中的信息可能已经有所发展或是发生改变。

    有没有大佬实践过使用 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 函数中调用业务逻辑的实现

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

    2 条回复    2021-09-16 14:43:45 +08:00
    dayeye2006199
        1
    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
        2
    walleL  
    OP
       2021-09-16 14:43:45 +08:00
    @dayeye2006199 #1 好像是可以这么理解,看来我可以参考一下 protoc 的实践,多谢
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   3114 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 35ms · UTC 11:02 · PVG 19:02 · LAX 03:02 · JFK 06:02
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.