cn.hutool.core.lang

类 Validator

java.lang.Object

cn.hutool.core.lang.Validator

public class Validator
extends java.lang.Object

字段验证器

作者:

Looly

字段概要

字段

限定符和类型	字段和说明
static java.util.regex.Pattern	BIRTHDAY 生日
static java.util.regex.Pattern	CITIZEN_ID 身份证号码
static java.util.regex.Pattern	EMAIL 邮件
static java.util.regex.Pattern	GENERAL 英文字母 、数字和下划线
static java.util.regex.Pattern	GENERAL_WITH_CHINESE 中文字、英文字母、数字和下划线
static java.util.regex.Pattern	GROUP_VAR 分组
static java.util.regex.Pattern	IPV4 IP v4
static java.util.regex.Pattern	MOBILE 移动电话
static java.util.regex.Pattern	MONEY 货币
static java.util.regex.Pattern	NUMBERS 数字
static java.util.regex.Pattern	PLATE_NUMBER 中国车牌号码
static java.util.regex.Pattern	URL URL
static java.util.regex.Pattern	URL_HTTP Http URL
static java.util.regex.Pattern	UUID UUID
static java.util.regex.Pattern	UUID_SIMPLE 不带横线的UUID
static java.util.regex.Pattern	ZIP_CODE 邮编

方法概要

方法

