spring boot-@Validated参数校验 @Pattern 利用正则自定义注解

傷城~ 2022-12-11 03:22 863阅读 0赞

### 文章目录 ###

*   *  一、validation--参数校验
     *   *  非空判断
     *  二、@Pattern 利用正则自定义注解
     *   *  工作常用正则收集总结（持续更新）
         *   *  执行字符串长度范围

## 一、validation–参数校验 ##

JSR-303 是 JAVA EE 6 中的一项子规范，叫做 Bean Validation，用于对 Java Bean 中的字段的值进行验证。Hibernate Validator则是Hibdernate提供的一种对该规范的实现。  
——即Hibernate Validator是用来做参数校验。

Hibernate Validator:是JSR-303参考实现。

Constranit desc  
@Null 被注解的元索必须为空  
@notNull 被注解的元素必须不为空  
@Min 被注解的元素必须是数字且必须小于等于指定值  
@Max 被注解的元素必须是数字且必须大于等于指定值  
@Past 被注解的元索必须是- -个过去的日期  
@Future 被注解的元素必须是一个将来的日期  
@Pattern **被注解的元素必须符合给定的正则表达式**  
@AssertTure 被注解的元素必须为ture  
@AssertFalse 被注解的元素必须为false

附加注解:  
Constranit desc  
@Email 被注解的元素必须是email地址  
@Length 被注解的元素必须在指定的范围内  
@NotEmpty 被注解的元素是必须  
@Range 被注解的元素可以是数字或者是数字的字符串必须在指定的范围内  
@URL 被注解的元素必须是一个URL

demo

@Max(value = 2,message = "登录类型只能是1或2")
        @Min(value = 1,message = "登录类型只能是1或2")
        @NotNull(message = "登录类型不能为空")
        private Integer type;

### 非空判断 ###

@NotNull：不能为null，但可以为empty

@NotEmpty：不能为null，而且长度必须大于0

@NotBlank：只能作用在String上，不能为null，而且调用trim()后，长度必须大于0  
案例：

## 二、@Pattern 利用正则自定义注解 ##

@Pattern 在 Spring Boot @Validated 中可能是比较常见的。  
在实体类的字段名上添加@Pattern注解，有个属性regexp，该属性的值就是正则表达式。

//数字和字母组合可为空字符串 ：
    @Pattern(regexp = "^\\s*|[0-9A-Za-z]*$", message = "编号为数字和字母组合")

^ 表示匹配字符串的开始位置 (例外 用在中括号中[ ] 时,可以理解为取反,表示不匹配括号中字符串)
    $ 表示匹配字符串的结束位置
    * 表示匹配 零次到多次
    + 表示匹配 一次到多次 (至少有一次)
    ? 表示匹配零次或一次
    . (圆点)表示匹配单个字符
    | 表示为或者,两项中取一项（可用于两个正则之间）
    ( ) 小括号表示匹配括号中全部字符
    [ ] 中括号表示匹配括号中一个字符 范围描述 如[0-9 a-z A-Z]
    { } 大括号用于限定匹配次数 如 {n}表示匹配n个字符 {n,}表示至少匹配n个字符 {n,m}表示至少n,最多m
    \ 转义字符 如上基本符号匹配都需要转义字符 如 \*表示匹配*号
    \w 表示英文字母和数字 \W 非字母和数字
    \d 表示数字 \D 非数字
    \s表示空字符串
    当使用-时，需要放在最后一个位置，否则会被当成数字和字母之间区间的标识

工作常用正则工具类整理如下：

