StringUtil中常用的方法

本文介绍了org.apache.commons.lang3.StringUtils类中的一系列null安全字符串操作方法,如isEmpty(), isNotBlank(), isAnyBlank()等,帮助理解如何判断字符串是否为空、空白或包含空值,适用于Java开发中的空值检查和处理。

org.apache.commons.lang3.StringUtil类中方法的操作对象是 Java.lang.String 类型的对象,是 JDK 提供的 String 类型操作方法的补充,并且是 null 安全的(即如果输入参数 String 为 null 则不会抛出 NullPointerException ,而是做了相应处理,例如,如果输入为 null 则返回也是 null 等,具体可以查看源代码)。

除了构造器,StringUtils 中一共有130多个方法,并且都是 static 的,所以我们可以这样调用

StringUtils.xxx()

isEmpty系列

StringUtils.isEmpty()

是否为空. 可以看到 " " 空格是会绕过这种空判断,因为是一个空格,并不是严格的空值,会导致 isEmpty(" ")=false


StringUtils.isEmpty(null) = true
        StringUtils.isEmpty("") = true
        StringUtils.isEmpty(" ") = false
        StringUtils.isEmpty(“bob”) = false
        StringUtils.isEmpty(" bob ") = false
        /
        *
        * <p>NOTE: This method changed in Lang version 2.0.
        * It no longer trims the CharSequence.
        * That functionality is available in isBlank().</p>
        *
        * @param cs  the CharSequence to check, may be null
        * @return {@code true} if the CharSequence is empty or null
        * @since 3.0 Changed signature from isEmpty(String) to isEmpty(CharSequence)
        */
public static boolean isEmpty(final CharSequence cs) {
        return cs == null || cs.length() == 0;
}

StringUtils.isNotEmpty()

相当于不为空 , = !isEmpty()


public static boolean isNotEmpty(final CharSequence cs) {
        return !isEmpty(cs);
}

StringUtils.isAnyEmpty()

是否有一个为空,只有一个为空,就为true.

StringUtils.isAnyEmpty(null) = true
        StringUtils.isAnyEmpty(null, “foo”) = true
        StringUtils.isAnyEmpty("", “bar”) = true
        StringUtils.isAnyEmpty(“bob”, “”) = true
        StringUtils.isAnyEmpty(" bob ", null) = true
        StringUtils.isAnyEmpty(" ", “bar”) = false
        StringUtils.isAnyEmpty(“foo”, “bar”) = false
        /
        * @param css  the CharSequences to check, may be null or empty
        * @return {@code true} if any of the CharSequences are empty or null
        * @since 3.2
        */
public static boolean isAnyEmpty(final CharSequence... css) {
        if (ArrayUtils.isEmpty(css)) {
            return true;
        }
        for (final CharSequence cs : css){
            if (isEmpty(cs)) {
                return true;
            }
        }
        return false;
}

StringUtils.isNoneEmpty()

相当于 !isAnyEmpty(css) , 必须所有的值都不为空才返回true


        * <p>Checks if none of the CharSequences are empty ("") or null.</p>
        *
        * <pre>
         * StringUtils.isNoneEmpty(null)             = false
         * StringUtils.isNoneEmpty(null, "foo")      = false
         * StringUtils.isNoneEmpty("", "bar")        = false
         * StringUtils.isNoneEmpty("bob", "")        = false
         * StringUtils.isNoneEmpty("  bob  ", null)  = false
         * StringUtils.isNoneEmpty(" ", "bar")       = true
         * StringUtils.isNoneEmpty("foo", "bar")     = true
         * </pre>
        *
        * @param css  the CharSequences to check, may be null or empty
        * @return {@code true} if none of the CharSequences are empty or null
        * @since 3.2
        */
