【快学springboot】4.接口参数校验

前言

在开发接口的时候，参数校验是必不可少的。参数的类型，长度等规则，在开发初期都应该由产品经理或者技术负责人等来约定。若是不对入参作校验，颇有可能会由于一些不合法的参数而致使系统出现异常。

上一篇文章讲了多种接受参数的方法【快学springboot】3.多种接受参数的方式。由于目前json类型的参数是最经常使用的，因此这里只讲解json类型的参数校验。其余类型的大同小异。

新建一个Param.java

public class Param {
 
 private String username;
 public String getUsername() {
 return username;
 }
 public void setUsername(String username) {
 this.username = username;
 }
}
复制代码

目前这个类只有一个username属性。

使用Validated注解开启参数校验

@PostMapping(value = "/validate/notblank")
public Object validateNotBlank(@RequestBody @Validated Param param) {
 return param;
}
复制代码

NotBlank 非空判断

修改Param.java，在username属性上添加NotBlank注解

@NotBlank
private String username;
复制代码

测试

经过控制台，咱们能够看到抛出了一个MethodArgumentNotValidException异常，上面的返回结果实际上是springboot默认的异常捕获器返回的。为了统一接口的数据返回格式，咱们也须要自定义一个全局异常拦截器，这个将会在下一讲中讲解。

咱们还能够经过NotBlank注解的message属性设置异常信息：

@NotBlank(message = "username不可为空")
private String username;
复制代码

Length字符串长度判断

仍是那个Param.java，咱们给username加上Length注解，以下：

@Length(min = 2,max = 3)
@NotBlank(message = "username不可为空")
private String username;
复制代码

一样，咱们也可使用message属性来设置返回错误信息。这里就不演示了。

NotNull 限制属性不可谓null

虽然前面有NotBlank注解了，可是一些Integer,Long等包装类型，仍是须要用到NotNull注解来判断。

范围判断Min和Max

在Param.java上新增一个age属性，而且使用Min和Max注解限定大小

@Min(1)
@Max(100)
private Integer age;
复制代码

这样写的问题是，若是age为空，则不会校验。以下：

因此咱们还须要加上NotNull注解

@Min(1)
@Max(100)
@NotNull
private Integer age;
复制代码

也可以使用@Range注解来限定范围

@Range(min = 1, max = 100)
复制代码

Email 注解校验邮件

@Email
private String email;
复制代码

Pattern 注解校验正则表达式

@Pattern(regexp = "\d{4}-\d{2}-\d{2}")
private String birthday;
复制代码

总结

以上总结了部分经常使用的参数校验的方法，固然还有很详细的一些没有列举处理，有须要的，能够自行搜索使用方式便可。参数校验，每每须要和全局的异常拦截器来配套使用，使得返回的数据结构永远是保持一致的，这样才能方便客户端解释。

下一节会对统一返回格式和全局异常拦截器作一个讲解。