java.lang.Object

org.miaixz.bus.core.text.CharsValidator

Direct Known Subclasses:: CharsBacker

public class CharsValidator extends Object

字符串检查工具类，提供字符串的blank和empty等检查

empty定义：null or 空字符串：""
blank定义：null or 空字符串："" or 空格、全角空格、制表符、换行符，等不可见字符

Since:: Java 17+
Author:: Kimi Liu

Constructor Summary

Constructors

Constructor

Description

CharsValidator()
Method Summary

Modifier and Type

Method

Description

static boolean

hasBlank(CharSequence... strs)

指定字符串数组中，是否包含空字符串。如果指定的字符串数组的长度为 0，或者其中的任意一个元素是空字符串，则返回 true。 hasBlank() // true hasBlank("", null, " ") // true hasBlank("123", " ") // true hasBlank("123", "abc") // false

static boolean

hasEmpty(CharSequence... args)

是否包含空字符串。如果指定的字符串数组的长度为 0，或者其中的任意一个元素是空字符串，则返回 true。 hasEmpty() // true hasEmpty("", null) // true hasEmpty("123", "") // true hasEmpty("123", "abc") // false hasEmpty(" ", "\t", "\n") // false

static boolean

hasEmpty(Iterable<? extends CharSequence> args)

是否包含空字符串。如果指定的字符串数组的长度为 0，或者其中的任意一个元素是空字符串，则返回 true。

static boolean

isAllBlank(CharSequence... strs)

指定字符串数组中的元素，是否全部为空字符串。如果指定的字符串数组的长度为 0，或者所有元素都是空字符串，则返回 true。 isAllBlank() // true isAllBlank("", null, " ") // true isAllBlank("123", " ") // false isAllBlank("123", "abc") // false

static boolean

isAllCharMatch(CharSequence value, Predicate<Character> matcher)

字符串的每一个字符是否都与定义的匹配器匹配

static boolean

isAllEmpty(CharSequence... args)

指定字符串数组中的元素，是否全部为空字符串。如果指定的字符串数组的长度为 0，或者所有元素都是空字符串，则返回 true。 isAllEmpty() // true isAllEmpty("", null) // true isAllEmpty("123", "") // false isAllEmpty("123", "abc") // false isAllEmpty(" ", "\t", "\n") // false

static boolean

isAllEmpty(Iterable<? extends CharSequence> args)

指定字符串数组中的元素，是否全部为空字符串。如果指定的字符串数组的长度为 0，或者所有元素都是空字符串，则返回 true。

static boolean

isAllNotBlank(CharSequence... args)

是否存都不为null或空对象或空白符的对象，通过hasBlank(CharSequence...) 判断元素

static boolean

isAllNotEmpty(CharSequence... args)

指定字符串数组中的元素，是否都不为空字符串。如果指定的字符串数组的长度不为 0，或者所有元素都不是空字符串，则返回 true。 isAllNotEmpty() // false isAllNotEmpty("", null) // false isAllNotEmpty("123", "") // false isAllNotEmpty("123", "abc") // true isAllNotEmpty(" ", "\t", "\n") // true

static boolean

isBlank(CharSequence text)

字符串是否为空白，空白的定义如下 null 空字符串："" 空格、全角空格、制表符、换行符，等不可见字符 isBlank(null) // true isBlank("") // true isBlank(" \t\n") // true isBlank("abc") // false

static boolean

isBlankOrUndefined(CharSequence text)

检查字符串是否为null、空白串、“null”、“undefined”

static boolean

isEmpty(CharSequence text)

字符串是否为空，空的定义如下 null 空字符串："" isEmpty(null) // true isEmpty("") // true isEmpty(" \t\n") // false isEmpty("abc") // false

static boolean

isEmptyOrUndefined(CharSequence text)

检查字符串是否为null、“”、“null”、“undefined”

static boolean

isNotBlank(CharSequence text)

字符串是否为非空白，非空白的定义如下：不为 null 不为空字符串："" 不为空格、全角空格、制表符、换行符，等不可见字符 isNotBlank(null) // false isNotBlank("") // false isNotBlank(" \t\n") // false isNotBlank("abc") // true

static boolean

isNotEmpty(CharSequence text)

字符串是否为非空白，非空白的定义如下不为 null 不为空字符串："" isNotEmpty(null) // false isNotEmpty("") // false isNotEmpty(" \t\n") // true isNotEmpty("abc") // true

static boolean

isNullOrUndefined(CharSequence text)

检查字符串是否为null、“null”、“undefined”

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details
- CharsValidator
  
  public CharsValidator()
