在swagger的@ApiOperation中回应

Question

假设，如果我的response为Map<String, List<SomeClass>>，如何在代码段@ApiResponse(value="", response="")的响应字段中指定？我的意思是我应该放入responseContainer？

Answer 1

事实上，我正在寻找类似响应处理的答案。但我只能找到这个Can Swagger @APIOperation allow to specify a list of list in Java?。虽然没有说服力但有效。

Answer 2

我正在使用swagger 2.9.2，并且在UI中显示复杂数据结构没有问题。

假设您的dto类中具有字段“ mapOfSets”：

@ApiModelProperty(value = "A map of sets", position = 4)
private Map<String, Set<String>> mapOfSets;

然后在宽大的用户界面中将显示如下：

在我们的项目中使用了2个Maven依赖项：

    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger2</artifactId>
        <version>2.9.2</version>
    </dependency>
    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger-ui</artifactId>
        <version>2.9.2</version>
    </dependency>