限定符和类型	方法和说明
static boolean	equal(java.lang.Object t1, java.lang.Object t2) 验证是否相等 当两值都为null返回true
static boolean	isBetween(java.lang.Number value, java.lang.Number min, java.lang.Number max) 检查给定的数字是否在指定范围内
static boolean	isBirthday(int year, int month, int day) 验证是否为生日
static boolean	isBirthday(java.lang.String value) 验证是否为生日 只支持以下几种格式： yyyyMMdd yyyy-MM-dd yyyy/MM/dd yyyyMMdd yyyy年MM月dd日
static boolean	isChinese(java.lang.String value) 验证是否为汉字
static boolean	isCitizenId(java.lang.String value) 验证是否为身份证号码（18位中国） 出生日期只支持到到2999年
static boolean	isEmail(java.lang.String value) 验证是否为可用邮箱地址
static boolean	isEmpty(java.lang.Object value) 验证是否为空 对于String类型判定是否为empty(null 或 "")
static boolean	isGeneral(java.lang.String value) 验证是否为英文字母 、数字和下划线
static boolean	isGeneral(java.lang.String value, int min) 验证是否为给定最小长度的英文字母 、数字和下划线
static boolean	isGeneral(java.lang.String value, int min, int max) 验证是否为给定长度范围的英文字母 、数字和下划线
static boolean	isGeneralWithChinese(java.lang.String value) 验证是否为中文字、英文字母、数字和下划线
static boolean	isIpv4(java.lang.String value) 验证是否为IPV4地址
static boolean	isLetter(java.lang.String value) 判断字符串是否全部为字母组成，包括大写和小写字母和汉字
static boolean	isLowerCase(java.lang.String value) 判断字符串是否全部为小写字母
static boolean	isMac(java.lang.String value) 验证是否为MAC地址
static boolean	isMactchRegex(java.util.regex.Pattern pattern, java.lang.String value) 通过正则表达式验证
static boolean	isMactchRegex(java.lang.String regex, java.lang.String value) 通过正则表达式验证
static boolean	isMobile(java.lang.String value) 验证是否为手机号码（中国）
static boolean	isMoney(java.lang.String value) 验证是否为货币
static boolean	isNotEmpty(java.lang.Object value) 验证是否为空 对于String类型判定是否为empty(null 或 "")
static boolean	isNotNull(java.lang.Object value) 给定值是否不为null
static boolean	isNull(java.lang.Object value) 给定值是否为null
static boolean	isNumber(java.lang.String value) 验证该字符串是否是数字
static boolean	isPlateNumber(java.lang.String value) 验证是否为中国车牌号
static boolean	isUpperCase(java.lang.String value) 判断字符串是否全部为大写字母
static boolean	isUrl(java.lang.String value) 验证是否为URL
static boolean	isUUID(java.lang.String value) 验证是否为UUID 包括带横线标准格式和不带横线的简单模式
static boolean	isWord(java.lang.String value) 验证该字符串是否是字母（包括大写和小写字母）
static boolean	isZipCode(java.lang.String value) 验证是否为邮政编码（中国）
static void	validateBetween(java.lang.Number value, java.lang.Number min, java.lang.Number max, java.lang.String errorMsg) 检查给定的数字是否在指定范围内
static void	validateBirthday(java.lang.String value, java.lang.String errorMsg) 验证验证是否为生日
static void	validateChinese(java.lang.String value, java.lang.String errorMsg) 验证是否为汉字
static void	validateCitizenIdNumber(java.lang.String value, java.lang.String errorMsg) 验证是否为身份证号码（18位中国） 出生日期只支持到到2999年
static void	validateEmail(java.lang.String value, java.lang.String errorMsg) 验证是否为可用邮箱地址
static void	validateEqual(java.lang.Object t1, java.lang.Object t2, java.lang.String errorMsg) 验证是否相等，不相等抛出异常
static void	validateGeneral(java.lang.String value, int min, int max, java.lang.String errorMsg) 验证是否为给定长度范围的英文字母 、数字和下划线
static void	validateGeneral(java.lang.String value, int min, java.lang.String errorMsg) 验证是否为给定最小长度的英文字母 、数字和下划线
static void	validateGeneral(java.lang.String value, java.lang.String errorMsg) 验证是否为英文字母 、数字和下划线
static void	validateGeneralWithChinese(java.lang.String value, java.lang.String errorMsg) 验证是否为中文字、英文字母、数字和下划线
static void	validateIpv4(java.lang.String value, java.lang.String errorMsg) 验证是否为IPV4地址
static void	validateLetter(java.lang.String value, java.lang.String errorMsg) 验证是否全部为字母组成，包括大写和小写字母和汉字
static void	validateLowerCase(java.lang.String value, java.lang.String errorMsg) 验证字符串是否全部为小写字母
static void	validateMac(java.lang.String value, java.lang.String errorMsg) 验证是否为MAC地址
static void	validateMatchRegex(java.lang.String regex, java.lang.String value, java.lang.String errorMsg) 通过正则表达式验证 不符合正则
static void	validateMobile(java.lang.String value, java.lang.String errorMsg) 验证是否为手机号码（中国）
static void	validateMoney(java.lang.String value, java.lang.String errorMsg) 验证是否为货币
static void	validateNotEmpty(java.lang.Object value, java.lang.String errorMsg) 验证是否为空，为空时抛出异常 对于String类型判定是否为empty(null 或 "")
static void	validateNotEmptyAndEqual(java.lang.Object t1, java.lang.Object t2, java.lang.String errorMsg) 验证是否非空且与指定值相等 当数据为空时抛出验证异常 当两值不等时抛出异常
static void	validateNotEmptyAndNotEqual(java.lang.Object t1, java.lang.Object t2, java.lang.String errorMsg) 验证是否非空且与指定值相等 当数据为空时抛出验证异常 当两值相等时抛出异常
static void	validateNotEqual(java.lang.Object t1, java.lang.Object t2, java.lang.String errorMsg) 验证是否不等，相等抛出异常
static <T> T	validateNotNull(T value, java.lang.String errorMsgTemplate, java.lang.Object... params) 检查指定值是否为null
static void	validateNumber(java.lang.String value, java.lang.String errorMsg) 验证是否为数字
static void	validatePlateNumber(java.lang.String value, java.lang.String errorMsg) 验证是否为中国车牌号
static void	validateUpperCase(java.lang.String value, java.lang.String errorMsg) 验证字符串是否全部为大写字母
static void	validateUrl(java.lang.String value, java.lang.String errorMsg) 验证是否为URL
static void	validateUUID(java.lang.String value, java.lang.String errorMsg) 验证是否为UUID 包括带横线标准格式和不带横线的简单模式
static void	validateWord(java.lang.String value, java.lang.String errorMsg) 验证是否为字母（包括大写和小写字母）
static void	validateZipCode(java.lang.String value, java.lang.String errorMsg) 验证是否为邮政编码（中国）

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