package com.xx.xxx.xxxxx.utils;
 
 import org.apache.log4j.Logger;
 
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
 
 /** * @author xdja * @date 2020/11/20 16:08 */
 public final class RegexpUtils { 
 /** * 匹配email地址 * * * 格式: XXX@XXX.XXX.XX * * 匹配 : foo@bar.com 或 foobar@foobar.com.au * * 不匹配: foo@bar 或 $$$@bar.com */
 public static final String EMAIL_REGEXP = "^([a-zA-Z0-9]+[-|\\_|\\.]?)*[a-zA-Z0-9]+@([a-zA-Z0-9]+[-|\\_|\\.]?)*[a-zA-Z0-9]+\\.[a-zA-Z]{2,}$";
 /** * 匹配并提取url * * * 格式: XXXX://XXX.XXX.XXX.XX/XXX.XXX?XXX=XXX * * 匹配 : http://www.suncer.com 或news://www * * 不匹配: c:/window */
 public static final String URL_REGEXP = "(//w+)://([^/:]+)(://d*)?([^#//s]*)";
 /** * 匹配并提取http * * 格式: http://XXX.XXX.XXX.XX/XXX.XXX?XXX=XXX 或 ftp://XXX.XXX.XXX 或 https://XXX * * 匹配 : http://www.suncer.com:8080/index.html?login=true * * 不匹配: news://www */
 public static final String HTTP_REGEXP = "(http|https|ftp)://([^/:]+)(://d*)?([^#//s]*)";
 /** * 匹配并提取http * * 格式: http://XXX.XXX.XXX.XX/XXX.XXX?XXX=XXX 或 ftp://XXX.XXX.XXX 或 https://XXX * * 匹配 : http://www.suncer.com:8080/index.html?login=true * * 不匹配: news://www */
 public static final String HTTP_REGEXP_BANNER = "((https|http|ftp|rtsp|mms)?://)([0-9a-z_!~*'()-]+\\.)*([a-zA-Z0-9][-a-zA-Z0-9]{0,62})+(\\.[a-zA-Z]{1,4})(:[0-9]{1,4})?((/?)|(/[0-9a-zA-Z_!~*'().;?:@&=+$,%#-]+)+/?)\\.?$";
 /** * 匹配日期 * * * 格式(首位不为0): XXXX-XX-XX或 XXXX-X-X * * * 范围:1900--2099 * * * 匹配 : 2005-04-04 * * * 不匹配: 01-01-01 */
 public static final String DATE_BARS_REGEXP = "^((((19){1}|(20){1})\\d{2})|\\d{2})-[0,1]?\\d{1}-[0-3]?\\d{1}$";
 /** * wzw * * * 匹配格式 20160606 */
 public static final String DATE_BARS_DAY_REGEXP = "^((((19){1}|(20){1})\\d{2})|\\d{2})[0,1]?\\d{1}[0-3]?\\d{1}$";
 /** * 匹配格式 20130101 */
 public static final String DATE_BARS_REGEXP_SIMPLE =
 "([\\d]{4}(((0[13578]|1[02])((0[1-9])|([12][0-9])|(3[01])))|(((0[469])|11)((0[1-9])|([12][0-9])|30))|(02((0[1-9])|(1[0-9])|(2[0-8])))))|((((([02468][048])|([13579][26]))00)|([0-9]{2}(([02468][048])|([13579][26]))))(((0[13578]|1[02])((0[1-9])|([12][0-9])|(3[01])))|(((0[469])|11)((0[1-9])|([12][0-9])|30))|(02((0[1-9])|(1[0-9])|(2[0-9])))))";
 /** * 匹配格式 20130101 */
 public static final String DATE_BARS_REGEXP_HOUR_FULL =
 "^\\d{4}-(?:0\\d|1[0-2])-(?:[0-2]\\d|3[01])( (?:[01]\\d|2[0-3])\\:[0-5]\\d)?$";
 /** * 匹配日期 * * * 格式(首位不为0): XXXX-XX-XX或 XXXX-X-X * * * 范围:1900--2099 * * * 匹配 : 2005-04-04 11:00:00 * * * 不匹配: 01-01-01 */
 public static final String DATE_BARS_REGEXP_HOUR =
 "^((((19){1}|(20){1})\\d{2})|\\d{2})-[0,1]?\\d{1}-[0-3]?\\d{1}\\s[0,2]?\\d{1}[0,9]?\\d{1}$";
 
 /** * 匹配 : 2005-04-04 11:00:00 */
 public static final String DATE_BARS_REGEXP_HOUR_MIN_SS =
 "^\\d{4}\\D+\\d{1,2}\\D+\\d{1,2}\\D+\\d{1,2}\\D+\\d{1,2}\\D+\\d{1,2}\\D*$";
 /** * 匹配日期 * * * 格式: XXXX.XX.XX * * * 范围: * * * 匹配 : 2005.04.04 * * * 不匹配: 01.01.01 */
 public static final String DATE_SLASH_REGEXP = "^[0-9]{4}\\.[0-9]{2}\\.[0-9]{2}$";
 
 /** * 匹配电话 * * * 格式为: 0XXX-XXXXXX(10-13位首位必须为0) 或0XXX XXXXXXX(10-13位首位必须为0) 或 * * (0XXX)XXXXXXXX(11-14位首位必须为0) 或 XXXXXXXX(6-8位首位不为0) 或 XXXXXXXXXXX(11位首位不为0) * * * 匹配 : 0371-123456 或 (0371)1234567 或 (0371)12345678 或 010-123456 或 010-12345678 或 12345678912 * * * 不匹配: 1111-134355 或 0123456789 */
 public static final String PHONE_REGEXP =
 "^(?:0[0-9]{2,3}[-//s]{1}|//(0[0-9]{2,4}//))[0-9]{6,8}$|^[1-9]{1}[0-9]{5,7}$|^[1-9]{1}[0-9]{10}$";
 
 /** * 11位手机号格式验证 */
 public static final String MOBILE_PHONE_REGEXP = "^1[3,4,5,6,7,8,9]\\d{9}$";
 /** * 20位联系方式格式验证 */
 public static final String PHONE_20_REGEXP = "^[0-9\\-]{1,20}$";
 
 /** * 匹配身份证 * * 格式为: XXXXXXXXXX(10位) 或 XXXXXXXXXXXXX(13位) 或 XXXXXXXXXXXXXXX(15位) 或 XXXXXXXXXXXXXXXXXX(18位) * * 匹配 : 0123456789123 * * 不匹配: 0123456 */
 public static final String IDENTITY_CARD_REGEXP =
 "^[1-9]\\d{5}[1-9]\\d{3}((0\\d)|(1[0-2]))(([0|1|2]\\d)|3[0-1])\\d{3}([0-9]|X)$";
 /** * 匹配身份证 * * 格式为: XXXXXXXXXX(10位) 或 XXXXXXXXXXXXX(13位) 或 XXXXXXXXXXXXXXX(15位) 或 XXXXXXXXXXXXXXXXXX(18位) * * 匹配 : 0123456789123 * * 不匹配: 0123456 */
 public static final String ID_CARD_REGEXP = "^d{18} | $";
 
 /** * 匹配邮编代码 * * 格式为: XXXXXX(6位) * * 匹配 : 012345 * * 不匹配: 0123456 */
 public static final String ZIP_REGEXP = "^[0-9]{6}$";
 
 /** * 不包括特殊字符的匹配 (字符串中不包括符号 数学次方号^ 单引号' 双引号" 分号; 逗号, 帽号: 数学减号- 右尖括号> 左尖括号< 反斜杠/ 即空格,制表符,回车符等 ) * * 格式为: x 或 一个一上的字符 * * 匹配 : 012345 * * 不匹配: 0123456 // ;,:-<>//s].+$";// */
 public static final String NON_SPECIAL_CHAR_REGEXP = "^[^'/";
 
 /** * 匹配一位数的0-1整数 */
 public static final String ZERO__TO_ONE_NUMBER = "[0-1]$";
 
 /** * 匹配一位数的0-2整数 */
 public static final String ZERO__TO_TWO_NUMBER = "[0-2]$";
 
 /** * 匹配一位数的0-2整数 */
 public static final String ZERO__TO_THREE_NUMBER = "[0-3]$";
 /** * 匹配一位数的1-4的非负整数 */
 public static final String ONE__TO_FOUR_NATURAL_NUMBER = "[1-4]$";
 /** * 匹配一位数的0-4的非负整数 */
 public static final String ZERO__TO_FOUR_NATURAL_NUMBER = "[0-4]$";
 /** * 匹配一位数的1-3的非负整数 */
 public static final String ONE_TO_THREE_NATURAL_NUMBER = "[1-3]$";
 /** * 匹配一位数的1-3的非负整数 */
 public static final String ONE__TO_TWO_NATURAL_NUMBER = "[1-3]$";
 /** * 匹配一位数的1-6的非负整数 */
 public static final String ONE__TO_SIX_NATURAL_NUMBER = "[1-6]$";
 /** * 匹配0-18的正整数 */
 public static final String ONE_TO_EIGHTEEN_NUMBER = "^(18|[0-9]|(1[0-8]))$";
 
 /** * 匹配1-99的正整数 */
 public static final String ONE_TO_NINETYNINE_NUMBER = "^(99|[1-9]|([1-9][0-9]))$";
 
 /** * 匹配非负整数（正整数 + 0) */
 public static final String NON_NEGATIVE_INTEGERS_REGEXP = "^//d+$";
 /** * 匹配带1位小数且不超过2位的数 */
 public static final String CAR_LENGTH_REGEXP = "^(\\d|\\d\\d)(\\.\\d)?$";
 /** * 匹配整数位最大3位且小数位最大2位的数 */
 public static final String CAR_LOAD_REGEXP = "^(\\d{1,3})(\\.\\d{1,2})?$";
 /** * 匹配不包括零的非负整数（正整数 > 0) */
 public static final String NON_ZERO_NEGATIVE_INTEGERS_REGEXP = "^[1-9]+//d*$";
 /** * 匹配包括零的正整数 */
 public static final String ZERO_NEGATIVE_INTEGERS_REGEXP = "^[0-9]*[0-9][0-9]*$";
 /** * 匹配正整数 */
 public static final String POSITIVE_INTEGER_REGEXP = "^[0-9]*[1-9][0-9]*$";
 /** * 匹配非正整数（负整数 + 0） */
 public static final String NON_POSITIVE_INTEGERS_REGEXP = "^((-//d+)|(0+))$";
 /** * 匹配负整数 */
 public static final String NEGATIVE_INTEGERS_REGEXP = "^-[0-9]*[1-9][0-9]*$";
 /** * 匹配整数 */
 public static final String INTEGER_REGEXP = "^-?//d+$";
 /** * 匹配非负浮点数（正浮点数 + 0） */
 public static final String NON_NEGATIVE_RATIONAL_NUMBERS_REGEXP = "^\\d+(\\.\\d+)?$";
 /** * 匹配正浮点数 */
 public static final String POSITIVE_RATIONAL_NUMBERS_REGEXP = "^[0-9]+(.[0-9]{1})?$";
 /** * 匹配正浮点数(1-6位) */
 public static final String POSITIVE_ONE_TO_SIX_RATIONAL_NUMBERS_REGEXP = "^((?!0\\d)\\d+(\\.\\d{1,6}?))$";
 /** * 匹配非正浮点数（负浮点数 + 0） */
 public static final String NON_POSITIVE_RATIONAL_NUMBERS_REGEXP = "^((-//d+(//.//d+)?)|(0+(//.0+)?))$";
 /** * 匹配负浮点数 */
 public static final String NEGATIVE_RATIONAL_NUMBERS_REGEXP =
 "^(-(([0-9]+//.[0-9]*[1-9][0-9]*)|([0-9]*[1-9][0-9]*//.[0-9]+)|([0-9]*[1-9][0-9]*)))$";
 
 /** * 匹配浮点数 */
 public static final String RATIONAL_NUMBERS_REGEXP = "^(-?//d+)(//.//d+)?$";
 /** * 匹配由26个英文字母组成的字符串 */
 public static final String LETTER_REGEXP = "^[A-Za-z]+$";
 /** * 匹配由26个英文字母的大写组成的字符串 */
 public static final String UPWARD_LETTER_REGEXP = "^[A-Z]+$";
 /** * 匹配由A-D英文字母的大写的字符 */
 public static final String UPWARD_LETTER_A_D = "^[A-D]{1}";
 /** * 匹配由26个英文字母的大写的字符 */
 public static final String UPWARD_LETTER_STR = "^[A-Z]{1}$";
 /** * 匹配由26个英文字母的小写组成的字符串 */
 public static final String LOWER_LETTER_REGEXP = "^[a-z]+$";
 /** * 匹配由数字和26个英文字母组成的字符串 */
 public static final String LETTER_NUMBER_REGEXP = "^[A-Za-z0-9]+$";
 /** * 匹配由数字、26个英文字母或者下划线组成的字符串 */
 public static final String LETTER_NUMBER_UNDERLINE_REGEXP = "^//w+$";
 /** * 必须由数字和26个英文字母组合组成的字符串 */
 public static final String LETTER_NUMBER_REGEXP_MUST = "[0-9]+[a-zA-Z]+[0-9a-zA-Z]*|[a-zA-Z]+[0-9]+[0-9a-zA-Z]*";
 /** * 匹配5位数字 */
 public static final String FIVE_NUMBER_ONLY_REGEXP = "^[0-9]{5}$";
 /** * 匹配4位数字 */
 public static final String FOUR_NUMBER_ONLY_REGEXP = "^[0-9]{4}$";
 /** * 匹配1位字母 */
 public static final String ONE_LETTER = "^[a-zA-Z]{1}$";
 /** * 匹配19位数字 */
 public static final String NINETEEN_NUMBER_ONLY_REGEXP = "^[0-9]{19}$";
 /** * 匹配8位数字 */
 public static final String EIGHT_NUMBER_ONLY_REGEXP = "^[0-9]{8}$";
 /** * 匹配19位数字 */
 public static final String TWENTY_NUMBER_ONLY_REGEXP = "^[0-9]{20}$";
 /** * 匹配1位数字 */
 public static final String NUMBER_ONLY_ONE_REGEXP = "^\\d$";
 /** * 匹配日期 * * * 格式: yyyymmdd * * * 范围: * * * 匹配 : 20050404 * * * 不匹配: 010101 */
 public static final String DATE_YYYYMMMDD_REGEXP = "("
 + "(^\\d{3}[1-9]|\\d{2}[1-9]\\d{1}|\\d{1}[1-9]\\d{2}|[1-9]\\d{3}" + "(10|12|0?[13578])"
 + "((3[01]|[12][0-9]|0?[1-9])?)" + "([\\s]?)" + "((([0-1]?[0-9]|2[0-3]):([0-5]?[0-9]):([0-5]?[0-9]))?))$" + "|"
 + "(^\\d{3}[1-9]|\\d{2}[1-9]\\d{1}|\\d{1}[1-9]\\d{2}|[1-9]\\d{3}" + "(11|0?[469])" + "(30|[12][0-9]|0?[1-9])"
 + "([\\s]?)" + "((([0-1]?[0-9]|2[0-3]):([0-5]?[0-9]):([0-5]?[0-9]))?))$" + "|"
 + "(^\\d{3}[1-9]|\\d{2}[1-9]\\d{1}|\\d{1}[1-9]\\d{2}|[1-9]\\d{3}" + "(0?2)" + "(2[0-8]|1[0-9]|0?[1-9])"
 + "([\\s]?)" + "((([0-1]?[0-9]|2[0-3]):([0-5]?[0-9]):([0-5]?[0-9]))?))$" + "|"
 + "(^((\\d{2})(0[48]|[2468][048]|[13579][26]))|((0[48]|[2468][048]|[13579][26])00)" + "(0?2)" + "(29)"
 + "([\\s]?)" + "((([0-1]?\\d|2[0-3]):([0-5]?\\d):([0-5]?\\d))?))$" + ")";
 /** * 匹配日期 格式: yyyymm 匹配 : 200504 不匹配: 010101 */
 public static final String DATE_YYYYMM_REGEXP = "^(\\d{4})(0\\d{1}|1[0-2])$";
 /** * 匹配日期 格式: yyyy-MM-dd 10位 匹配 : 2005-04-01 不匹配: 010101 */
 public static final String DATE_YYYY_MM_DD_REGEXP = "^((?:19|20)\\d\\d)-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$";
 /** * 匹配日期 格式: yyyy/MM/dd 10位 匹配 : 2005/04/01 不匹配: 010101 */
 public static final String DATE_YYYYMMDD_REGEXP = "^((?:19|20)\\d\\d)/(0[1-9]|1[012])/(0[1-9]|[12][0-9]|3[01])$";
 /** * 匹配日期 格式: yyyyMMdd 8位 匹配 : 20050401 不匹配: 010101 */
 public static final String DATE_YYYYMMDD_EIGHT_REGEXP =
 "^((?:19|20)\\d\\d)(0[1-9]|1[012])(0[1-9]|[12][0-9]|3[01])$";
 /** * 匹配格式 2016-02-02 01:01 */
 public static final String DATE_BARS_REGEXP_HOUR_MIN =
 "^\\d{4}-(?:0\\d|1[0-2])-(?:[0-2]\\d|3[01]) (?:[01]\\d|2[0-3])\\:[0-5]\\d?$";
 /** * 匹配格式 2016-02-02 01:01:01 */
 public static final String DATE_BARS_REGEXP_HOUR_MIN_SECOND =
 "^\\d{4}[-]([0][1-9]|(1[0-2]))[-]([1-9]|([012]\\d)|(3[01]))([ \\t\\n\\x0B\\f\\r])(([0-1]{1}[0-9]{1})|([2]{1}[0-4]{1}))([:])(([0-5]{1}[0-9]{1}|[6]{1}[0]{1}))([:])((([0-5]{1}[0-9]{1}|[6]{1}[0]{1})))$";
 /** * 匹配整数或者空串 */
 public static final String NUMBER_BLANK_REGEXP = "^[1-9]\\d*|0|^\\s*$";
 /** * 匹配正整数或者空串 */
 public static final String POSITIVE_NUMBER_BLANK_REGEXP = "^[1-9]\\d*|^\\s*$";
 /** * 任意位数的非负整数 */
 public static final String NATURAL_NUMBER = "\\d*$";
 /** * 数字加逗号 */
 public static final String COMMA_NUMBER = "[\\d,]*$";
 /** * 匹配汉字 */
 public static final String CHINESE_VAR = "[\\u4e00-\\u9fa5]*$";
 /** * 不允许包含"/"或"\"正则 */
 public static final String BACK_SLANT_REGEXP = "^[^/^\\\\]+$";
 
 /** * 匹配日期 格式: yyyy-MM 7位 匹配 : 2005-04 不匹配: 0101 */
 public static final String DATE_YYYY_MM_REGEXP = "^((?:19|20)\\d\\d)-(0[1-9]|1[012])$";
 
 
 private RegexpUtils() { 
 }
 
 /** * 校验正则表达式结果 * * @param content * @param reg * @return */
 public static boolean validateInfo(String content, String reg) { 
 
 Pattern pat = Pattern.compile(reg);
 Matcher mat = pat.matcher(content);
 
 return mat.matches();
 }
 
 public static void main(String[] args) { 
 
 System.out.println(test("1"));
 System.out.println(test("12345678"));
 System.out.println(test("123456789"));
 System.out.println(test("1234567"));
 
 }
 
 public static boolean test(String date) { 
 
 Pattern pat = Pattern.compile(RegexpUtils.EIGHT_NUMBER_ONLY_REGEXP);
 Matcher mat = pat.matcher(date);
 boolean dateType = mat.matches();
 return dateType;
 }
 
 }

### 工作常用正则收集总结（持续更新） ###

#### 执行字符串长度范围 ####

TODO