Gin 的 Fizz OpenAPi 生成器正在重命名类型

gin 的 fizz openapi 生成器正在重命名类型

问题内容

我创建了一个用 gin 编写的简单 api。我使用 fizz 生成 openapi 3 规范。这是我的 post 端点:

// sets user route groupfunc userroute(grp *fizz.routergroup) {    // create new user    grp.post("", []fizz.operationoption{        fizz.summary("creates new user and sends verification mail."),        ...    }, tonic.handler(handlers.createuser, 201))}

登录后复制

这是处理程序方法:

// Creates new userfunc CreateUser(c *gin.Context, register *models.Register) error {    ...    return nil}

登录后复制

问题在于,在生成的 json 规范中,“register”模型显示为“createuserinput”:

有什么办法可以解决这个问题吗?或者这是正常现象吗?

正确答案

根据实现,模式名称由以下语句生成: name := strings.title(op.id) + “input” (请参见下面的 23 行):

1  // setOperationParams adds the fields of the struct type t 2  // to the given operation. 3  func (g *Generator) setOperationParams(op *Operation, t, parent reflect.Type, allowBody bool, path string) error { 4      if t.Kind() != reflect.Struct { 5          return errors.New("input type is not a struct") 6      } 7      if err := g.buildParamsRecursive(op, t, parent, allowBody); err != nil { 8          return err 9      }10      // Input fields that are neither path- nor query-bound11      // have been extracted into the operation's RequestBody12      // If the RequestBody is not nil, give it a name and13      // move it to the openapi spec's components/schemas section14      // Replace the RequestBody's schema with a reference15      // to the named schema in components/schemas16      if op.RequestBody != nil {17          mt := tonic.MediaType()18          if mt == "" {19              mt = anyMediaType20          }21          sch := op.RequestBody.Content[mt].Schema22          if sch != nil {23              name := strings.Title(op.ID) + "Input"24              g.api.Components.Schemas[name] = sch25              op.RequestBody.Content[mt].Schema = &SchemaOrRef{Reference: &Reference{26                  Ref: componentsSchemaPath + name,27              }}28          }29      }

登录后复制

您可以使用 fizz.id 自定义操作 id,但没有办法去掉input后缀。如果您确实想以不同的方式生成模式名称,则需要分叉存储库并修改实现。

以上就是Gin 的 Fizz OpenAPi 生成器正在重命名类型的详细内容,更多请关注【创想鸟】其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至253000106@qq.com举报,一经查实,本站将立刻删除。

发布者:PHP中文网,转转请注明出处:https://www.chuangxiangniao.com/p/2359230.html

(0)
上一篇 2025年3月1日 17:30:49
下一篇 2025年3月1日 17:31:09

AD推荐 黄金广告位招租... 更多推荐

相关推荐

发表回复

登录后才能评论