Method Details
- isBlank
  
  public static boolean isBlank(CharSequence text)
  字符串是否为空白，空白的定义如下
  
  null
  
  空字符串：""
  
  空格、全角空格、制表符、换行符，等不可见字符
  
  isBlank(null) // true
  
  isBlank("") // true
  
  isBlank(" \t\n") // true
  
  isBlank("abc") // false
  
  注意：该方法与 isEmpty(CharSequence) 的区别是：该方法会校验空白字符，且性能相对于 isEmpty(CharSequence) 略慢。
  
  建议：
  
  该方法建议仅对于客户端（或第三方接口）传入的参数使用该方法。
  
  需要同时校验多个字符串时，建议采用 ArrayValidator.hasBlank(CharSequence...) 或 ArrayValidator.isAllBlank(CharSequence...)
  Parameters:
  
  text - 被检测的字符串
  
  Returns:
  
  若为空白，则返回 true
  
  See Also:
  
  isEmpty(CharSequence)
- isNotBlank
  
  public static boolean isNotBlank(CharSequence text)
  字符串是否为非空白，非空白的定义如下：
  
  不为 null
  
  不为空字符串：""
  
  不为空格、全角空格、制表符、换行符，等不可见字符
  
  isNotBlank(null) // false
  
  isNotBlank("") // false
  
  isNotBlank(" \t\n") // false
  
  isNotBlank("abc") // true
  
  注意：该方法与 isNotEmpty(CharSequence) 的区别是：该方法会校验空白字符，且性能相对于 isNotEmpty(CharSequence) 略慢。
  
  建议：仅对于客户端（或第三方接口）传入的参数使用该方法。
  Parameters:
  
  text - 被检测的字符串
  
  Returns:
  
  是否为非空
  
  See Also:
  
  isBlank(CharSequence)
- isEmpty
  
  public static boolean isEmpty(CharSequence text)
  字符串是否为空，空的定义如下
  
  null
  
  空字符串：""
  
  isEmpty(null) // true
  
  isEmpty("") // true
  
  isEmpty(" \t\n") // false
  
  isEmpty("abc") // false
  
  注意：该方法与 isBlank(CharSequence) 的区别是：该方法不校验空白字符。
  
  建议：
  
  该方法建议用于工具类或任何可以预期的方法参数的校验中。
  
  需要同时校验多个字符串时，建议采用 hasEmpty(CharSequence...) 或 isAllEmpty(CharSequence...)
  Parameters:
  
  text - 被检测的字符串
  
  Returns:
  
  是否为空
  
  See Also:
  
  isBlank(CharSequence)
- isNotEmpty
  
  public static boolean isNotEmpty(CharSequence text)
  字符串是否为非空白，非空白的定义如下
  
  不为 null
  
  不为空字符串：""
  
  isNotEmpty(null) // false
  
  isNotEmpty("") // false
  
  isNotEmpty(" \t\n") // true
  
  isNotEmpty("abc") // true
  
  注意：该方法与 isNotBlank(CharSequence) 的区别是：该方法不校验空白字符。
  
  建议：该方法建议用于工具类或任何可以预期的方法参数的校验中。
  Parameters:
  
  text - 被检测的字符串
  
  Returns:
  
  是否为非空
  
  See Also:
  
  isEmpty(CharSequence)
- hasBlank
  
  public static boolean hasBlank(CharSequence... strs)
  指定字符串数组中，是否包含空字符串。如果指定的字符串数组的长度为 0，或者其中的任意一个元素是空字符串，则返回 true。
  
  hasBlank() // true
  
  hasBlank("", null, " ") // true
  
  hasBlank("123", " ") // true
  
  hasBlank("123", "abc") // false
  
  注意：该方法与 isAllBlank(CharSequence...) 的区别在于：
  
  hasBlank(CharSequence...) 等价于 isBlank(...) || isBlank(...) || ...
  
  isAllBlank(CharSequence...) 等价于 isBlank(...) && isBlank(...) && ...
  Parameters:
  
  strs - 字符串列表
  
  Returns:
  
  是否包含空字符串
- isAllNotBlank
  
  public static boolean isAllNotBlank(CharSequence... args)
  
  是否存都不为null或空对象或空白符的对象，通过hasBlank(CharSequence...) 判断元素
  
  Parameters:
  
  args - 被检查的对象,一个或者多个
  
  Returns:
  
  是否都不为空
- isAllBlank
  
  public static boolean isAllBlank(CharSequence... strs)
  指定字符串数组中的元素，是否全部为空字符串。如果指定的字符串数组的长度为 0，或者所有元素都是空字符串，则返回 true。
  
  isAllBlank() // true
  
  isAllBlank("", null, " ") // true
  
  isAllBlank("123", " ") // false
  
  isAllBlank("123", "abc") // false
  
  注意：该方法与 hasBlank(CharSequence...) 的区别在于：
  
  hasBlank(CharSequence...) 等价于 isBlank(...) || isBlank(...) || ...
  
  isAllBlank(CharSequence...) 等价于 isBlank(...) && isBlank(...) && ...
  Parameters:
  
  strs - 字符串列表
  
  Returns:
  
  所有字符串是否为空白
