com.thomas.alib.excel.utils.StringUtils Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of simple-excel Show documentation
简单excel导入导出工具，基于Apache.poi实现，通过注解方式实现poi常用api的调用
The newest version!
package com.thomas.alib.excel.utils;

/**
 * 字符串工具
 */
public class StringUtils {

    /**
     * 比较两个CharSequence是否相等，传入null不会导致异常，两个null认为相等
     *
     *      * StringUtils.equals(null, null)   = true
     * StringUtils.equals(null, "abc")  = false
     * StringUtils.equals("abc", null)  = false
     * StringUtils.equals("abc", "abc") = true
     * StringUtils.equals("abc", "ABC") = false
     * 
     *
     * @param cs1 第一个CharSequence, 可以为{@code null}
     * @param cs2 第二个CharSequence, 可以为{@code null}
     * @return 是否相等
     */
    public static boolean equals(final CharSequence cs1, final CharSequence cs2) {
        if (cs1 == cs2) {
            return true;
        }
        if (cs1 == null || cs2 == null) {
            return false;
        }
        if (cs1.length() != cs2.length()) {
            return false;
        }
        if (cs1 instanceof String && cs2 instanceof String) {
            return cs1.equals(cs2);
        }
        // Step-wise comparison
        final int length = cs1.length();
        for (int i = 0; i < length; i++) {
            if (cs1.charAt(i) != cs2.charAt(i)) {
                return false;
            }
        }
        return true;
    }

    /**
     * 检查CharSequence是否为空
     *
     *      * StringUtils.isEmpty(null)      = true
     * StringUtils.isEmpty("")        = true
     * StringUtils.isEmpty(" ")       = false
     * StringUtils.isEmpty("bob")     = false
     * StringUtils.isEmpty("  bob  ") = false
     * 
     *
     * @param cs 待校验CharSequence, 可以为{@code null}
     * @return 是否为空
     */
    public static boolean isEmpty(final CharSequence cs) {
        return cs == null || cs.length() == 0;
    }

    /**
     * 检查CharSequence是否不为空
     *
     *      * StringUtils.isNotEmpty(null)      = false
     * StringUtils.isNotEmpty("")        = false
     * StringUtils.isNotEmpty(" ")       = true
     * StringUtils.isNotEmpty("bob")     = true
     * StringUtils.isNotEmpty("  bob  ") = true
     * 
     *
     * @param cs 待校验CharSequence, 可以为{@code null}
     * @return 是否不为空
     */
    public static boolean isNotEmpty(final CharSequence cs) {
        return !isEmpty(cs);
    }


    /**
     * 检查CharSequence是否为空或者空白字符串
     *
     *      * StringUtils.isBlank(null)      = true
     * StringUtils.isBlank("")        = true
     * StringUtils.isBlank(" ")       = true
     * StringUtils.isBlank("bob")     = false
     * StringUtils.isBlank("  bob  ") = false
     * 
     *
     * @param cs 待校验CharSequence, 可以为{@code null}
     * @return 是否为空或者空白字符串
     */
    public static boolean isBlank(final CharSequence cs) {
        final int strLen = length(cs);
        if (strLen == 0) {
            return true;
        }
        for (int i = 0; i < strLen; i++) {
            if (!Character.isWhitespace(cs.charAt(i))) {
                return false;
            }
        }
        return true;
    }

    /**
     * 检查CharSequence是否不为空且不是空白字符串
     *
     *      * StringUtils.isNotBlank(null)      = false
     * StringUtils.isNotBlank("")        = false
     * StringUtils.isNotBlank(" ")       = false
     * StringUtils.isNotBlank("bob")     = true
     * StringUtils.isNotBlank("  bob  ") = true
     * 
     *
     * @param cs 待校验CharSequence, 可以为{@code null}
     * @return 是否不为空且不是空白字符串
     */
    public static boolean isNotBlank(final CharSequence cs) {
        return !isBlank(cs);
    }

    /**
     * 获取CharSequence的长度, 为null时返回0
     *
     * @param cs CharSequence对象, 可以为{@code null}
     * @return CharSequence长度, 为null时返回0
     */
    public static int length(final CharSequence cs) {
        return cs == null ? 0 : cs.length();
    }
}