一、@RequestParam

主要用于将请求参数区域的数据映射到控制层方法的参数上

// http://localhost:8080/wh/user/edit?Id=9452659856325148452&name=天天向上
// @RequestParam源码@Target({ElementType.PARAMETER}) // 只能作用于参数上@Retention(RetentionPolicy.RUNTIME)@Documentedpublic @interface RequestParam {     // 定义参数名称，默认和名字一致    @AliasFor("name")    String value() default "";    // 定义参数名称，默认和名字一致    @AliasFor("value")    String name() default "";    // 默认必填，一旦加上该注解，前台必须传递此参数    boolean required() default true;    // 定义默认值    String defaultValue() default "\n\t\t\n\t\t\n\ue000\ue001\ue002\n\t\t\t\t\n";}

1、@RequestParam有三个配置参数：
required表示是否必传，默认为 true（可省略不写）。
defaultValue可设置请求参数的默认值（可省略不写）。
value为接收url的参数名（一般与接收参数名相同）。

小知识点：@AliasFor是一个注解,用于为注解属性声明别名。上方源码有两个属性value和name 被@AliasFor注解注释了自身，并且value和name 互为别名。

2、@RequestParam加与不加的区别：

    // userType非必传    @GetMapping("/userList1")    @ApiOperation(value = "获取所有账号")    public ApiResult<List> getUserList(Integer userType) {        return ApiResult.data(userService.getUserList(userType));    }    // userType非必传    @GetMapping("/userList2")    @ApiOperation(value = "获取所有账号")    public ApiResult<List> getUserList(@RequestParam(value = "userType", required = false) Integer userType) {        return ApiResult.data(userService.getUserList(userType));    }    // userType必传    @GetMapping("/userList3")    @ApiOperation(value = "获取所有账号")    // 或者参数前也可以只加@RequestParam，默认必传    public ApiResult<List> getUserList(@RequestParam(value = "userType", required = true) Integer userType) {        return ApiResult.data(userService.getUserList(userType));    }    // userType必传（@RequestParam默认required=true）    @GetMapping("/userList4")    @ApiOperation(value = "获取所有账号")    public ApiResult<List> getUserList(@RequestParam Integer userType) {        return ApiResult.data(userService.getUserList(userType));    }
1不加@RequestParam前端的参数名需要和后端控制器的变量名保持一致才能生效
2不加@RequestParam参数为非必传，加@RequestParam写法参数为必传。但@RequestParam可以通过@RequestParam(required = false)设置为非必传。
3@RequestParam可以通过@RequestParam(“userId”)或者@RequestParam(value = “userId”)指定传入的参数名。
4@RequestParam可以通过@RequestParam(defaultValue = “0”)指定参数默认值
5如果接口除了前端调用还有后端RPC调用，则不能省略@RequestParam，否则RPC会找不到参数报错
6

不加@RequestParam注解，或@RequestParam注解required=false：url可带参数也可不带参数，输入 localhost:8080/userList1 以及 localhost:8080/userList1 ?userType=xxx 方法都能执行

加@RequestParam注解：url必须带有参数。也就是说你直接输入localhost:8080/userList3 会报错，不会执行方法。只能输入localhost:8080/userList3?userType=xxx 才能执行相应的方法

3、举些栗子：@RequestParam与@PathVariable一起用，以及一些参数校验注解

    // id必传，且用@NotNull注解不能为null，keyWord非必传    @GetMapping("/catalogue/{id}")public ApiResult<List> selectFilePage(@ApiParam(value = "目录ID（根目录：固定值'0'）", required = true) @NotNull(message = "请选择目录") @PathVariable Long id, @ApiParam(value = "搜索关键词") @RequestParam(required = false) String keyWord) {return ApiResult.data(null);}    //两个参数都必传，用到了@NotNUll、@Length、@Pattern参数校验注解，在文末有讲解@PutMapping("/refuse")public ApiResult refuse(@NotNull(message = "订单ID不能为空") @RequestParam("id") Long id, @NotNull(message = "退回原因不能为空") @Length(max = 200, message = "退回原因最多允许输入200个字符") @Pattern(regexp = "^[\\u4E00-\\u9FA5A-Za-z0-9\\s\\u00a0\\u3000`~!@#$%^&*()+=_|{}':;',\\\\\\[\\]./?~！@#￥%……&*（）——+|｜{}【】‘；：”“’\"。，、？《》「」¥～-]*$", message = "退回原因不允许输入特殊字符") @RequestParam("reason") String reason) {return ApiResult.data(null);}

二、@PathVariable

通过@PathVariable可以将URL中占位符参数绑定到控制器处理方法的入参中：URL 中的 {xxx} 占位符可以通过@PathVariable(“xxx“) 绑定到操作方法的入参中。