- hasEmpty
  
  public static boolean hasEmpty(CharSequence... args)
  是否包含空字符串。如果指定的字符串数组的长度为 0，或者其中的任意一个元素是空字符串，则返回 true。
  
  hasEmpty() // true
  
  hasEmpty("", null) // true
  
  hasEmpty("123", "") // true
  
  hasEmpty("123", "abc") // false
  
  hasEmpty(" ", "\t", "\n") // false
  
  注意：该方法与 isAllEmpty(CharSequence...) 的区别在于：
  
  hasEmpty(CharSequence...) 等价于 isEmpty(...) || isEmpty(...) || ...
  
  isAllEmpty(CharSequence...) 等价于 isEmpty(...) && isEmpty(...) && ...
  Parameters:
  
  args - 字符串列表
  
  Returns:
  
  是否包含空字符串
- hasEmpty
  
  public static boolean hasEmpty(Iterable<? extends CharSequence> args)
  
  是否包含空字符串。如果指定的字符串数组的长度为 0，或者其中的任意一个元素是空字符串，则返回 true。
  
  Parameters:
  
  args - 字符串列表
  
  Returns:
  
  是否包含空字符串
- isAllEmpty
  
  public static boolean isAllEmpty(CharSequence... args)
  指定字符串数组中的元素，是否全部为空字符串。如果指定的字符串数组的长度为 0，或者所有元素都是空字符串，则返回 true。
  
  isAllEmpty() // true
  
  isAllEmpty("", null) // true
  
  isAllEmpty("123", "") // false
  
  isAllEmpty("123", "abc") // false
  
  isAllEmpty(" ", "\t", "\n") // false
  
  注意：该方法与 hasEmpty(CharSequence...) 的区别在于：
  
  hasEmpty(CharSequence...) 等价于 isEmpty(...) || isEmpty(...) || ...
  
  isAllEmpty(CharSequence...) 等价于 isEmpty(...) && isEmpty(...) && ...
  Parameters:
  
  args - 字符串列表
  
  Returns:
  
  所有字符串是否为空白
- isAllEmpty
  
  public static boolean isAllEmpty(Iterable<? extends CharSequence> args)
  
  指定字符串数组中的元素，是否全部为空字符串。如果指定的字符串数组的长度为 0，或者所有元素都是空字符串，则返回 true。
  
  Parameters:
  
  args - 字符串列表
  
  Returns:
  
  所有字符串是否为空白
- isAllNotEmpty
  
  public static boolean isAllNotEmpty(CharSequence... args)
  指定字符串数组中的元素，是否都不为空字符串。如果指定的字符串数组的长度不为 0，或者所有元素都不是空字符串，则返回 true。
  
  isAllNotEmpty() // false
  
  isAllNotEmpty("", null) // false
  
  isAllNotEmpty("123", "") // false
  
  isAllNotEmpty("123", "abc") // true
  
  isAllNotEmpty(" ", "\t", "\n") // true
  
  注意：该方法与 isAllEmpty(CharSequence...) 的区别在于：
  
  isAllEmpty(CharSequence...) 等价于 isEmpty(...) && isEmpty(...) && ...
  
  isAllNotEmpty(CharSequence...) 等价于 !isEmpty(...) && !isEmpty(...) && ...
  Parameters:
  
  args - 字符串数组
  
  Returns:
  
  所有字符串是否都不为为空白
- isNullOrUndefined
  
  public static boolean isNullOrUndefined(CharSequence text)
  
  检查字符串是否为null、“null”、“undefined”
  
  Parameters:
  
  text - 被检查的字符串
  
  Returns:
  
  是否为null、“null”、“undefined”
- isEmptyOrUndefined
  
  public static boolean isEmptyOrUndefined(CharSequence text)
  
  检查字符串是否为null、“”、“null”、“undefined”
  
  Parameters:
  
  text - 被检查的字符串
  
  Returns:
  
  是否为null、“”、“null”、“undefined”
- isBlankOrUndefined
  
  public static boolean isBlankOrUndefined(CharSequence text)
  
  检查字符串是否为null、空白串、“null”、“undefined”
  
  Parameters:
  
  text - 被检查的字符串
  
  Returns:
  
  是否为null、空白串、“null”、“undefined”
- isAllCharMatch
  
  public static boolean isAllCharMatch(CharSequence value, Predicate<Character> matcher)
  
  字符串的每一个字符是否都与定义的匹配器匹配
  
  Parameters:
  
  value - 字符串
  
  matcher - 匹配器
  
  Returns:
  
  是否全部匹配

Class CharsValidator

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Details

CharsValidator

Method Details

isBlank

isNotBlank

isEmpty

isNotEmpty

hasBlank

isAllNotBlank

isAllBlank

hasEmpty

hasEmpty

isAllEmpty

isAllEmpty

isAllNotEmpty

isNullOrUndefined

isEmptyOrUndefined

isBlankOrUndefined

isAllCharMatch