Internship: the annotation under swagger involves the provision of interfaces

knife4j：
Knife4j Is a can provide online API Document framework , Is based on Swagger Framework implementation
That is, compared with the previous Unused annotations ：
@API
Has two properties :value、tags, Source code is as follows

//If tags is not used,this value will be used to set the tag for the operations described by this resource. Otherwise, the value will be ignored.
 String value() default "";

 //Tags can be used for logical grouping of operations by resources or any other qualifier.
 String[] tags() default {
    ""};

@Api(tags = "list1")
@Api(tags = {
    "list1","list2"})

@ApiOperation
 Used in methods , It means a http Requested operation 
 There are too many attributes in the source code , Remember some commonly used 
value—— Used for method description 
notes—— Used to prompt content 
tags—— You can regroup 

@ApiParam
 Use on methods or parameters , Field description ; Represents adding metadata to parameters （ Description or whether it is required, etc ）
name– Parameter name 
value– Parameter description 
required– If required 

@ApiModel()
 Use on class , Represents a description of a class , Used for parameter receiving with entity class 
value– Represents the object name 
description– describe 

@ApiModelProperty()
 Use in method , Field , Said to model Property description or data operation change 
value– Field description 
name– Override property name 
dataType– Override property type 
required– If required 
example– Illustrate with examples 
hidden– hide