c# - Swagger Api 文档 - 模型列表

Question

应该如何为Swagger建模此类以正确解释它？

public myEnum {
    alpha,
    bravo,
    charlie
}

public class myClass {
    public List<myEnum> myList { get; set; }
}

我不能简单地这样做：

{
    "myClass": {
        "id": "myClass",
        "properties": {
            "myList": {
                "type": "string", //??? it isn't a string, it's a List...
                "allowableValues": {
                    "valueType": "LIST",
                    "values": [
                        "alpha",
                        "bravo",
                        "charlie"
                    ]
                }
            }
        }
    }
}

这也没有任何意义：

{
    "myEnum": {
        "id": "myEnum",
        "properties": {
            //??? there aren't any...
        }
    },
    "myClass": {
        "id": "myClass",
        "properties": {
            "myList": {
                "type": "List",
                "items": {
                    "$ref": "myEnum"
                }
            }
        }
    }
}

Answer 1

在 Swagger Google Group 中看到这篇文章，这让我得到了这个答案：

{
    "myClass": {
        "id": "myClass",
        "properties": {
            "myList": {
                "type": "List",
                "items": {
                    "type": "string"
                },
                "allowableValues": {
                    "valueType": "LIST",
                    "values": [
                        "alpha",
                        "bravo",
                        "charlie"
                    ]
                }
            }
        }
    }
}