我是靠谱客的博主 健忘柚子,最近开发中收集的这篇文章主要介绍javax.validation校验整理前言,觉得挺不错的,现在分享给大家,希望可以做个参考。

概述

文章目录

  • 前言
    • 一、非空校验
    • 二、长度校验
    • 三、数值校验
    • 四、正则校验
    • 五、自定义校验注解
    • 六、校验组


前言

javax.validation校验总是混淆,特此整理。如有错误,请不吝指正。

一、非空校验

序号注解解释适用场景
1@NotNull不能为null,但可以为empty,没有Size的约束被注解的元素不能为null。接受任何类型
2@NotEmpty不能为null,且Size>0被注解的String、Collection、Map、数组是不能为null或长度为0
3@NotBlank(message =)只用于String,不能为null且trim()之后size>0纯空格的String也是不符合规则的,此注解只能用于验证String类型

小结:

String字段用@NotBlank

非String字段(常见Integer、Double、Decimal等)用 @NotNull 或者 @NotEmpty ,主要看对长度是否要大于0的要求,建议使用 @NotNull

二、长度校验

序号注解解释适用场景
1@Size(max=, min=)被注释的字符串的大小必须在指定的范围内Integer不可用,用于字符串、Collection、Map、数组等
2@Length(min=,max=)被注释的字符串的大小必须在指定的范围内Integer不可用,用于字符串

小结:

对于字符串两个注解效果相同,一个汉字算一个长度,唯一的区别就是来源不通(where R U from ?)

三、数值校验

序号注解解释适用场景
1@Min(value)、@Max(value)被注释的元素必须是一个数字,其值必须大于等于/小于等于指定的最小值
2@DecimalMin(value) 、@DecimalMax(value)接受BigDecimal的字符串表示形式
(如果您处理的数字超过Long.MIN_VALUE或Long.MAX_VALUE以下,则这是唯一可能的选择。)
BigDecimal类型
3@Range(min=,max=,message=)注释的元素必须在合适的范围内BigDecimal,BigInteger,CharSequence, byte, short, int, long等原子类型和包装类型(这里无论什么类型,限定的都是字段值的区间,不是字段长度的区间)
4@Digits (integer, fraction)限制必须为一个小数,且整数部分的位数不能超过integer,小数部分的位数不能超过fractiondouble类型

小结:

@Min(value)、@Max(value) 满足大部分需求,特别的需求考虑其他的注解

四、正则校验

序号注解解释适用场景
1@Pattern(regex=,flag=)被注释的元素必须符合指定的正则表达式(手机号,身份证号)按需适配
2@Email被注释的元素必须是电子邮箱地址邮箱地址
3@CreditCardNumber被注释的字符串必须通过Luhn校验算法,银行卡,信用卡等号码一般都用Luhn计算合法性银行卡,信用卡
4@URL(protocol=,host=,port=,regexp=,flags=)被注释的字符串必须是一个有效的urlurl

小结:

  • @Pattern 理论可以校验任何规则的数据字段,但是对于已有的校验,尽量使用原生注解
  • 常用正则表达式
    • 身份证号码:String regex = "[1-9]\d{13,16}[a-zA-Z0-9]{1}";
    • 手机号码(支持国际格式,+86135xxxx…(中国内地),+00852137xxxx…(中国香港)):String regex = "(\+\d+)?1[34578]\d{9}$";
    • 固定电话号码:String regex = "(\+\d+)?(\d{3,4}\-?)?\d{7,8}$";
    • 整数(正整数和负整数):String regex = "\-?[1-9]\d+";
    • 中文: String regex = "^[u4E00-u9FA5]+$";
    • URL地址:String regex = "(https?://(w{3}\.)?)?\w+\.\w+(\.[a-zA-Z]+)*(:\d{1,5})?(/\w*)*(\??(.+=.*)?(&.+=.*)?)?";
    • 中国邮政编码:String regex = "[1-9]\d{5}";
    • IP地址:String regex = "[1-9](\d{1,2})?\.(0|([1-9](\d{1,2})?))\.(0|([1-9](\d{1,2})?))\.(0|([1-9](\d{1,2})?))";

五、自定义校验注解

import static java.lang.annotation.ElementType.CONSTRUCTOR;
import static java.lang.annotation.ElementType.FIELD;
import static java.lang.annotation.ElementType.METHOD;
import static java.lang.annotation.ElementType.PARAMETER;
import static java.lang.annotation.RetentionPolicy.RUNTIME;

import java.lang.annotation.Documented;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;

import javax.validation.Constraint;
import javax.validation.Payload;
import javax.validation.ReportAsSingleViolation;
import javax.validation.constraints.Null;
import javax.validation.constraints.Pattern;

import org.hibernate.validator.constraints.CompositionType;
import org.hibernate.validator.constraints.ConstraintComposition;
import org.hibernate.validator.constraints.Length;

/**
 * 验证手机号,空和正确的手机号都能验证通过
 * 正确的手机号由11位数字组成,第一位为1
 * 第二位为 3、4、5、7、8
 * 
 */
@ConstraintComposition(CompositionType.OR)
@Pattern(regexp = "1[3|4|5|7|8][0-9]\d{8}")
@Null
@Length(min = 0, max = 0)
@Documented
@Constraint(validatedBy = {})
@Target({ METHOD, FIELD, CONSTRUCTOR, PARAMETER })
@Retention(RUNTIME)
@ReportAsSingleViolation
public @interface Phone {
    String message() default "手机号校验错误";

    Class<?>[] groups() default {};

    Class<? extends Payload>[] payload() default {};
}

//添加手机号校验注解
@Phone
private String phone;

六、校验组

没空研究。


注:controller 请求需要加入@Valid注解 校验注解才生效

在这里插入图片描述

最后

以上就是健忘柚子为你收集整理的javax.validation校验整理前言的全部内容,希望文章能够帮你解决javax.validation校验整理前言所遇到的程序开发问题。

如果觉得靠谱客网站的内容还不错,欢迎将靠谱客网站推荐给程序员好友。

本图文内容来源于网友提供,作为学习参考使用,或来自网络收集整理,版权属于原作者所有。
点赞(61)

评论列表共有 0 条评论

立即
投稿
返回
顶部