如何在数组或枚举中将枚举值定义为map属性中的键?

时间:2017-10-09 04:34:38

标签: rest api yaml swagger-2.0 swagger-codegen

我使用swagger-codegen-maven-plugin(2.2.1)从YML配置生成java和typescript代码类文件。我有两个问题。

如何在YML中定义枚举属性数组?

如何将map属性枚举定义为键,将布尔值定义为YML中的值?

让我知道是否有可能或有任何解决方法?目前,我在java和typescrtipt中定义了enum类,并将其作为字符串传递。谢谢。

DataInfo:
       type: object
       properties:
          enumTest:        -- works fine
            type: string
            enum:
              - one
              - two   
           enumTestArray:   --failing to generate code
              type: array
              items:
                 type: string
                 enum:
                  - one
                   -two  
              testMap:   -- works fines generate Map<String, Boolean> and { [key: string]: boolean; };
                type: object         
                additionalProperties:
                    type: boolean 

swagger enum doc

Map Property

更新

与第一个问题相关:定义枚举属性的数组。 swagger-codegen-maven-plugin生成无效的java类文件,如下所示:生成&lt ;,&gt;和&#34;字符。

@XmlType(name="List&lt;EnumTestArrayEnum&gt;")
@XmlEnum
public enum List&lt;EnumTestArrayEnum&gt; {

    ONE(List&lt;String&gt;.valueOf("&quot;one&quot;")), TWO(List&lt;String&gt;.valueOf("&quot;two&quot;"));


    private List&lt;String&gt; value;

    List&lt;EnumTestArrayEnum&gt; (List&lt;String&gt; v) {
        value = v;
    }

    public String value() {
        return value;
    }

    public static List&lt;EnumTestArrayEnum&gt; fromValue(String v) {
        return valueOf(v);
    }
}

1 个答案:

答案 0 :(得分:1)

  

如何在YML中定义枚举属性数组?

您的enumTestArray示例几乎是正确的 - 您只需要在&#34; - &#34;之间留出空格。和&#34;两个&#34;使YAML有效:

           enumTestArray:
              type: array
              items:
                 type: string
                 enum:
                  - one
                  - two  # <----
  

如何将map属性枚举定义为键,将布尔值定义为YML中的值?

在OpenAPI / Swagger中,地图键是任意字符串,它是not possible to limit the key names or format。您可以在description

中口头记录密钥格式

或者,由于键是已知的(仅限于某些已知的枚举),因此您可以将所有可能的键定义为可选属性。不优雅,但它可能适合你。

              testMap:
                type: object
                properties:
                  one:
                    type: boolean
                  two:
                    type: boolean
                  ...

还建议添加support for patternProperties,这样可以将键名限制为正则表达式。