当前位置: 首页 > 知识库问答 >
问题:

为什么多个类型在Swagger UI中以不好的方式显示

雷国兴
2023-03-14

我有以下开放式api模式:

    WaypointEntity:
      type: object
      properties:
        id:
          type: [number, "null"]

但它在大摇大摆的用户界面中没有正确显示:

知道为什么吗?AmI指定类型不正确?我正在使用OpenApi 3.0

共有1个答案

谭京
2023-03-14

在OpenAPI 3.0中,type不能是类型列表,它必须是单个类型。可为空的数字定义如下:

id:
  type: number
  nullable: true   # <----

更多信息:如何在OpenAPI中定义可以是字符串或null的属性?

 类似资料:
  • 问题内容: 我定义了一个Java函数: 一种调用方式是这样的: 为什么不能通过显式传递泛型类型参数来调用它?: 我从编译器得到错误。 问题答案: 当Java编译器无法自行推断静态方法的参数类型时,您始终可以使用完整的合格方法名称Class来传递它。<类型> method();

  • 在阅读参考资料时。com文档中的std::numeric_limits,我遇到了以下声明: 还提供了所有整数类类型的专门化。(从20世纪开始) 我的问题是,我们在上面的语句中所说的整数类类型是什么意思。我的意思是,我知道是C中的内置类型。我们可以在C中提供用户定义的类。但是我从来没有读过关于整数类类型的文章。我试着在谷歌上搜索这个短语,但是没有找到任何与此相关的东西。

  • 我不明白如何在Eclipse中创建文件夹和包,特别是在Package Explorer中。Eclipse创建和表示源文件夹和包的方式似乎不一致。 这在很大程度上与使用标准文件夹结构(src/main/java、src/main/test等)有关,然后在它们下面有包。有时Eclipse会折叠文件夹,下面是包,如下所示: 而其他时候,文件夹相互嵌套,每个文件夹都是分开的。它不是单一的“src/main

  • 我有以下avro模式 然而,当我通过kafka流式传输一些事件以与此模式产生火花时,流式数据帧将数据字段描述为一个结构,其成员具有模式中指定的DataType,如下图所示。

  • 问题内容: 在哪里返回。这不会编译…我 几乎 可以理解为什么。但是,如果我想从一个空白中返回一个空白,为什么不呢?相反,我最终写了这样的东西: 我不是在寻找代码样式建议,我想知道为什么Java明确禁止这种类型的void返回。任何信息表示赞赏,谢谢。 问题答案: 带有表达式的return语句返回该表达式的值。的类型的是空隙表达-它不 具有 一个值。 从逻辑上讲,您想执行,然后返回-所以您必须说。这两

  • 看看下面例子中泛型类型的类型推断,我说不出为什么工作得很好,但是(几乎相同)无法编译,为了管理它,编译器需要额外的技巧,比如或。 导致编译器不确定表达式类型和方法结果类型是否兼容的问题是什么?