闊歩2.0

Question

type": "array", 
"items": { 
    "type": "string", 
    "enum": ["MALE","FEMALE","WORKER"] 
} 

又は

type": "array", 
"items": { 
    "type": "string", 
}, 
"enum": ["MALE","FEMALE","WORKER"] 

にアレイの列挙を定義しますか？

これに関する仕様はありません。もちろん、目標は列挙値を表示するためにswagger-uiを取得することです。

Answer 1

最初のケースは正しいですし、最近ではswagger-uiが列挙型の値の複数選択を生成しています。

Answer 2

それはあなたが列挙したいかに依存します：

をそれぞれ列挙値は、最初のケースで説明したオブジェクトタイプ

• のうちの第2のString
• 文字列
の配列でなければなりません

最初の構文の意味これは、この配列の文字列に指定できる値です。

AnArray: 
    type: array 
    items: 
    type: string 
    enum: 
     - MALE 
     - FEMALE 
     - WORKER 

この配列には複数のStringを含めることができますが、各StringにはMALE、FEMALEまたはWORKER値が必要です。

もう一つは、これらがそれぞれ列挙値は、従って、配列され、このアレイ

AnotherArray: 
    type: array 
    items: 
    type: string 
    enum: 
    - 
     - FEMALE 
     - WORKER 
    - 
     - MALE 
     - WORKER 

の可能な値である意味します。この例では、この配列は可能な値["FEMALE"、 "WORKER"]と["MALE"、 "WORKER"]のみを持つことができます。

この構文が有効であっても、Swagger UIに列挙値は表示されません。