如何在Swagger中区分空列表和一个空参数列表?

时间:2017-05-02 13:27:05

标签: arrays string swagger specifications

我正在实现一个实现Swagger 2.0(OpenAPI)的内部代码生成器。

我面临一种模棱两可的问题,我发现无法通过阅读规范来解决这个问题。

假设我们有一个array类型strings(可以在pathquery,这里也是一样的),这是逗号分隔。

  • 两个元素的列表表示为:a,b
  • 一个元素的列表表示为:a
  • 空列表表示为:
  • 两个空元素的列表表示为:,
  • 一个空元素的列表表示为:

显然,对于空列表列表中的一个空元素具有相同的表示形式是个问题。当然,我可以决定一个空元素的列表表示为,(Python为它的元组做了那个)但是那我应该如何表示两个空元素的列表呢?

当然在查询参数的情况下,我可以通过缺少参数本身来解决模糊性(但这并不能解决path参数的问题,也不能给我任何保证。其他实现做了什么。)

无论如何,我不想“决定”任何东西,而是实施规范。最大化互操作性。但是,我找不到任何关于如何处理这种情况的权威来源。

swagger字符串数组中是否禁止空字符串?我应该忽略它们吗?考虑那些列表无效?

简而言之:在这些情况下我该怎么做?

0 个答案:

没有答案