GENERAL

public static final java.util.regex.Pattern GENERAL

英文字母 、数字和下划线

NUMBERS

public static final java.util.regex.Pattern NUMBERS

数字

GROUP_VAR

public static final java.util.regex.Pattern GROUP_VAR

分组

IPV4

public static final java.util.regex.Pattern IPV4

IP v4

MONEY

public static final java.util.regex.Pattern MONEY

货币

EMAIL

public static final java.util.regex.Pattern EMAIL

邮件

MOBILE

public static final java.util.regex.Pattern MOBILE

移动电话

CITIZEN_ID

public static final java.util.regex.Pattern CITIZEN_ID

身份证号码

ZIP_CODE

public static final java.util.regex.Pattern ZIP_CODE

邮编

BIRTHDAY

public static final java.util.regex.Pattern BIRTHDAY

生日

URL

public static final java.util.regex.Pattern URL

URL

URL_HTTP

public static final java.util.regex.Pattern URL_HTTP

Http URL

GENERAL_WITH_CHINESE

public static final java.util.regex.Pattern GENERAL_WITH_CHINESE

中文字、英文字母、数字和下划线

UUID

public static final java.util.regex.Pattern UUID

UUID

UUID_SIMPLE

public static final java.util.regex.Pattern UUID_SIMPLE

不带横线的UUID

PLATE_NUMBER

public static final java.util.regex.Pattern PLATE_NUMBER

中国车牌号码

方法详细资料

isNull

public static boolean isNull(java.lang.Object value)

给定值是否为null

参数:

value - 值

返回:

是否为null

isNotNull

public static boolean isNotNull(java.lang.Object value)

给定值是否不为null

参数:

value - 值

返回:

是否不为null

validateNotNull

public static <T> T validateNotNull(T value,
                    java.lang.String errorMsgTemplate,
                    java.lang.Object... params)
                         throws ValidateException

检查指定值是否为null

类型参数:

T - 被检查的对象类型

参数:

value - 值

errorMsgTemplate - 错误消息内容模板（变量使用{}表示）

params - 模板中变量替换后的值

返回:

检查过后的值

抛出:

ValidateException - 检查不满足条件抛出的异常

isEmpty

public static boolean isEmpty(java.lang.Object value)

验证是否为空
对于String类型判定是否为empty(null 或 "")

参数:

value - 值

返回:

是否为空

isNotEmpty

public static boolean isNotEmpty(java.lang.Object value)

验证是否为空
对于String类型判定是否为empty(null 或 "")

参数:

value - 值

返回:

是否为空

validateNotEmpty

public static void validateNotEmpty(java.lang.Object value,
                    java.lang.String errorMsg)
                             throws ValidateException

验证是否为空，为空时抛出异常
对于String类型判定是否为empty(null 或 "")

参数:

value - 值

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

equal

public static boolean equal(java.lang.Object t1,
            java.lang.Object t2)

验证是否相等
当两值都为null返回true

参数:

t1 - 对象1

t2 - 对象2

返回:

当两值都为null或相等返回true

validateEqual

public static void validateEqual(java.lang.Object t1,
                 java.lang.Object t2,
                 java.lang.String errorMsg)
                          throws ValidateException

验证是否相等，不相等抛出异常

参数:

t1 - 对象1

t2 - 对象2

errorMsg - 错误信息

