校验非空的注解@NotNull如何取得自定义的message

472 阅读 0 评论 312 点赞

我是靠谱客的博主复杂咖啡，最近开发中收集的这篇文章主要介绍校验非空的注解@NotNull如何取得自定义的message，觉得挺不错的，现在分享给大家，希望可以做个参考。

概述

校验非空的注解@NotNull如何取得自定义的message

由于项目表单需要校验字段过多，一个一个去判空太麻烦，所以用了@NotNull注解，字段为空会抛出MethodArgumentNotValidException异常。

接下来要取得@NotNull(message=“自定义异常”)里的message内容给前端显示

直接贴上代码：

public String  getMessage（MethodArgumentNotValidException exception）{
String message =  exception.getBindingResult().getFieldError().getDefaultMessage()；
return message；
}

用法：定义一个全局异常处理

一旦发生该类异常，就会捕捉处理，返回给前端信息，返回类Result要根据自己项目业务需要来定义

@NotNull 等注解的简单使用

springboot 2.3.0 以后不会自动引入jar包,所以要添加以下maven

2.3以前则不需要引入maven包

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

注册一个账号, 有账号+密码

前端会做一个判空,但是后端同时也要做一个判空,防止url直接访问

这时后端的代码通常是

if(name!=null){
 return "账号不能为空,请重新输入";
}
else if(password!=null){
 return "密码不能为空,请重新输入";
}

这样就会显得特别low,而且极不美观

这时候就要用到一个注解@NotNull

简单举例说明：

@Data
public class UserInfo {
    @NotNull(message = "姓名不能为null")
    private String name;
    @Max(value = 30,message = "年龄不能超过30")
    private Integer age;    
    private Integer password;
    private String sex;
}

Controller层

简单举例说明

@RestController
public class TestController {
    @RequestMapping("test1")
    public Object test1(@Valid @RequestBody UserInfo userInfo,BindingResult result){
  //判断有没有异常错误,如果有则返回默认消息
       if (result.hasErrors()){
            String defaultMessage = result.getFieldError().getDefaultMessage();
            return defaultMessage;
        }
        //打印一下数据结构
        System.out.println(userInfo); 
        //如果没有错误,返回注册成功
        return "注册成功";
    }
  }

用postMan 传入json 参数,name有值,年龄超过30岁

返回我们的设定

name 为null 同理，会按顺序判断!

但是问题又来了，难道我们每个Controller层的方法里面都要写一个判断方法?

当然不，这时候就要用到全局异常类了

起一个类

@ControllerAdvice
public class ControllerException {
    @ResponseBody
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public Object handleValidException(MethodArgumentNotValidException e) {
    
        //将错误信息返回给前台
        return e.getBindingResult().getFieldError().getDefaultMessage();
    }
}

为了有所区分，写下另一个访问方法

 @RequestMapping("test2")
    public Object test1(@Valid @RequestBody UserInfo userInfo){
        
        System.out.println(userInfo);
        return "注册成功";
    }

这时候我们传入参数

到此结束，再也不用写一堆各种判空了

附上部分注解

@Null 限制只能为null
@NotNull 限制必须不为null
@AssertFalse 限制必须为false
@AssertTrue 限制必须为true
@DecimalMax(value) 限制必须为一个不大于指定值的数字
@DecimalMin(value) 限制必须为一个不小于指定值的数字
@Digits(integer,fraction) 限制必须为一个小数，且整数部分的位数不能超过integer，小数部分的位数不能超过fraction
@Future 限制必须是一个将来的日期
@Max(value) 限制必须为一个不大于指定值的数字
@Min(value) 限制必须为一个不小于指定值的数字
@Past 限制必须是一个过去的日期
@Pattern(value) 限制必须符合指定的正则表达式
@Size(max,min) 限制字符长度必须在min到max之间
@Past 验证注解的元素值（日期类型）比当前时间早
@NotEmpty 验证注解的元素值不为null且不为空（字符串长度不为0、集合大小不为0）
@NotBlank 验证注解的元素值不为空（不为null、去除首位空格后长度为0），不同于@NotEmpty，@NotBlank只应用于字符串且在比较时会去除字符串的空格
@Email 验证注解的元素值是Email，也可以通过正则表达式和flag指定自定义的email格式

二次更新：所有的Controller 都写这样的代码就要封装成异常类

import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;
/**
 * @author ：lsy
 * @date ：Created in 2020/7/23 10:13
 * @modified By：
 */
@ControllerAdvice
public class ControllerException {
    private final static String EXCEPTION_MSG_KEY = "Exception message : ";
    @ResponseBody
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public Object handleValidException(MethodArgumentNotValidException e) {
        //日志记录错误信息
       // log.error(Objects.requireNonNull(e.getBindingResult().getFieldError()).getDefaultMessage());
        //将错误信息返回给前台
       // return BaseResult.fail(500, Objects.requireNonNull(e.getBindingResult().getFieldError()).getDefaultMessage());
        return e.getBindingResult().getFieldError().getDefaultMessage();
    }
}

不需要写BindingResult 也可以返回message

以上为个人经验，希望能给大家一个参考，也希望大家多多支持靠谱客。