目录

一、@Api

二、@ApiOperation

三、@ApilmplicitParam

四、@ApilmplicitParams

五、@ApiParam

六、@ApiModel和@ApiModelProperty

---

一、@Api

多作用在Controller类上，用来描述类信息

参数：
1.description：描述这个类的作用。
2.tags：设置这个类的一个标签。

@Api(tags = "招聘管理",description = "用于招聘模块的测试")
@Controller
public class ResumeController {

}

二、@ApiOperation

作用在Controller类的方法上，用来描述接口信息

参数：value可以加以说明

    @ApiOperation(value = "简历的查询")
    @RequestMapping(value="findResumeByID",method = RequestMethod.GET)
    @ResponseBody
    public DataResult findResume(String resumeID){
        
        }
    }

三、@ApilmplicitParam

作用在Controller类的方法上，用来描述接口的参数信息(单参)

参数：

1. name ：参数名。（注意这个名字要与实际方法中的参数名一致，不然会导致swagger界面出现多个参数）
2. value ： 参数的具体意义，作用。（与方法上的参数名对应）
3. required ： 参数是否必填。
4. dataType ：参数的数据类型。
5. paramType ：查询参数类型，这里有几种形式：
6. 类型 作用
7. path 以地址的形式提交数据
8. query 直接跟参数完成自动映射赋值
9. body 以流的形式提交 仅支持POST
10. header 参数在request headers 里边提交
11. form 以form表单的形式提交 仅支持POST

    @ApiImplicitParam(value = "根据简历id查询唯一的一份简历", name = "resumeID", paramType = "query", dataType = "String")
    @RequestMapping(value="findResumeByID",method = RequestMethod.GET)
    @ResponseBody
    public DataResult findResume(String resumeID){
        
        }
    }

四、@ApilmplicitParams

作用在Controller类的方法上，用来描述接口的参数信息(多参)

在注解里面在包含多个@ApiImplicitParam注解，每个注解使用逗号隔开

    @ResponseBody
    @RequestMapping(value="findResumeByCand",method = RequestMethod.POST)
    @ApiOperation(value = "多条件查询")
    @ApiImplicitParams({
            @ApiImplicitParam(value="姓名",name="name",dataType="Stirng",paramType = "query"),
            @ApiImplicitParam(value="简历状态",name="status",dataType="Stirng",paramType = "query"),
            @ApiImplicitParam(value="简历来源",name="source",dataType="Stirng",paramType = "query"),
            @ApiImplicitParam(value="开始时间",name="startTime",dataType="Stirng",paramType = "query"),
            @ApiImplicitParam(value="结束时间",name="endTime",dataType="Stirng",paramType = "query")
    })
    public DataResult findResumeByCand(String name,String status,String source,String startTime,String endTime){
        
        }
    }

五、@ApiParam

作用在方法的参数上，用来描述接口的参数信息(一个参设置一个)

增加对参数的元信息说明

    @RequestMapping(value="uploadFile",consumes = "multipart/*",headers = "content-type=multipart/form-data",method = RequestMethod.POST)
    @ResponseBody
    public DataResult uploadFile(@ApiParam(value = "上传文件",required = true) MultipartFile file, String resumeID,HttpServletRequest request)throws IOException{
        
        }

    }

六、@ApiModel和@ApiModelProperty

当参数是以一个java对象时

@ApiModel：作用在实体类上

@ApiModelProperty：作用在实体类的属性上

@ApiModel(value="AppInfo",description="App信息实体类")
pubilc class AppInfo{
    @ApiModelProperty("App的id")
    private Interger id;
    @ApiModelProperty("软件名称")
    private String softwareName;

}