抛出:

ValidateException - 验证异常

validateNotEqual

public static void validateNotEqual(java.lang.Object t1,
                    java.lang.Object t2,
                    java.lang.String errorMsg)
                             throws ValidateException

验证是否不等，相等抛出异常

参数:

t1 - 对象1

t2 - 对象2

errorMsg - 错误信息

抛出:

ValidateException - 验证异常

validateNotEmptyAndEqual

public static void validateNotEmptyAndEqual(java.lang.Object t1,
                            java.lang.Object t2,
                            java.lang.String errorMsg)
                                     throws ValidateException

验证是否非空且与指定值相等
当数据为空时抛出验证异常
当两值不等时抛出异常

参数:

t1 - 对象1

t2 - 对象2

errorMsg - 错误信息

抛出:

ValidateException - 验证异常

validateNotEmptyAndNotEqual

public static void validateNotEmptyAndNotEqual(java.lang.Object t1,
                               java.lang.Object t2,
                               java.lang.String errorMsg)
                                        throws ValidateException

验证是否非空且与指定值相等
当数据为空时抛出验证异常
当两值相等时抛出异常

参数:

t1 - 对象1

t2 - 对象2

errorMsg - 错误信息

抛出:

ValidateException - 验证异常

isMactchRegex

public static boolean isMactchRegex(java.lang.String regex,
                    java.lang.String value)

通过正则表达式验证

参数:

regex - 正则

value - 值

返回:

是否匹配正则

validateMatchRegex

public static void validateMatchRegex(java.lang.String regex,
                      java.lang.String value,
                      java.lang.String errorMsg)
                               throws ValidateException

通过正则表达式验证
不符合正则

参数:

regex - 正则

value - 值

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

isMactchRegex

public static boolean isMactchRegex(java.util.regex.Pattern pattern,
                    java.lang.String value)

通过正则表达式验证

参数:

pattern - 正则模式

value - 值

返回:

是否匹配正则

isGeneral

public static boolean isGeneral(java.lang.String value)

验证是否为英文字母 、数字和下划线

参数:

value - 值

返回:

是否为英文字母 、数字和下划线

validateGeneral

public static void validateGeneral(java.lang.String value,
                   java.lang.String errorMsg)
                            throws ValidateException

验证是否为英文字母 、数字和下划线

参数:

value - 值

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

isGeneral

public static boolean isGeneral(java.lang.String value,
                int min,
                int max)

验证是否为给定长度范围的英文字母 、数字和下划线

参数:

value - 值

min - 最小长度，负数自动识别为0

max - 最大长度，0或负数表示不限制最大长度

返回:

是否为给定长度范围的英文字母 、数字和下划线

validateGeneral

public static void validateGeneral(java.lang.String value,
                   int min,
                   int max,
                   java.lang.String errorMsg)
                            throws ValidateException

验证是否为给定长度范围的英文字母 、数字和下划线

参数:

value - 值

min - 最小长度，负数自动识别为0

max - 最大长度，0或负数表示不限制最大长度

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

isGeneral

public static boolean isGeneral(java.lang.String value,
                int min)

验证是否为给定最小长度的英文字母 、数字和下划线

参数:

value - 值

min - 最小长度，负数自动识别为0

返回:

是否为给定最小长度的英文字母 、数字和下划线

validateGeneral

public static void validateGeneral(java.lang.String value,
                   int min,
                   java.lang.String errorMsg)
                            throws ValidateException

验证是否为给定最小长度的英文字母 、数字和下划线

参数:

value - 值

min - 最小长度，负数自动识别为0

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

isLetter

public static boolean isLetter(java.lang.String value)

判断字符串是否全部为字母组成，包括大写和小写字母和汉字

参数:

value - 值

返回:

是否全部为字母组成，包括大写和小写字母和汉字

从以下版本开始:

3.3.0

validateLetter

