package com.jcdm.common.utils; import java.util.ArrayList; import java.util.Collection; import java.util.HashSet; import java.util.List; import java.util.Map; import java.util.Set; import org.springframework.util.AntPathMatcher; import com.jcdm.common.constant.Constants; import com.jcdm.common.core.text.StrFormatter; /** * å—符串工具类 * * @author jc */ public class StringUtils extends org.apache.commons.lang3.StringUtils { /** 空å—符串 */ private static final String NULLSTR = ""; /** 下划线 */ private static final char SEPARATOR = '_'; /** * 获å–å‚æ•°ä¸ä¸ºç©ºå€¼ * * @param value defaultValue è¦åˆ¤æ–çš„value * @return value 返回值 */ public static <T> 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) || NULLSTR.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 NULLSTR; } if (start < 0) { start = str.length() + start; } if (start < 0) { start = 0; } if (start > str.length()) { return NULLSTR; } 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 NULLSTR; } 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 NULLSTR; } if (start < 0) { start = 0; } if (end < 0) { end = 0; } return str.substring(start, end); } /** * 判æ–是å¦ä¸ºç©ºï¼Œå¹¶ä¸”ä¸æ˜¯ç©ºç™½å—符 * * @param str è¦åˆ¤æ–çš„value * @return 结果 */ public static boolean hasText(String str) { return (str != null && !str.isEmpty() && containsText(str)); } private static boolean containsText(CharSequence str) { int strLen = str.length(); for (int i = 0; i < strLen; i++) { if (!Character.isWhitespace(str.charAt(i))) { return true; } } return false; } /** * æ ¼å¼åŒ–文本, {} 表示å ä½ç¬¦<br> * æ¤æ–¹æ³•åªæ˜¯ç®€å•å°†å ä½ç¬¦ {} 按照顺åºæ›¿æ¢ä¸ºå‚æ•°<br> * 如果想输出 {} 使用 \\转义 { å³å¯ï¼Œå¦‚果想输出 {} 之å‰çš„ \ 使用åŒè½¬ä¹‰ç¬¦ \\\\ å³å¯<br> * 例:<br> * 通常使用:format("this is {} for {}", "a", "b") -> this is a for b<br> * 转义{}: format("this is \\{} for {}", "a", "b") -> this is \{} for a<br> * 转义\: format("this is \\\\{} for {}", "a", "b") -> this is \a for b<br> * * @param template 文本模æ¿ï¼Œè¢«æ›¿æ¢çš„部分用 {} 表示 * @param params å‚数值 * @return æ ¼å¼åŒ–åŽçš„文本 */ public static String format(String template, Object... params) { if (isEmpty(params) || isEmpty(template)) { return template; } return StrFormatter.format(template, params); } /** * 是å¦ä¸ºhttp(s)://开头 * * @param link 链接 * @return 结果 */ public static boolean ishttp(String link) { return StringUtils.startsWithAny(link, Constants.HTTP, Constants.HTTPS); } /** * å—符串转set * * @param str å—符串 * @param sep 分隔符 * @return seté›†åˆ */ public static final Set<String> str2Set(String str, String sep) { return new HashSet<String>(str2List(str, sep, true, false)); } /** * å—符串转list * * @param str å—符串 * @param sep 分隔符 * @param filterBlank 过滤纯空白 * @param trim 去掉首尾空白 * @return listé›†åˆ */ public static final List<String> str2List(String str, String sep, boolean filterBlank, boolean trim) { List<String> list = new ArrayList<String>(); if (StringUtils.isEmpty(str)) { return list; } // 过滤空白å—符串 if (filterBlank && StringUtils.isBlank(str)) { return list; } String[] split = str.split(sep); for (String string : split) { if (filterBlank && StringUtils.isBlank(string)) { continue; } if (trim) { string = string.trim(); } list.add(string); } return list; } /** * 判æ–给定的collection列表ä¸æ˜¯å¦åŒ…å«æ•°ç»„array 判æ–给定的数组arrayä¸æ˜¯å¦åŒ…å«ç»™å®šçš„å…ƒç´ value * * @param collection ç»™å®šçš„é›†åˆ * @param array 给定的数组 * @return boolean 结果 */ public static boolean containsAny(Collection<String> collection, String... array) { if (isEmpty(collection) || isEmpty(array)) { return false; } else { for (String str : array) { if (collection.contains(str)) { return true; } } return false; } } /** * 查找指定å—符串是å¦åŒ…å«æŒ‡å®šå—符串列表ä¸çš„ä»»æ„一个å—符串åŒæ—¶ä¸²å¿½ç•¥å¤§å°å†™ * * @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 curreCharIsUpperCase = true; // 下一å—符是å¦å¤§å†™ boolean nexteCharIsUpperCase = 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; } curreCharIsUpperCase = Character.isUpperCase(c); if (i < (str.length() - 1)) { nexteCharIsUpperCase = Character.isUpperCase(str.charAt(i + 1)); } if (preCharIsUpperCase && curreCharIsUpperCase && !nexteCharIsUpperCase) { sb.append(SEPARATOR); } else if ((i != 0 && !preCharIsUpperCase) && curreCharIsUpperCase) { sb.append(SEPARATOR); } sb.append(Character.toLowerCase(c)); } return sb.toString(); } /** * 是å¦åŒ…å«å—符串 * * @param str 验è¯å—符串 * @param strs å—符串组 * @return 包å«è¿”回true */ public static boolean inStringIgnoreCase(String str, String... strs) { if (str != null && strs != null) { for (String s : strs) { 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 */ public static String toCamelCase(String s) { if (s == null) { return null; } if (s.indexOf(SEPARATOR) == -1) { return s; } 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 strs 需è¦æ£€æŸ¥çš„å—符串数组 * @return 是å¦åŒ¹é… */ public static boolean matches(String str, List<String> strs) { if (isEmpty(str) || isEmpty(strs)) { return false; } for (String pattern : strs) { if (isMatch(pattern, str)) { return true; } } return false; } /** * 判æ–url是å¦ä¸Žè§„则é…ç½®: * ? 表示å•ä¸ªå—符; * * 表示一层路径内的任æ„å—符串,ä¸å¯è·¨å±‚级; * ** 表示任æ„层路径; * * @param pattern 匹é…规则 * @param url 需è¦åŒ¹é…çš„url * @return */ public static boolean isMatch(String pattern, String url) { AntPathMatcher matcher = new AntPathMatcher(); return matcher.match(pattern, url); } @SuppressWarnings("unchecked") public static <T> T cast(Object obj) { return (T) obj; } /** * æ•°å—左边补é½0,使之达到指定长度。注æ„,如果数å—转æ¢ä¸ºå—符串åŽï¼Œé•¿åº¦å¤§äºŽsize,则åªä¿ç•™ 最åŽsize个å—符。 * * @param num æ•°å—对象 * @param size å—符串指定长度 * @return 返回数å—çš„å—ç¬¦ä¸²æ ¼å¼ï¼Œè¯¥å—符串为指定长度。 */ public static final 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 final 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(); } }