SpringBoot参数校验机制之一：基本验证概念

引言

在实际项目开发中，我们会对Controller层接收到的参数进行基本的校验，本文主要介绍SpringBoot项目中使用注解对输入参数进行初步规则校验的方法。本文将从以下几个方面进行阐述。

• Rest请求方式
• 校验框架
• 常用的参数校验注解
• 代码示例

一、Rest请求方式

在当下的WEB后台开发模式下，基本都采用了前后台分离的开放方式。所谓前后台分离就是后台给前段返回统一的JSON格式数据，前端通过解析JSON数据将后台处理的数据展示在页面。前端调用Rest风格的后台接口。

1. Get请求
   一般用于页面展示数据的查询操作，不涉及数据库数据的变化。常用的Controller层注解为@GetMapping。
   
2. POST请求
   提交数据到后台服务，需要修改服务器中的数据。提交的数据放在HTTP请求中的消息体重。常用的Controller层注解为@PostMapping。

DELETE请求

主要通过HTTP请求删除指定URL服务器资源。常见返回的状态码包括：

（1）200（OK）：删除成功，同时返回删除的资源。

（2）202 (Accepted) ： 删除请求已

1. 经接受，但没有被立即执行。
   （3）204 (No Content) - 删除请求已经被执行，但是没有返回资源（也许是请求删除不存在的资源造成的）。
   
2. PUT请求
   主要用于通过HTTP请求的方式ge更改服务器资源，常见的返回状态码包括：
   （1）200 （OK）： 已存在资源被更改。
   （2）201 （created）：如果新资源被创建。
   

二、校验框架

在日常开发工作中，对于Controller层接收的参数进行校验的时候可以通过代码来进行，但是这些校验操作与具体的业务无关，可以通过抽象一个校验工具类的方法实现，但是总会觉得这部分代码糅合在代码中显得臃肿不实用。同时也不能保证验证参数的有效性。Hibernate validator提供了一套基于注解的参数验证机制，它可以与现有框架进行有机集成。spring-boot-starter-web包里面有hibernate-validator包，不需要引用hibernate validator依赖，因为该包中已经包含了hibernate-validator包的引用。

<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
</dependency>

三、常用的参数校验注解

以下表格是一些常用校验注解的说明。

四、代码示例

public class StudentDto {
    @NotNull(message = "field is null")
    private String name;
    @NotNull(message = "field is null")
    @Max(100)
    private int age;
    @NotNull(message = "field is null")
    private boolean sexuality;
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public int getAge() {
        return age;
    }
    public void setAge(int age) {
        this.age = age;
    }
    public boolean isSexuality() {
        return sexuality;
    }
    public void setSexuality(boolean sexuality) {
        this.sexuality = sexuality;
    }
}