public static void validateLetter(java.lang.String value,
                  java.lang.String errorMsg)
                           throws ValidateException

验证是否全部为字母组成，包括大写和小写字母和汉字

参数:

value - 表单值

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

从以下版本开始:

3.3.0

isUpperCase

public static boolean isUpperCase(java.lang.String value)

判断字符串是否全部为大写字母

参数:

value - 值

返回:

是否全部为大写字母

从以下版本开始:

3.3.0

validateUpperCase

public static void validateUpperCase(java.lang.String value,
                     java.lang.String errorMsg)
                              throws ValidateException

验证字符串是否全部为大写字母

参数:

value - 表单值

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

从以下版本开始:

3.3.0

isLowerCase

public static boolean isLowerCase(java.lang.String value)

判断字符串是否全部为小写字母

参数:

value - 值

返回:

是否全部为小写字母

从以下版本开始:

3.3.0

validateLowerCase

public static void validateLowerCase(java.lang.String value,
                     java.lang.String errorMsg)
                              throws ValidateException

验证字符串是否全部为小写字母

参数:

value - 表单值

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

从以下版本开始:

3.3.0

isNumber

public static boolean isNumber(java.lang.String value)

验证该字符串是否是数字

参数:

value - 字符串内容

返回:

是否是数字

validateNumber

public static void validateNumber(java.lang.String value,
                  java.lang.String errorMsg)
                           throws ValidateException

验证是否为数字

参数:

value - 表单值

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

isWord

public static boolean isWord(java.lang.String value)

验证该字符串是否是字母（包括大写和小写字母）

参数:

value - 字符串内容

返回:

是否是字母（包括大写和小写字母）

从以下版本开始:

4.1.8

validateWord

public static void validateWord(java.lang.String value,
                java.lang.String errorMsg)
                         throws ValidateException

验证是否为字母（包括大写和小写字母）

参数:

value - 表单值

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

从以下版本开始:

4.1.8

isMoney

public static boolean isMoney(java.lang.String value)

验证是否为货币

参数:

value - 值

返回:

是否为货币

validateMoney

public static void validateMoney(java.lang.String value,
                 java.lang.String errorMsg)
                          throws ValidateException

验证是否为货币

参数:

value - 值

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

isZipCode

public static boolean isZipCode(java.lang.String value)

验证是否为邮政编码（中国）

参数:

value - 值

返回:

是否为邮政编码（中国）

validateZipCode

public static void validateZipCode(java.lang.String value,
                   java.lang.String errorMsg)
                            throws ValidateException

验证是否为邮政编码（中国）

参数:

value - 表单值

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

isEmail

public static boolean isEmail(java.lang.String value)

验证是否为可用邮箱地址

参数:

value - 值

返回:

否为可用邮箱地址

validateEmail

public static void validateEmail(java.lang.String value,
                 java.lang.String errorMsg)
                          throws ValidateException

验证是否为可用邮箱地址

参数:

value - 值

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

isMobile

public static boolean isMobile(java.lang.String value)

验证是否为手机号码（中国）

参数:

value - 值

返回:

是否为手机号码（中国）

validateMobile

public static void validateMobile(java.lang.String value,
                  java.lang.String errorMsg)
                           throws ValidateException

验证是否为手机号码（中国）

参数:

value - 值

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

isCitizenId

public static boolean isCitizenId(java.lang.String value)

验证是否为身份证号码（18位中国）
出生日期只支持到到2999年

参数:

value - 值

返回:

是否为身份证号码（18位中国）

validateCitizenIdNumber

public static void validateCitizenIdNumber(java.lang.String value,
                           java.lang.String errorMsg)
                                    throws ValidateException

验证是否为身份证号码（18位中国）
出生日期只支持到到2999年

参数:

value - 值

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

isBirthday

public static boolean isBirthday(int year,
                 int month,
                 int day)

验证是否为生日

参数:

year - 年

month - 月

