StrValidator (hutool 6.0.0-M20 API)

java.lang.Object
- org.dromara.hutool.core.text.StrValidator

Direct Known Subclasses:

CharSequenceUtil
```
public class StrValidator
extends Object
```
字符串检查工具类，提供字符串的blank和empty等检查
- empty定义：null or 空字符串：""
- blank定义：null or 空字符串："" or 空格、全角空格、制表符、换行符，等不可见字符

Field Summary

Fields
Modifier and Type Field and Description

static String EMPTY
字符串常量：空字符串 ""

static String NULL
字符串常量："null"
注意：{@code "null" !

Fields
Modifier and Type	Field and Description
`static String`	`EMPTY` 字符串常量：空字符串 `""`
`static String`	`NULL` 字符串常量：`"null"` 注意：{@code "null" !

Constructor Summary

Constructors
Constructor and Description

StrValidator()

Constructors
Constructor and Description
`StrValidator()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static boolean`	`hasBlank(CharSequence... strs)` 指定字符串数组中，是否包含空字符串。
`static boolean`	`hasEmpty(CharSequence... strs)` 是否包含空字符串。
`static boolean`	`hasEmpty(Iterable<? extends CharSequence> strs)` 是否包含空字符串。
`static boolean`	`isAllBlank(CharSequence... strs)` 指定字符串数组中的元素，是否全部为空字符串。
`static boolean`	`isAllCharMatch(CharSequence value, Predicate<Character> matcher)` 字符串的每一个字符是否都与定义的匹配器匹配
`static boolean`	`isAllEmpty(CharSequence... strs)` 指定字符串数组中的元素，是否全部为空字符串。
`static boolean`	`isAllEmpty(Iterable<? extends CharSequence> strs)` 指定字符串数组中的元素，是否全部为空字符串。
`static boolean`	`isAllNotBlank(CharSequence... args)` 是否存都不为`null`或空对象或空白符的对象，通过`hasBlank(CharSequence...)`
`static boolean`	`isAllNotEmpty(CharSequence... args)` 指定字符串数组中的元素，是否都不为空字符串。
`static boolean`	`isBlank(CharSequence str)` 字符串是否为空白，空白的定义如下： `null` 空字符串：`""` 空格、全角空格、制表符、换行符，等不可见字符例： `StrUtil.isBlank(null) // true` `StrUtil.isBlank("") // true` `StrUtil.isBlank(" \t\n") // true` `StrUtil.isBlank("abc") // false` 注意：该方法与 `isEmpty(CharSequence)` 的区别是：该方法会校验空白字符，且性能相对于 `isEmpty(CharSequence)` 略慢。
`static boolean`	`isBlankOrUndefined(CharSequence str)` 检查字符串是否为null、空白串、“null”、“undefined”
`static boolean`	`isEmpty(CharSequence str)` 字符串是否为空，空的定义如下： `null` 空字符串：`""` 例： `StrUtil.isEmpty(null) // true` `StrUtil.isEmpty("") // true` `StrUtil.isEmpty(" \t\n") // false` `StrUtil.isEmpty("abc") // false` 注意：该方法与 `isBlank(CharSequence)` 的区别是：该方法不校验空白字符。
`static boolean`	`isEmptyOrUndefined(CharSequence str)` 检查字符串是否为null、“”、“null”、“undefined”
`static boolean`	`isNotBlank(CharSequence str)` 字符串是否为非空白，非空白的定义如下：不为 `null` 不为空字符串：`""` 不为空格、全角空格、制表符、换行符，等不可见字符例： `StrUtil.isNotBlank(null) // false` `StrUtil.isNotBlank("") // false` `StrUtil.isNotBlank(" \t\n") // false` `StrUtil.isNotBlank("abc") // true` 注意：该方法与 `isNotEmpty(CharSequence)` 的区别是：该方法会校验空白字符，且性能相对于 `isNotEmpty(CharSequence)` 略慢。
`static boolean`	`isNotEmpty(CharSequence str)` 字符串是否为非空白，非空白的定义如下：不为 `null` 不为空字符串：`""` 例： `StrUtil.isNotEmpty(null) // false` `StrUtil.isNotEmpty("") // false` `StrUtil.isNotEmpty(" \t\n") // true` `StrUtil.isNotEmpty("abc") // true` 注意：该方法与 `isNotBlank(CharSequence)` 的区别是：该方法不校验空白字符。
`static boolean`	`isNullOrUndefined(CharSequence str)` 检查字符串是否为null、“null”、“undefined”

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

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

Class StrValidator

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

NULL

EMPTY

Constructor Detail

StrValidator

Method Detail

isBlank

isNotBlank

isEmpty

isNotEmpty

hasBlank

isAllNotBlank

isAllBlank

hasEmpty

hasEmpty

isAllEmpty

isAllEmpty

isAllNotEmpty

isNullOrUndefined

isEmptyOrUndefined

isBlankOrUndefined

isAllCharMatch