swagger生成接口文档和map类型参数解析

Swagger可以通过注解生成接口文档，使用的注解是@Api和@ApiOperation。其中@Api注解用于控制类的信息，如类的描述、作者、协议等；@ApiOperation注解用于控制接口的信息，如接口的描述、请求方式、请求参数、返回值等。

对于Map类型参数的解析，Swagger提供了@ApiModelProperty注解。我们可以在DTO中使用@ApiModelProperty注解来标识Map类型参数的key和value的类型。例如：

@ApiModel("请求参数")
public class RequestDTO {

    @ApiModelProperty(value = "参数map", dataType = "Map<String, String>")
    private Map<String, String> paramMap;
    
    // 省略getters和setters
}

在上面的例子中，我们使用了@ApiModelProperty注解标识了paramMap参数的类型为Map<String, String>，Swagger会自动解析该参数类型，并在接口文档中显示出来。