day - 日

返回:

是否为生日

isBirthday

public static boolean isBirthday(java.lang.String value)

验证是否为生日
只支持以下几种格式：

• yyyyMMdd
• yyyy-MM-dd
• yyyy/MM/dd
• yyyyMMdd
• yyyy年MM月dd日

参数:

value - 值

返回:

是否为生日

validateBirthday

public static void validateBirthday(java.lang.String value,
                    java.lang.String errorMsg)
                             throws ValidateException

验证验证是否为生日

参数:

value - 值

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

isIpv4

public static boolean isIpv4(java.lang.String value)

验证是否为IPV4地址

参数:

value - 值

返回:

是否为IPV4地址

validateIpv4

public static void validateIpv4(java.lang.String value,
                java.lang.String errorMsg)
                         throws ValidateException

验证是否为IPV4地址

参数:

value - 值

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

isMac

public static boolean isMac(java.lang.String value)

验证是否为MAC地址

参数:

value - 值

返回:

是否为MAC地址

从以下版本开始:

4.1.3

validateMac

public static void validateMac(java.lang.String value,
               java.lang.String errorMsg)
                        throws ValidateException

验证是否为MAC地址

参数:

value - 值

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

从以下版本开始:

4.1.3

isPlateNumber

public static boolean isPlateNumber(java.lang.String value)

验证是否为中国车牌号

参数:

value - 值

返回:

是否为中国车牌号

从以下版本开始:

3.0.6

validatePlateNumber

public static void validatePlateNumber(java.lang.String value,
                       java.lang.String errorMsg)
                                throws ValidateException

验证是否为中国车牌号

参数:

value - 值

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

从以下版本开始:

3.0.6

isUrl

public static boolean isUrl(java.lang.String value)

验证是否为URL

参数:

value - 值

返回:

是否为URL

validateUrl

public static void validateUrl(java.lang.String value,
               java.lang.String errorMsg)
                        throws ValidateException

验证是否为URL

参数:

value - 值

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

isChinese

public static boolean isChinese(java.lang.String value)

验证是否为汉字

参数:

value - 值

返回:

是否为汉字

validateChinese

public static void validateChinese(java.lang.String value,
                   java.lang.String errorMsg)
                            throws ValidateException

验证是否为汉字

参数:

value - 表单值

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

isGeneralWithChinese

public static boolean isGeneralWithChinese(java.lang.String value)

验证是否为中文字、英文字母、数字和下划线

参数:

value - 值

返回:

是否为中文字、英文字母、数字和下划线

validateGeneralWithChinese

public static void validateGeneralWithChinese(java.lang.String value,
                              java.lang.String errorMsg)
                                       throws ValidateException

验证是否为中文字、英文字母、数字和下划线

参数:

value - 值

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

isUUID

public static boolean isUUID(java.lang.String value)

验证是否为UUID
包括带横线标准格式和不带横线的简单模式

参数:

value - 值

返回:

是否为UUID

validateUUID

public static void validateUUID(java.lang.String value,
                java.lang.String errorMsg)
                         throws ValidateException

验证是否为UUID
包括带横线标准格式和不带横线的简单模式

参数:

value - 值

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

isBetween

public static boolean isBetween(java.lang.Number value,
                java.lang.Number min,
                java.lang.Number max)

检查给定的数字是否在指定范围内

参数:

value - 值

min - 最小值（包含）

max - 最大值（包含）

返回:

是否满足

从以下版本开始:

4.1.10

validateBetween

public static void validateBetween(java.lang.Number value,
                   java.lang.Number min,
                   java.lang.Number max,
                   java.lang.String errorMsg)
                            throws ValidateException

检查给定的数字是否在指定范围内

参数:

value - 值

min - 最小值（包含）

max - 最大值（包含）

errorMsg - 验证错误的信息

抛出:

ValidateException - 验证异常

从以下版本开始:

4.1.10