第十二篇:SpringBoot 2.x資料校驗

介紹

在項目的過程中，對于參數的校驗是必須的，如果參數比較少的話我們可以直接通過代碼進行校驗，但是資料較大時再用這個方法就比較笨重了，接下來就該我們的主角

Validation

閃亮登場了

pom.xml

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

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>
           

實際上在這裡資料校驗都是調用的

javax.validation

，

spring-boot-starter-web

中也包含了

hibernate-validator

，有興趣的可以去翻翻文檔

User.java

package com.priv.gabriel.entity;

import lombok.Data;
import org.hibernate.validator.constraints.Length;

import javax.validation.constraints.Min;
import javax.validation.constraints.NotBlank;
import javax.validation.constraints.NotNull;


/**
 * Created with Intellij IDEA.
 *
 * @Author: Gabriel
 * @Date: 2018-10-23
 * @Description:
 */
@Data
public class User {

    @NotBlank(message = "name不允許為空")
    @Length(min = 2,max = 10,message = "你的長度不對勁呀")
    private String name;
    @NotNull(message = "進入未成年人入内！")
    @Min(18)
    private int age;
    @NotBlank(message = "拒絕黑戶")
    private String address;

}
           

接下來隻需要在

Controller

層中使用

@valid

進行校驗就可以了

package com.priv.gabriel.controller;

import com.priv.gabriel.entity.User;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.validation.Valid;

/**
 * Created with Intellij IDEA.
 *
 * @Author: Gabriel
 * @Date: 2018-10-23
 * @Description:
 */
@RestController
@RequestMapping("/user")
public class UserController {

    @RequestMapping("/check")
    public String check(@Valid User user){
        return "檢測完畢！沒有問題";
    }
}
           

用

Rest Client

工具簡單檢測一下

image.png

結果當然是...

{
    "timestamp": "2018-10-23T09:01:45.159+0000",
    "status": 400,
    "error": "Bad Request",
    "errors": [{
        "codes": ["Length.user.name", "Length.name", "Length.java.lang.String", "Length"],
        "arguments": [{
            "codes": ["user.name", "name"],
            "arguments": null,
            "defaultMessage": "name",
            "code": "name"
        }, 10, 2],
        "defaultMessage": "你的長度不對勁呀",
        "objectName": "user",
        "field": "name",
        "rejectedValue": "",
        "bindingFailure": false,
        "code": "Length"
    }, {
        "codes": ["Min.user.age", "Min.age", "Min.int", "Min"],
        "arguments": [{
            "codes": ["user.age", "age"],
            "arguments": null,
            "defaultMessage": "age",
            "code": "age"
        }, 18],
        "defaultMessage": "最小不能小于18",
        "objectName": "user",
        "field": "age",
        "rejectedValue": 17,
        "bindingFailure": false,
        "code": "Min"
    }, {
        "codes": ["NotBlank.user.address", "NotBlank.address", "NotBlank.java.lang.String", "NotBlank"],
        "arguments": [{
            "codes": ["user.address", "address"],
            "arguments": null,
            "defaultMessage": "address",
            "code": "address"
        }],
        "defaultMessage": "拒絕黑戶",
        "objectName": "user",
        "field": "address",
        "rejectedValue": "",
        "bindingFailure": false,
        "code": "NotBlank"
    }, {
        "codes": ["NotBlank.user.name", "NotBlank.name", "NotBlank.java.lang.String", "NotBlank"],
        "arguments": [{
            "codes": ["user.name", "name"],
            "arguments": null,
            "defaultMessage": "name",
            "code": "name"
        }],
        "defaultMessage": "name不允許為空",
        "objectName": "user",
        "field": "name",
        "rejectedValue": "",
        "bindingFailure": false,
        "code": "NotBlank"
    }],
    "message": "Validation failed for object='user'. Error count: 4",
    "path": "/user/check"
}
           

好了，到這裡可以看到我們的設定已經生效了，關于資料校驗你

get

到了嗎？

項目下載下傳位址