Swagger重点配置项

1. Swagger中paramType

Swagger中paramType
paramType：表示参数放在哪个地方
header–>请求参数的获取：@RequestHeader(代码中接收注解)
query–>请求参数的获取：@RequestParam(代码中接收注解)
path（用于restful接口）–>请求参数的获取：@PathVariable(代码中接收注解)
body–>请求参数的获取：@RequestBody(代码中接收注解)
form（不常用）

demo_form:

 @PostMapping(value = "add", headers = "content-type=multipart/form-data")
    @ApiOperation("附件保存接口(多文件上传不支持swagger测试)")
    @ApiImplicitParams({
    
    @ApiImplicitParam(name = "id", value = "*id", example = "10086", paramType = "form", required = true),
    @ApiImplicitParam(name = "status", value = "附件状态", example = "3",
            paramType = "form", allowableValues = "2,3", required = true)
    })
    public Result add(AddDTO addDTO,
     @ApiParam(value = "*附件") @RequestParam(value = "materialSigns", required = false)
             MultipartFile[] file,
    ) {
    

2. dataType的设置
allowMultiple：允许多个，即：数组或集合。
dataType：数组或集合的元素类型，即：类名。

自定义类型的注解配置

@ApiModel(value = "UserDto", description = "用户")
public class User implements Serializable {
    
  //...
}

如果元素类型为原生类型，如：int、String之类的，无需此步骤。
如果元素类型为自定义类型，如：UserDto，则必须此步骤，以便swagger能够找到这个元素对应的类型。