package xyz.playedu.api.util; import org.springframework.util.AntPathMatcher; import java.util.*; /** * 字符串工具类 */ public class StringUtil extends org.apache.commons.lang3.StringUtils { /** * 空字符串 */ private static final String NULL_STR = ""; /** * 下划线 */ private static final char SEPARATOR = '_'; /** * 获取参数不为空值 * * @param value defaultValue 要判断的value * @return value 返回值 */ public static T nvl(T value, T defaultValue) { return value != null ? value : defaultValue; } /** * 判断一个Collection是否为空,包含List, Set, Queue * * @param coll 要判断的Collection * @return true=为空, false=非空 */ public static boolean isEmpty(Collection coll) { return isNull(coll) || coll.isEmpty(); } /** * 判断一个Collection是否非空,包含List, Set, Queue * * @param coll 要判断的Collection * @return true=非空, false=空 */ public static boolean isNotEmpty(Collection coll) { return !isEmpty(coll); } /** * 判断一个对象数组是否为空 * * @param objects 要判断的对象数组 * @return true=为空, false=非空 */ public static boolean isEmpty(Object[] objects) { return isNull(objects) || (objects.length == 0); } /** * 判断一个对象数组是否非空 * * @param objects 要判断的对象数组 * @return true=非空, false=空 */ public static boolean isNotEmpty(Object[] objects) { return !isEmpty(objects); } /** * 判断一个Map是否为空 * * @param map 要判断的Map * @return true=为空, false=非空 */ public static boolean isEmpty(Map map) { return isNull(map) || map.isEmpty(); } /** * 判断一个Map是否为空 * * @param map 要判断的Map * @return true=非空, false=空 */ public static boolean isNotEmpty(Map map) { return !isEmpty(map); } /** * 判断一个字符串是否为空串 * * @param str String * @return true=为空, false=非空 */ public static boolean isEmpty(String str) { return isNull(str) || NULL_STR.equals(str.trim()); } /** * 判断一个字符串是否为非空串 * * @param str String * @return true=非空串, false=空串 */ public static boolean isNotEmpty(String str) { return !isEmpty(str); } /** * 判断一个对象是否为空 * * @param object Object * @return true=为空, false=非空 */ public static boolean isNull(Object object) { return object == null; } /** * 判断一个对象是否非空 * * @param object Object * @return true=非空, false=空 */ public static boolean isNotNull(Object object) { return !isNull(object); } /** * 判断一个对象是否是数组类型(Java基本型别的数组) * * @param object 对象 * @return true=是数组, false=不是数组 */ public static boolean isArray(Object object) { return isNotNull(object) && object.getClass().isArray(); } /** * 去空格 */ public static String trim(String str) { return (str == null ? "" : str.trim()); } /** * 截取字符串 * * @param str 字符串 * @param start 开始 * @return 结果 */ public static String substring(final String str, int start) { if (str == null) { return NULL_STR; } if (start < 0) { start = str.length() + start; } if (start < 0) { start = 0; } if (start > str.length()) { return NULL_STR; } return str.substring(start); } /** * 截取字符串 * * @param str 字符串 * @param start 开始 * @param end 结束 * @return 结果 */ public static String substring(final String str, int start, int end) { if (str == null) { return NULL_STR; } if (end < 0) { end = str.length() + end; } if (start < 0) { start = str.length() + start; } if (end > str.length()) { end = str.length(); } if (start > end) { return NULL_STR; } if (start < 0) { start = 0; } if (end < 0) { end = 0; } return str.substring(start, end); } /** * 字符串转set * * @param str 字符串 * @param sep 分隔符 * @return set集合 */ public static Set str2Set(String str, String sep) { return new HashSet(str2List(str, sep, true, false)); } /** * 字符串转list * * @param str 字符串 * @param sep 分隔符 * @param filterBlank 过滤纯空白 * @param trim 去掉首尾空白 * @return list集合 */ public static List str2List(String str, String sep, boolean filterBlank, boolean trim) { List list = new ArrayList(); if (StringUtil.isEmpty(str)) { return list; } // 过滤空白字符串 if (filterBlank && StringUtil.isBlank(str)) { return list; } String[] split = str.split(sep); for (String string : split) { if (filterBlank && StringUtil.isBlank(string)) { continue; } if (trim) { string = string.trim(); } list.add(string); } return list; } /** * 查找指定字符串是否包含指定字符串列表中的任意一个字符串同时串忽略大小写 * * @param cs 指定字符串 * @param searchCharSequences 需要检查的字符串数组 * @return 是否包含任意一个字符串 */ public static boolean containsAnyIgnoreCase(CharSequence cs, CharSequence... searchCharSequences) { if (isEmpty(cs) || isEmpty(searchCharSequences)) { return false; } for (CharSequence testStr : searchCharSequences) { if (containsIgnoreCase(cs, testStr)) { return true; } } return false; } /** * 驼峰转下划线命名 */ public static String toUnderScoreCase(String str) { if (str == null) { return null; } StringBuilder sb = new StringBuilder(); // 前置字符是否大写 boolean preCharIsUpperCase = true; // 当前字符是否大写 boolean cureCharIsUpperCase = true; // 下一字符是否大写 boolean nextCharIsUpperCase = true; for (int i = 0; i < str.length(); i++) { char c = str.charAt(i); if (i > 0) { preCharIsUpperCase = Character.isUpperCase(str.charAt(i - 1)); } else { preCharIsUpperCase = false; } cureCharIsUpperCase = Character.isUpperCase(c); if (i < (str.length() - 1)) { nextCharIsUpperCase = Character.isUpperCase(str.charAt(i + 1)); } if (preCharIsUpperCase && cureCharIsUpperCase && !nextCharIsUpperCase) { sb.append(SEPARATOR); } else if ((i != 0 && !preCharIsUpperCase) && cureCharIsUpperCase) { sb.append(SEPARATOR); } sb.append(Character.toLowerCase(c)); } return sb.toString(); } /** * 是否包含字符串 * * @param str 验证字符串 * @param strArr 字符串组 * @return 包含返回true */ public static boolean inStringIgnoreCase(String str, String... strArr) { if (str != null && strArr != null) { for (String s : strArr) { if (str.equalsIgnoreCase(trim(s))) { return true; } } } return false; } /** * 将下划线大写方式命名的字符串转换为驼峰式。 * 如果转换前的下划线大写方式命名的字符串为空, * 则返回空字符串。 例如:HELLO_WORLD->HelloWorld * * @param name 转换前的下划线大写方式命名的字符串 * @return 转换后的驼峰式命名的字符串 */ public static String convertToCamelCase(String name) { StringBuilder result = new StringBuilder(); // 快速检查 if (name == null || name.isEmpty()) { // 没必要转换 return ""; } else if (!name.contains("_")) { // 不含下划线,仅将首字母大写 return name.substring(0, 1).toUpperCase() + name.substring(1); } // 用下划线将原始字符串分割 String[] camels = name.split("_"); for (String camel : camels) { // 跳过原始字符串中开头、结尾的下换线或双重下划线 if (camel.isEmpty()) { continue; } // 首字母大写 result.append(camel.substring(0, 1).toUpperCase()); result.append(camel.substring(1).toLowerCase()); } return result.toString(); } /** * 驼峰式命名法 例如:user_name->userName * * @param s 字符串 * @return 驼峰字符串 */ public static String toCamelCase(String s) { if (s == null) { return null; } s = s.toLowerCase(); StringBuilder sb = new StringBuilder(s.length()); boolean upperCase = false; for (int i = 0; i < s.length(); i++) { char c = s.charAt(i); if (c == SEPARATOR) { upperCase = true; } else if (upperCase) { sb.append(Character.toUpperCase(c)); upperCase = false; } else { sb.append(c); } } return sb.toString(); } /** * 查找指定字符串是否匹配指定字符串列表中的任意一个字符串 * * @param str 指定字符串 * @param strArr 需要检查的字符串数组 * @return 是否匹配 */ public static boolean matches(String str, List strArr) { if (isEmpty(str) || isEmpty(strArr)) { return false; } for (String pattern : strArr) { if (isMatch(pattern, str)) { return true; } } return false; } /** * 判断url是否与规则配置: * ? 表示单个字符; * * 表示一层路径内的任意字符串,不可跨层级; * ** 表示任意层路径; * * @param pattern 匹配规则 * @param url 需要匹配的url * @return boolean */ public static boolean isMatch(String pattern, String url) { AntPathMatcher matcher = new AntPathMatcher(); return matcher.match(pattern, url); } /** * 数字左边补齐0,使之达到指定长度。 * 注意,如果数字转换为字符串后,长度大于size,则只保留 最后size个字符。 * * @param num 数字对象 * @param size 字符串指定长度 * @return 返回数字的字符串格式,该字符串为指定长度。 */ public static String padL(final Number num, final int size) { return padL(num.toString(), size, '0'); } /** * 字符串左补齐 * 如果原始字符串s长度大于size,则只保留最后size个字符。 * * @param s 原始字符串 * @param size 字符串指定长度 * @param c 用于补齐的字符 * @return 返回指定长度的字符串,由原字符串左补齐或截取得到。 */ public static String padL(final String s, final int size, final char c) { final StringBuilder sb = new StringBuilder(size); if (s != null) { final int len = s.length(); if (s.length() <= size) { for (int i = size - len; i > 0; i--) { sb.append(c); } sb.append(s); } else { return s.substring(len - size, len); } } else { for (int i = size; i > 0; i--) { sb.append(c); } } return sb.toString(); } /** * 格式化文本, {} 表示占位符
* 此方法只是简单将占位符 {} 按照顺序替换为参数
* 如果想输出 {} 使用 \\转义 { 即可,如果想输出 {} 之前的 \ 使用双转义符 \\\\ 即可
* 例:
* 通常使用:format("this is {} for {}", "a", "b") -> this is a for b
* 转义{}: format("this is \\{} for {}", "a", "b") -> this is \{} for a
* 转义\: format("this is \\\\{} for {}", "a", "b") -> this is \a for b
* * @param strPattern 文本模板,被替换的部分用 {} 表示 * @param argArray 参数值 * @return 格式化后的文本 */ public static String format(String strPattern, Object... argArray) { String EMPTY_JSON = "{}"; char C_BACKSLASH = '\\'; char C_DELIM_START = '{'; if (isEmpty(argArray) || isEmpty(strPattern)) { return strPattern; } final int strPatternLength = strPattern.length(); StringBuilder sbuf = new StringBuilder(strPatternLength + 50); int handledPosition = 0; int delimIndex; for (int argIndex = 0; argIndex < argArray.length; argIndex++) { delimIndex = strPattern.indexOf(EMPTY_JSON, handledPosition); if (delimIndex == -1) { if (handledPosition == 0) { return strPattern; } else { sbuf.append(strPattern, handledPosition, strPatternLength); return sbuf.toString(); } } else { if (delimIndex > 0 && strPattern.charAt(delimIndex - 1) == C_BACKSLASH) { if (delimIndex > 1 && strPattern.charAt(delimIndex - 2) == C_BACKSLASH) { sbuf.append(strPattern, handledPosition, delimIndex - 1); sbuf.append(argArray[argIndex]); handledPosition = delimIndex + 2; } else { // 占位符被转义 argIndex--; sbuf.append(strPattern, handledPosition, delimIndex - 1); sbuf.append(C_DELIM_START); handledPosition = delimIndex + 1; } } else { // 正常占位符 sbuf.append(strPattern, handledPosition, delimIndex); sbuf.append(argArray[argIndex]); handledPosition = delimIndex + 2; } } } sbuf.append(strPattern, handledPosition, strPattern.length()); return sbuf.toString(); } }