public static boolean isNoneEmpty(final CharSequence... css) {

isBank系列

StringUtils.isBlank()

是否为真空值(空格或者空值)

StringUtils.isBlank(null) = true
        StringUtils.isBlank("") = true
        StringUtils.isBlank(" ") = true
        StringUtils.isBlank(“bob”) = false
        StringUtils.isBlank(" bob ") = false
        /
        * <p>Checks if a CharSequence is whitespace, empty ("") or null.</p>
        * @param cs  the CharSequence to check, may be null
        * @return {@code true} if the CharSequence is null, empty or whitespace
        * @since 2.0
        * @since 3.0 Changed signature from isBlank(String) to isBlank(CharSequence)
        */
public static boolean isBlank(final CharSequence cs) {
        int strLen;
        if (cs == null || (strLen = cs.length()) == 0) {
            return true;
        }
        for (int i = 0; i < strLen; i++) {
            if (Character.isWhitespace(cs.charAt(i)) == false) {
                return false;
            }
        }
        return true;
 }

在这里插入图片描述

StringUtils.isNotBlank()

是否真的不为空,不是空格或者空值 ,相当于 !isBlank();

public static boolean isNotBlank(final CharSequence cs) {
        return !isBlank(cs);
}


StringUtils.isAnyBlank()

是否包含任何真空值(包含空格或空值)

        StringUtils.isAnyBlank(null) = true
        StringUtils.isAnyBlank(null, “foo”) = true
        StringUtils.isAnyBlank(null, null) = true
        StringUtils.isAnyBlank("", “bar”) = true
        StringUtils.isAnyBlank(“bob”, “”) = true
        StringUtils.isAnyBlank(" bob ", null) = true
        StringUtils.isAnyBlank(" ", “bar”) = true
        StringUtils.isAnyBlank(“foo”, “bar”) = false
        /
        * <p>Checks if any one of the CharSequences are blank ("") or null and not whitespace only..</p>
        * @param css  the CharSequences to check, may be null or empty
        * @return {@code true} if any of the CharSequences are blank or null or whitespace only
        * @since 3.2
        */
public static boolean isAnyBlank(final CharSequence... css) {
        if (ArrayUtils.isEmpty(css)) {
            return true;
        }
        for (final CharSequence cs : css){
            if (isBlank(cs)) {
                return true;
            }
        }
        return false;
}

StringUtils.isNoneBlank()

是否全部都不包含空值或空格

StringUtils.isNoneBlank(null) = false
        StringUtils.isNoneBlank(null, “foo”) = false
        StringUtils.isNoneBlank(null, null) = false
        StringUtils.isNoneBlank("", “bar”) = false
        StringUtils.isNoneBlank(“bob”, “”) = false
        StringUtils.isNoneBlank(" bob ", null) = false
        StringUtils.isNoneBlank(" ", “bar”) = false
        StringUtils.isNoneBlank(“foo”, “bar”) = true
        /
        * <p>Checks if none of the CharSequences are blank ("") or null and whitespace only..</p>
        * @param css  the CharSequences to check, may be null or empty
        * @return {@code true} if none of the CharSequences are blank or null or whitespace only
        * @since 3.2
        */
public static boolean isNoneBlank(final CharSequence... css) {
        return !isAnyBlank(css);
}

StringUtils的其他方法

可以参考官方的文档,里面有详细的描述,有些方法还是很好用的.

https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/StringUtils.html

在这里插入图片描述
在这里插入图片描述

### tk.mybatis 中 StringUtil 的用法与源码解析 #### 1. **StringUtil 类的作用** `tk.mybatis.mapper.util.StringUtil` 是 `tk.mybatis` 框架中的工具类,主要用于字符串处理操作。它提供了多种静态方法来判断字符串是否为空、去除空白字符等功能[^5]。 以下是该类的一些核心功能及其对应的实现: --- #### 2. **主要方法及其实现** ##### 方法一:`isEmpty(String str)` 用于判断给定的字符串是否为空或仅包含空白字符。 ```java public static boolean isEmpty(String str) { return str == null || str.trim().length() == 0; } ``` 上述代码逻辑表明,当传入的字符串为 `null` 或者去掉首尾空格后的长度为零时,返回 `true` 表示字符串为空[^6]。 --- ##### 方法二:`isNotEmpty(String str)` 这是 `isEmpty` 方法的反向操作,用来验证字符串是否有实际内容。 ```java public static boolean isNotEmpty(String str) { return !isEmpty(str); } ``` 通过调用 `isEmpty` 方法并取其相反值完成判断[^7]。 --- ##### 方法三:`trimToEmpty(String str)` 将输入字符串两端的空白字符移除,如果原字符串为 `null` 则返回空字符串 (`""`)。 ```java public static String trimToEmpty(String str) { return (str == null ? "" : str.trim()); } ``` 这种方法可以有效避免因参数为 `null` 而引发的异常情况[^8]。 --- ##### 方法四:`containsIgnoreCase(String str, String searchStr)` 忽略大小写的情况下检查某个子串是否存在目标字符串中。 ```java public static boolean containsIgnoreCase(String str, String searchStr) { if ((str == null) || (searchStr == null)) { return false; } int len = searchStr.length(); int max = str.length() - len; for(int i=0;i<=max;i++) { if(str.regionMatches(true,i,searchStr,0,len)){ return true; } } return false; } ``` 这段代码利用 Java 提供的 `regionMatches` 函数实现了高效的匹配过程[^9]。 --- #### 3. **典型应用场景** - 在 SQL 动态拼接过程中,常需校验某些字段是否具有合法值以决定是否加入到最终查询条件中。此时可借助 `StringUtil.isNotEmpty()` 来快速过滤掉无意义的数据项[^10]。 - 当配置文件读取可能出现路径错误或者默认值设置时,可以用 `StringUtil.trimToEmpty()` 处理潜在的多余空格问题[^11]。 --- #### 4. **注意事项** 尽管 `StringUtil` 已经封装了许多常用的功能,但在高并发场景下仍需要注意线程安全性。由于这些方法均为纯函数性质(即只依赖于输入参数),因此它们本身不会引入同步锁等问题[^12]。 此外,在升级至最新版本前应仔细阅读官方文档说明,因为随着项目迭代部分 API 可能会被废弃或替换[^13]。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值