Package org.aoju.bus.core.lang

Class Validator

java.lang.Object
org.aoju.bus.core.lang.Validator
public class Validator extends Object
字段验证器
Since:
Java 17+
Author:
Kimi Liu

  • Constructor Details

    • Validator

      public Validator()

  • Method Details

    • isNull

      public static boolean isNull(Object value)
      给定值是否为null
      Parameters:
      value - 值
      Returns:
      是否为null

    • isNotNull

      public static boolean isNotNull(Object value)
      给定值是否不为null
      Parameters:
      value - 值
      Returns:
      是否不为null

    • validateNotNull

      public static <T> T validateNotNull(T value, String errorMsgTemplate, Object... params) throws ValidateException
      检查指定值是否为null
      Type Parameters:
      T - 被检查的对象类型
      Parameters:
      value - 值
      errorMsgTemplate - 错误消息内容模板(变量使用{}表示)
      params - 模板中变量替换后的值
      Returns:
      检查过后的值
      Throws:
      ValidateException - 检查不满足条件抛出的异常

    • isEmpty

      public static boolean isEmpty(Object value)
      验证是否为空 对于String类型判定是否为empty(null 或 "")
      Parameters:
      value - 值
      Returns:
      是否为空

    • isNotEmpty

      public static boolean isNotEmpty(Object value)
      验证是否为空 对于String类型判定是否为empty(null 或 "")
      Parameters:
      value - 值
      Returns:
      是否为空

    • validateNotEmpty

      public static void validateNotEmpty(Object value, String errorMsg) throws ValidateException
      验证是否为空,为空时抛出异常 对于String类型判定是否为empty(null 或 "")
      Parameters:
      value - 值
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isTrue

      public static boolean isTrue(boolean value)
      给定值是否为true
      Parameters:
      value - 值
      Returns:
      是否为true

    • isFalse

      public static boolean isFalse(boolean value)
      给定值是否不为false
      Parameters:
      value - 值
      Returns:
      是否不为false

    • validateTrue

      public static boolean validateTrue(boolean value, String errorMsgTemplate, Object... params) throws ValidateException
      检查指定值是否为true
      Parameters:
      value - 值
      errorMsgTemplate - 错误消息内容模板(变量使用{}表示)
      params - 模板中变量替换后的值
      Returns:
      检查过后的值
      Throws:
      ValidateException - 检查不满足条件抛出的异常

    • validateFalse

      public static boolean validateFalse(boolean value, String errorMsgTemplate, Object... params) throws ValidateException
      检查指定值是否为false
      Parameters:
      value - 值
      errorMsgTemplate - 错误消息内容模板(变量使用{}表示)
      params - 模板中变量替换后的值
      Returns:
      检查过后的值
      Throws:
      ValidateException - 检查不满足条件抛出的异常

    • equal

      public static boolean equal(Object t1, Object t2)
      验证是否相等 当两值都为null返回true
      Parameters:
      t1 - 对象1
      t2 - 对象2
      Returns:
      当两值都为null或相等返回true

    • validateEqual

      public static void validateEqual(Object t1, Object t2, String errorMsg) throws ValidateException
      验证是否相等,不相等抛出异常
      Parameters:
      t1 - 对象1
      t2 - 对象2
      errorMsg - 错误信息
      Throws:
      ValidateException - 验证异常

    • validateNotEqual

      public static void validateNotEqual(Object t1, Object t2, String errorMsg) throws ValidateException
      验证是否不等,相等抛出异常
      Parameters:
      t1 - 对象1
      t2 - 对象2
      errorMsg - 错误信息
      Throws:
      ValidateException - 验证异常

    • validateNotEmptyAndEqual

      public static void validateNotEmptyAndEqual(Object t1, Object t2, String errorMsg) throws ValidateException
      验证是否非空且与指定值相等 当数据为空时抛出验证异常 当两值不等时抛出异常
      Parameters:
      t1 - 对象1
      t2 - 对象2
      errorMsg - 错误信息
      Throws:
      ValidateException - 验证异常

    • validateNotEmptyAndNotEqual

      public static void validateNotEmptyAndNotEqual(Object t1, Object t2, String errorMsg) throws ValidateException
      验证是否非空且与指定值相等 当数据为空时抛出验证异常 当两值相等时抛出异常
      Parameters:
      t1 - 对象1
      t2 - 对象2
      errorMsg - 错误信息
      Throws:
      ValidateException - 验证异常

    • isMatchRegex

      public static boolean isMatchRegex(Pattern pattern, CharSequence value)
      通过正则表达式验证
      Parameters:
      pattern - 正则模式
      value - 值
      Returns:
      是否匹配正则

    • isMatchRegex

      public static boolean isMatchRegex(String regex, CharSequence value)
      通过正则表达式验证
      Parameters:
      regex - 正则
      value - 值
      Returns:
      是否匹配正则

    • validateMatchRegex

      public static void validateMatchRegex(String regex, String value, String errorMsg) throws ValidateException
      通过正则表达式验证 不符合正则
      Parameters:
      regex - 正则
      value - 值
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isGeneral

      public static boolean isGeneral(String value)
      验证是否为英文字母 、数字和下划线
      Parameters:
      value - 值
      Returns:
      是否为英文字母 、数字和下划线

    • validateGeneral

      public static void validateGeneral(String value, String errorMsg) throws ValidateException
      验证是否为英文字母 、数字和下划线
      Parameters:
      value - 值
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isGeneral

      public static boolean isGeneral(String value, int min, int max)
      验证是否为给定长度范围的英文字母 、数字和下划线
      Parameters:
      value - 值
      min - 最小长度,负数自动识别为0
      max - 最大长度,0或负数表示不限制最大长度
      Returns:
      是否为给定长度范围的英文字母 、数字和下划线

    • validateGeneral

      public static void validateGeneral(String value, int min, int max, String errorMsg) throws ValidateException
      验证是否为给定长度范围的英文字母 、数字和下划线
      Parameters:
      value - 值
      min - 最小长度,负数自动识别为0
      max - 最大长度,0或负数表示不限制最大长度
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isGeneral

      public static boolean isGeneral(String value, int min)
      验证是否为给定最小长度的英文字母 、数字和下划线
      Parameters:
      value - 值
      min - 最小长度,负数自动识别为0
      Returns:
      是否为给定最小长度的英文字母 、数字和下划线

    • validateGeneral

      public static void validateGeneral(String value, int min, String errorMsg) throws ValidateException
      验证是否为给定最小长度的英文字母 、数字和下划线
      Parameters:
      value - 值
      min - 最小长度,负数自动识别为0
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isLetter

      public static boolean isLetter(String value)
      判断字符串是否全部为字母组成,包括大写和小写字母和汉字
      Parameters:
      value - 值
      Returns:
      是否全部为字母组成, 包括大写和小写字母和汉字

    • validateLetter

      public static void validateLetter(String value, String errorMsg) throws ValidateException
      验证是否全部为字母组成,包括大写和小写字母和汉字
      Parameters:
      value - 表单值
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isUpperCase

      public static boolean isUpperCase(String value)
      判断字符串是否全部为大写字母
      Parameters:
      value - 值
      Returns:
      是否全部为大写字母

    • validateUpperCase

      public static void validateUpperCase(String value, String errorMsg) throws ValidateException
      验证字符串是否全部为大写字母
      Parameters:
      value - 表单值
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isLowerCase

      public static boolean isLowerCase(String value)
      判断字符串是否全部为小写字母
      Parameters:
      value - 值
      Returns:
      是否全部为小写字母

    • validateLowerCase

      public static void validateLowerCase(String value, String errorMsg) throws ValidateException
      验证字符串是否全部为小写字母
      Parameters:
      value - 表单值
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isNumber

      public static boolean isNumber(String value)
      验证该字符串是否是数字
      Parameters:
      value - 字符串内容
      Returns:
      是否是数字

    • hasNumber

      public static boolean hasNumber(CharSequence value)
      是否包含数字
      Parameters:
      value - 当前字符串
      Returns:
      boolean 是否存在数字

    • validateNumber

      public static void validateNumber(String value, String errorMsg) throws ValidateException
      验证是否为数字
      Parameters:
      value - 表单值
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isWord

      public static boolean isWord(String value)
      验证该字符串是否是字母(包括大写和小写字母)
      Parameters:
      value - 字符串内容
      Returns:
      是否是字母(包括大写和小写字母)

    • validateWord

      public static void validateWord(String value, String errorMsg) throws ValidateException
      验证是否为字母(包括大写和小写字母)
      Parameters:
      value - 表单值
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isMoney

      public static boolean isMoney(String value)
      验证是否为货币
      Parameters:
      value - 值
      Returns:
      是否为货币

    • validateMoney

      public static void validateMoney(String value, String errorMsg) throws ValidateException
      验证是否为货币
      Parameters:
      value - 值
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isZipCode

      public static boolean isZipCode(String value)
      验证是否为邮政编码(中国)
      Parameters:
      value - 值
      Returns:
      是否为邮政编码(中国)

    • validateZipCode

      public static void validateZipCode(String value, String errorMsg) throws ValidateException
      验证是否为邮政编码(中国)
      Parameters:
      value - 表单值
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isEmail

      public static boolean isEmail(String value)
      验证邮箱地址是否有效
      Parameters:
      value - 值
      Returns:
      邮箱是否有效

    • validateEmail

      public static void validateEmail(String value, String errorMsg) throws ValidateException
      验证邮箱地址是否有效
      Parameters:
      value - 值
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isPhone

      public static boolean isPhone(String value)
      验证是否为座机号码（中国）
      Parameters:
      value - 值
      Returns:
      是否为座机号码（中国）

    • isMobile

      public static boolean isMobile(String value)
      验证是否为手机号码(中国)
      Parameters:
      value - 值
      Returns:
      是否为手机号码(中国)

    • isMobileHk

      public static boolean isMobileHk(CharSequence value)
      验证是否为手机号码（香港）
      Parameters:
      value - 手机号码
      Returns:
      是否为香港手机号码

    • isMobileTw

      public static boolean isMobileTw(CharSequence value)
      验证是否为手机号码（台湾）
      Parameters:
      value - 手机号码
      Returns:
      是否为台湾手机号码

    • isMobileMo

      public static boolean isMobileMo(CharSequence value)
      验证是否为手机号码（澳门）
      Parameters:
      value - 手机号码
      Returns:
      是否为澳门手机号码

    • isTel400800

      public static boolean isTel400800(CharSequence value)
      验证是否为座机号码（中国）+ 400 + 800
      Parameters:
      value - 值
      Returns:
      是否为座机号码（中国）

    • validateMobile

      public static void validateMobile(String value, String errorMsg) throws ValidateException
      验证是否为手机号码(中国)
      Parameters:
      value - 值
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isCitizenId

      public static boolean isCitizenId(CharSequence value)
      验证是否为身份证号码（支持18位/15位和港澳台的10位）
      Parameters:
      value - 身份证号，支持18位/15位和港澳台的10位
      Returns:
      是否为有效身份证号码

    • validateCitizenIdNumber

      public static <T extends CharSequence> T validateCitizenIdNumber(T value, String errorMsg) throws ValidateException
      验证是否为身份证号码（支持18位/15位和港澳台的10位）
      Type Parameters:
      T - 字符串类型
      Parameters:
      value - 值
      errorMsg - 验证错误的信息
      Returns:
      验证后的值
      Throws:
      ValidateException - 验证异常

    • isBirthday

      public static boolean isBirthday(int year, int month, int day)
      验证是否为生日
      Parameters:
      year - 年
      month - 月
      day - 日
      Returns:
      是否为生日

    • isBirthday

      public static boolean isBirthday(String value)
      验证是否为生日 只支持以下几种格式：
      • yyyyMMdd
      • yyyy-MM-dd
      • yyyy/MM/dd
      • yyyyMMdd
      • yyyy年MM月dd日
      Parameters:
      value - 值
      Returns:
      是否为生日

    • validateBirthday

      public static void validateBirthday(String value, String errorMsg) throws ValidateException
      验证验证是否为生日
      Parameters:
      value - 值
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isIpv4

      public static boolean isIpv4(String value)
      验证是否为IPV4地址
      Parameters:
      value - 值
      Returns:
      是否为IPV4地址

    • validateIpv4

      public static void validateIpv4(String value, String errorMsg) throws ValidateException
      验证是否为IPV4地址
      Parameters:
      value - 值
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isIpv6

      public static boolean isIpv6(CharSequence value)
      验证是否为IPV6地址
      Parameters:
      value - 值
      Returns:
      是否为IPV6地址

    • validateIpv6

      public static <T extends CharSequence> T validateIpv6(T value, String errorMsg) throws ValidateException
      验证是否为IPV6地址
      Type Parameters:
      T - 字符串类型
      Parameters:
      value - 值
      errorMsg - 验证错误的信息
      Returns:
      验证后的值
      Throws:
      ValidateException - 验证异常

    • isMac

      public static boolean isMac(String value)
      验证是否为MAC地址
      Parameters:
      value - 值
      Returns:
      是否为MAC地址

    • validateMac

      public static void validateMac(String value, String errorMsg) throws ValidateException
      验证是否为MAC地址
      Parameters:
      value - 值
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isPlateNumber

      public static boolean isPlateNumber(String value)
      验证是否为中国车牌号
      Parameters:
      value - 值
      Returns:
      是否为中国车牌号

    • validatePlateNumber

      public static void validatePlateNumber(String value, String errorMsg) throws ValidateException
      验证是否为中国车牌号
      Parameters:
      value - 值
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isUrl

      public static boolean isUrl(String value)
      验证是否为URL
      Parameters:
      value - 值
      Returns:
      是否为URL

    • validateUrl

      public static void validateUrl(String value, String errorMsg) throws ValidateException
      验证是否为URL
      Parameters:
      value - 值
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isEnglish

      public static boolean isEnglish(String value)
      验证是否为英文
      Parameters:
      value - 值
      Returns:
      是否为汉字

    • validateEnglish

      public static void validateEnglish(String value, String errorMsg) throws ValidateException
      验证是否为汉字
      Parameters:
      value - 表单值
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isChinese

      public static boolean isChinese(CharSequence value)
      验证是否为英文
      Parameters:
      value - 值
      Returns:
      是否为汉字

    • validateChinese

      public static <T extends CharSequence> T validateChinese(T value, String errorMsg) throws ValidateException
      验证是否为汉字
      Type Parameters:
      T - 字符串类型
      Parameters:
      value - 表单值
      errorMsg - 验证错误的信息
      Returns:
      验证后的值
      Throws:
      ValidateException - 验证异常

    • isGeneralWithChinese

      public static boolean isGeneralWithChinese(String value)
      验证是否为中文字、英文字母、数字和下划线
      Parameters:
      value - 值
      Returns:
      是否为中文字、英文字母、数字和下划线

    • validateGeneralWithChinese

      public static void validateGeneralWithChinese(String value, String errorMsg) throws ValidateException
      验证是否为中文字、英文字母、数字和下划线
      Parameters:
      value - 值
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isUUID

      public static boolean isUUID(String value)
      验证是否为UUID 包括带横线标准格式和不带横线的简单模式
      Parameters:
      value - 值
      Returns:
      是否为UUID

    • validateUUID

      public static void validateUUID(String value, String errorMsg) throws ValidateException
      验证是否为UUID 包括带横线标准格式和不带横线的简单模式
      Parameters:
      value - 值
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isBetween

      public static boolean isBetween(Number value, Number min, Number max)
      检查给定的数字是否在指定范围内
      Parameters:
      value - 值
      min - 最小值(包含)
      max - 最大值(包含)
      Returns:
      是否满足

    • validateBetween

      public static void validateBetween(Number value, Number min, Number max, String errorMsg) throws ValidateException
      检查给定的数字是否在指定范围内
      Parameters:
      value - 值
      min - 最小值(包含)
      max - 最大值(包含)
      errorMsg - 验证错误的信息
      Throws:
      ValidateException - 验证异常

    • isHex

      public static boolean isHex(CharSequence value)
      验证是否为Hex(16进制)字符串
      Parameters:
      value - 值
      Returns:
      是否为Hex(16进制)字符串

    • validateHex

      public static <T extends CharSequence> T validateHex(T value, String errorMsg) throws ValidateException
      验证是否为Hex(16进制)字符串
      Type Parameters:
      T - 字符串类型
      Parameters:
      value - 值
      errorMsg - 验证错误的信息
      Returns:
      验证后的值
      Throws:
      ValidateException - 验证异常

    • isPassword

      public static boolean isPassword(String value, boolean... weak)
      验证是否符合密码要求
      Parameters:
      value - 值
      weak - 是否弱密码
      Returns:
      否符合密码要求

    • validatePassword

      public static void validatePassword(String value, String errorMsg, boolean... weak) throws ValidateException
      验证是是否符合密码要求
      Parameters:
      value - 值
      errorMsg - 验证错误的信息
      weak - 是否弱密码
      Throws:
      ValidateException - 验证异常