// http://localhost:8080/wh/user/edit/9536258451259455114
// 源码@Target({ElementType.PARAMETER})@Retention(RetentionPolicy.RUNTIME)@Documentedpublic @interface PathVariable {    @AliasFor("name")    String value() default "";    @AliasFor("value")    String name() default "";    boolean required() default true;}

1、required默认必传。

2、举个栗子

    // @PathVariable可以用来映射URL中的占位符到目标方法的参数中    @GetMapping("/detail/{id}")    @ApiOperation(value = "系统用户查看详情", notes = "传入userId")    public ApiResult detail(@ApiParam(value = "主键", required = true) @PathVariable Long id) {        return ApiResult.data(userService.detail(id));    }    // 两个参数都必传    @GetMapping("/detail/{applyId}/{source}")public ApiResult detail(@ApiParam(value = "审批流id", required = true) @PathVariable("applyId") Long applyId,                                                   @ApiParam(value = "来源：1->业务审批；2->评审信息；3->续约信息", required = true) @PathVariable("source") Integer source){return ApiResult.data(contractReviewApplyService.detail(applyId,source));}    // 两个参数都必传，且都不能为空    @PostMapping("/customer/rename/{customerId}")    public ApiResult customersRename(@Valid @RequestBody @NotEmpty(message = "参数不能为空") List renameList,                                      @NotNull(message = "客户id不能为空") @PathVariable("customerId") Long customerId) {        return ApiResult.status(customerService.customersRename(renameList,customerId));    }

三、@RequsetBody

@RequestBody主要用来接收前端传递给后端的json字符串中的数据的(请求体中的数据的)；而最常用的使用请求体传参的无疑是POST请求了，所以使用@RequestBody接收数据时，一般都用POST方式进行提交。

    @PostMapping("/")    @ApiOperationSupport(order = 3)    @ApiOperation(value = "新增或编辑", notes = "")    public ApiResult saveOrUpdate(@RequestBody List list) {        return ApiResult.status(true);    }    // @RequestBody与@RequestParam联用    @PostMapping("/save")    @ApiOperationSupport(order = 1)    @ApiOperation(value = "简历草稿记录表新增", notes = "传入ResumeImportVO")    public ApiResult save(@RequestParam(value = "id", required = false) Long id, @RequestBody ErpResume erpResume) {        return ApiResult.data(null);    }    // @RequestBody与@PathVariable联用    @PostMapping("/submit/{queryType}/{type}")    public ApiResult submit(@Valid @RequestBody ErpResume erpResume,                                     @ApiParam(value = "简历类型：1-公共简历，2-个人简历", required = true) @PathVariable Integer queryType,                                     @ApiParam(value = "按钮类型:1->上传简历；2->编辑；3->批量上传保存简历；4->保存简历后编辑简历；5->覆盖原简历", required = true) @PathVariable Integer type) {        return ApiResult.data(null);    }

使用@RequestBody时注意

1. 不支持get请求，因为get请求没有HttpEntity
2. 必须要在请求头中申明content-Type（如application/json）.springMvc通过HandlerAdapter配置的HttpMessageConverters解析httpEntity的数据，并绑定到相应的bean上
3. 在后端的同一个接收方法里，@RequestBody与@RequestParam()可以同时使用，@RequestBody最多只能有一个，而@RequestParam()可以有多个。
4. 建议最好不要与@RequestParam一起使用，是因为@RequestBody会将InputStream吃掉，造成后面的@RequsetParam无法匹配到参数而报400

四、接口参数校验，部分常用注解
@NotEmpty 验证注解的元素值不为null且不为空（字符串长度不为0、集合大小不为0）
@NotBlank 验证注解的元素值不为空（不为null、去除首位空格后长度为0），不同于@NotEmpty，@NotBlank只应用于字符串且在比较时会去除字符串的空格
@Max(value) 限制必须为一个不大于指定值的数字
@Min(value) 限制必须为一个不小于指定值的数字
@Pattern(value) 限制必须符合指定的正则表达式
@Size(max,min) 限制字符长度必须在min到max之间
@Length 验证字符串长度是否在给定的范围之内
@Email 验证注解的元素值是Email，也可以通过正则表达式和flag指定自定义的email格式
@ApiParam是用于swagger提供开发者文档，文档中生成的注释内容。value：参数描述；
defaultValue：参数默认值；required：是否为必传参数，默认为false。
@Valid 注解通常用于对象属性字段的规则检测，适用于基本数据类型(Integer，Long，Double等等)，如下：
@NotNull： 注解被使用在 String 类型的数据上，表示该数据不能为 Null（但是可以为 Empty）；
@NotBlank：适用于 String 类型的数据上，加了@NotBlank 注解的参数不能为 Null 且 trim() 之后 size > 0；
@NotEmpty：适用于 String、Collection集合、Map、数组等等，加了@NotEmpty 注解的参数不能为 Null 或者 长度为 0；