Swagger key configuration items

1. Swagger in paramType

Swagger in paramType
paramType： Indicates where the parameter is placed
header–> Get request parameters ：@RequestHeader( Receiving comments in code )
query–> Get request parameters ：@RequestParam( Receiving comments in code )
path（ be used for restful Interface ）–> Get request parameters ：@PathVariable( Receiving comments in code )
body–> Get request parameters ：@RequestBody( Receiving comments in code )
form（ Not commonly used ）

demo_form:

 @PostMapping(value = "add", headers = "content-type=multipart/form-data")
    @ApiOperation(" Attachment saving interface ( Multi file upload is not supported swagger test )")
    @ApiImplicitParams({
    
    @ApiImplicitParam(name = "id", value = "*id", example = "10086", paramType = "form", required = true),
    @ApiImplicitParam(name = "status", value = " Attachment status ", example = "3",
            paramType = "form", allowableValues = "2,3", required = true)
    })
    public Result add(AddDTO addDTO,
     @ApiParam(value = "* The attachment ") @RequestParam(value = "materialSigns", required = false)
             MultipartFile[] file,
    ) {
    

2. dataType Set up
allowMultiple： Allow multiple , namely ： Array or collection .
dataType： The element type of an array or collection , namely ： Class name .

Annotation configuration of custom type

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

If the element type is native , Such as ：int、String And so on. , There is no need for this step .
If the element type is a custom type , Such as ：UserDto, This step is necessary , In order to swagger You can find the corresponding type of this element .