manager/my-worker
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

StringUtils 更新一些标为弃用的方法

Browse Source
This commit is contained in:
thinkgem
2025-10-10 19:25:41 +08:00
parent 1199d947ff
commit d475e154a6
1 changed files with 226 additions and 194 deletions
Download Patch File Download Diff File Expand all files Collapse all files

420
common/src/main/java/com/jeesite/common/lang/StringUtils.java
View File

@@ -7,6 +7,8 @@ package com.jeesite.common.lang;
import com.jeesite.common.codec.EncodeUtils; import com.jeesite.common.codec.EncodeUtils;
import com.jeesite.common.collect.ListUtils; import com.jeesite.common.collect.ListUtils;
import org.apache.commons.lang3.Strings; import org.apache.commons.lang3.Strings;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import java.io.UnsupportedEncodingException; import java.io.UnsupportedEncodingException;
import java.nio.charset.StandardCharsets; import java.nio.charset.StandardCharsets;
@@ -18,10 +20,12 @@ import java.util.regex.Pattern;
/** /**
* 字符串工具类, 继承org.apache.commons.lang3.StringUtils类 * 字符串工具类, 继承org.apache.commons.lang3.StringUtils类
* @author ThinkGem * @author ThinkGem
* @version 2018-1-6 * @version 2025-10-10
*/ */
public class StringUtils extends org.apache.commons.lang3.StringUtils { public class StringUtils extends org.apache.commons.lang3.StringUtils {
private static final Logger logger = LoggerFactory.getLogger(StringUtils.class);
public static final String DOT = "."; public static final String DOT = ".";
public static final String COMMA = ","; public static final String COMMA = ",";
public static final String COLON = ":"; public static final String COLON = ":";
@@ -53,142 +57,170 @@ public class StringUtils extends org.apache.commons.lang3.StringUtils {
return join(iterable, COMMA); return join(iterable, COMMA);
} }
/** /**
* 转换为字节数组 * 转换为字节数组
* @param str 字符串 * @param str 字符串
*/ */
public static byte[] getBytes(String str){ public static byte[] getBytes(String str) {
if (str != null){ if (str != null) {
return str.getBytes(StandardCharsets.UTF_8); return str.getBytes(StandardCharsets.UTF_8);
}else{ } else {
return null; return null;
} }
} }
/** /**
* 转换为字节数组 * 转换为字节数组
* @param bytes 字节数组 * @param bytes 字节数组
*/ */
public static String toString(byte[] bytes){ public static String toString(byte[] bytes) {
return new String(bytes, StandardCharsets.UTF_8); return new String(bytes, StandardCharsets.UTF_8);
} }
/** /**
* 是否包含字符串 * 是否包含字符串
* @param str 验证字符串 * @param str 验证字符串
* @param strs 字符串组 * @param strs 字符串组
* @return 包含返回true * @return 包含返回true
*/ */
public static boolean inString(String str, String... strs){ public static boolean inString(String str, String... strs) {
if (str != null && strs != null){ if (str != null && strs != null) {
for (String s : strs){ for (String s : strs) {
if (str.equals(trim(s))){ if (str.equals(trim(s))) {
return true; return true;
} }
} }
} }
return false; return false;
} }
/** /**
* 是否包含字符串 * 是否包含字符串
* @param str 验证字符串 * @param str 验证字符串
* @param strs 字符串组 * @param strs 字符串组
* @return 包含返回true * @return 包含返回true
*/ */
public static boolean inStringIgnoreCase(String str, String... strs){ public static boolean inStringIgnoreCase(String str, String... strs) {
if (str != null && strs != null){ if (str != null && strs != null) {
for (String s : strs){ for (String s : strs) {
if (str.equalsIgnoreCase(trim(s))){ if (str.equalsIgnoreCase(trim(s))) {
return true; return true;
} }
} }
} }
return false; return false;
} }
/** /**
* 比较字符串，是否相等 * 比较字符串，是否相等
*/ */
public static boolean equals(final CharSequence cs1, final CharSequence cs2) { public static boolean equals(final CharSequence cs1, final CharSequence cs2) {
return Strings.CS.equals(cs1, cs2); return Strings.CS.equals(cs1, cs2);
} }
/**
* 比较字符串，是否相等，只要有一个匹配就成立
*/
public static boolean equalsAny(final CharSequence string, final CharSequence... searchStrings) {
return Strings.CS.equalsAny(string, searchStrings);
}
/** /**
* 比较字符串，是否相等（忽略大小写） * 比较字符串，是否相等（忽略大小写）
*/ */
public static boolean equalsIgnoreCase(final CharSequence cs1, final CharSequence cs2) { public static boolean equalsIgnoreCase(final CharSequence cs1, final CharSequence cs2) {
return Strings.CI.equals(cs1, cs2); return Strings.CI.equals(cs1, cs2);
} }
/** /**
* 比较字符串，是否在字符串中包含 * 比较字符串，是否在字符串中包含
*/ */
public static boolean contains(final CharSequence seq, final CharSequence searchSeq) { public static boolean contains(final CharSequence seq, final CharSequence searchSeq) {
return Strings.CS.contains(seq, searchSeq); return Strings.CS.contains(seq, searchSeq);
} }
/**
* 比较字符串，是否在字符串中包含，只要有一个匹配就成立
*/
public static boolean containsAny(final CharSequence cs, final CharSequence... searchCharSequences) {
return Strings.CS.containsAny(cs, searchCharSequences);
}
/**
* 比较字符串，是否在字符串中包含（忽略大小写）
*/
public static boolean containsIgnoreCase(final CharSequence str, final CharSequence searchStr) {
return Strings.CI.contains(str, searchStr);
}
/** /**
* 比较字符串，前缀是否匹配 * 比较字符串，前缀是否匹配
*/ */
public static boolean startsWith(final CharSequence str, final CharSequence prefix) { public static boolean startsWith(final CharSequence str, final CharSequence prefix) {
return Strings.CS.startsWith(str, prefix); return Strings.CS.startsWith(str, prefix);
} }
/** /**
* 比较字符串，前缀是否匹配，只要有一个匹配就成立 * 比较字符串，前缀是否匹配，只要有一个匹配就成立
*/ */
public static boolean startsWithAny(final CharSequence sequence, final CharSequence... searchStrings) { public static boolean startsWithAny(final CharSequence sequence, final CharSequence... searchStrings) {
return Strings.CS.startsWithAny(sequence, searchStrings); return Strings.CS.startsWithAny(sequence, searchStrings);
} }
/** /**
* 比较字符串，前缀是否匹配（忽略大小写） * 比较字符串，前缀是否匹配（忽略大小写）
*/ */
public static boolean startsWithIgnoreCase(final CharSequence str, final CharSequence prefix) { public static boolean startsWithIgnoreCase(final CharSequence str, final CharSequence prefix) {
return Strings.CI.startsWith(str, prefix); return Strings.CI.startsWith(str, prefix);
} }
/** /**
* 比较字符串，后缀是否匹配 * 比较字符串，后缀是否匹配
*/ */
public static boolean endsWith(final CharSequence str, final CharSequence suffix) { public static boolean endsWith(final CharSequence str, final CharSequence suffix) {
return Strings.CS.endsWith(str, suffix); return Strings.CS.endsWith(str, suffix);
} }
/** /**
* 比较字符串，后缀是否匹配，只要有一个匹配就成立 * 比较字符串，后缀是否匹配，只要有一个匹配就成立
*/ */
public static boolean endsWithAny(final CharSequence sequence, final CharSequence... searchStrings) { public static boolean endsWithAny(final CharSequence sequence, final CharSequence... searchStrings) {
return Strings.CS.endsWithAny(sequence, searchStrings); return Strings.CS.endsWithAny(sequence, searchStrings);
} }
/** /**
* 比较字符串，后缀是否匹配（忽略大小写） * 比较字符串，后缀是否匹配（忽略大小写）
*/ */
public static boolean endsWithIgnoreCase(final CharSequence str, final CharSequence suffix) { public static boolean endsWithIgnoreCase(final CharSequence str, final CharSequence suffix) {
return Strings.CI.endsWith(str, suffix); return Strings.CI.endsWith(str, suffix);
} }
/** /**
* 替换字符串 * 替换字符串
*/ */
public static String replace(final String text, final String searchString, final String replacement) { public static String replace(final String text, final String searchString, final String replacement) {
return Strings.CS.replace(text, searchString, replacement); return Strings.CS.replace(text, searchString, replacement);
} }
/** /**
* 去除左右空格（包含中文空格） * 替换字符串（忽略大小写）
*/ */
public static String trim2(final String str) { public static String replaceIgnoreCase(final String text, final String searchString, final String replacement) {
return str == null ? null : str.replaceAll("^[\\s|　| ]*|[\\s|　| ]*$", ""); return Strings.CI.replace(text, searchString, replacement);
} }
/**
* 去除左右空格（包含中文空格）
*/
public static String trim2(final String str) {
return str == null ? null : str.replaceAll("^[\\s|　| ]*|[\\s|　| ]*$", "");
}
/** /**
* 替换掉HTML标签方法 * 替换掉HTML标签方法
*/ */
public static String stripHtml(String html) { public static String stripHtml(String html) {
if (isBlank(html)){ if (isBlank(html)) {
return EMPTY; return EMPTY;
} }
//html.replaceAll("\\&[a-zA-Z]{0,9};", "").replaceAll("<[^>]*>", ""); //html.replaceAll("\\&[a-zA-Z]{0,9};", "").replaceAll("<[^>]*>", "");
@@ -197,22 +229,22 @@ public class StringUtils extends org.apache.commons.lang3.StringUtils {
Matcher m = p.matcher(html); Matcher m = p.matcher(html);
return m.replaceAll(EMPTY); return m.replaceAll(EMPTY);
} }
/** /**
* 替换为手机识别的HTML，去掉样式及属性，保留回车。 * 替换为手机识别的HTML，去掉样式及属性，保留回车。
*/ */
public static String toMobileHtml(String html){ public static String toMobileHtml(String html) {
if (isBlank(html)){ if (isBlank(html)) {
return EMPTY; return EMPTY;
} }
return html.replaceAll("<([a-z]+?)\\s+?.*?>", "<$1>"); return html.replaceAll("<([a-z]+?)\\s+?.*?>", "<$1>");
} }
/** /**
* 对txt进行HTML编码，并将\n转换为&gt;br/&lt;、\t转换为&nbsp; &nbsp; * 对txt进行HTML编码，并将\n转换为&gt;br/&lt;、\t转换为&nbsp; &nbsp;
*/ */
public static String toHtml(String txt){ public static String toHtml(String txt) {
if (isBlank(txt)){ if (isBlank(txt)) {
return EMPTY; return EMPTY;
} }
return replace(replace(EncodeUtils.encodeHtml(trim(txt)), "\n", "<br/>"), "\t", "&nbsp; &nbsp; "); return replace(replace(EncodeUtils.encodeHtml(trim(txt)), "\n", "<br/>"), "\t", "&nbsp; &nbsp; ");
@@ -220,11 +252,11 @@ public class StringUtils extends org.apache.commons.lang3.StringUtils {
/** /**
* 缩略字符串（不区分中英文字符） * 缩略字符串（不区分中英文字符）
* @param str 目标字符串 * @param str 目标字符串
* @param length 截取长度 * @param length 截取长度
*/ */
public static String abbr(String str, int length) { public static String abbr(String str, int length) {
if (isBlank(str)){ if (isBlank(str)) {
return EMPTY; return EMPTY;
} }
try { try {
@@ -241,21 +273,21 @@ public class StringUtils extends org.apache.commons.lang3.StringUtils {
} }
return sb.toString(); return sb.toString();
} catch (UnsupportedEncodingException e) { } catch (UnsupportedEncodingException e) {
e.printStackTrace(); logger.error(e.getMessage(), e);
} }
return EMPTY; return EMPTY;
} }
// 缩略字符串替换Html正则表达式预编译 // 缩略字符串替换Html正则表达式预编译
private static Pattern p1 = Pattern.compile("<([a-zA-Z]+)[^<>]*>"); private static final Pattern p1 = Pattern.compile("<([a-zA-Z]+)[^<>]*>");
/** /**
* 缩略字符串（适应于与HTML标签的） * 缩略字符串（适应于与HTML标签的）
* @param param 目标字符串 * @param param 目标字符串
* @param length 截取长度 * @param length 截取长度
*/ */
public static String htmlAbbr(String param, int length) { public static String htmlAbbr(String param, int length) {
if (isBlank(param)){ if (isBlank(param)) {
return EMPTY; return EMPTY;
} }
StringBuilder result = new StringBuilder(); StringBuilder result = new StringBuilder();
@@ -280,7 +312,7 @@ public class StringUtils extends org.apache.commons.lang3.StringUtils {
n += String.valueOf(temp).getBytes("GBK").length; n += String.valueOf(temp).getBytes("GBK").length;
} }
} catch (UnsupportedEncodingException e) { } catch (UnsupportedEncodingException e) {
e.printStackTrace(); logger.error(e.getMessage(), e);
} }
if (n <= length - 3) { if (n <= length - 3) {
result.append(temp); result.append(temp);
@@ -312,111 +344,110 @@ public class StringUtils extends org.apache.commons.lang3.StringUtils {
} }
return result.toString(); return result.toString();
} }
/** /**
* 首字母大写 * 首字母大写
*/ */
public static String cap(String str){ public static String cap(String str) {
return capitalize(str); return capitalize(str);
} }
/** /**
* 首字母小写 * 首字母小写
*/ */
public static String uncap(String str){ public static String uncap(String str) {
return uncapitalize(str); return uncapitalize(str);
} }
/** /**
* 转换为驼峰命名法 * 转换为驼峰命名法
* @return * @return camelCase("hello_world") == "helloWorld"
* camelCase("hello_world") == "helloWorld" * capCamelCase("hello_world") == "HelloWorld"
* capCamelCase("hello_world") == "HelloWorld" * uncamelCase("helloWorld") = "hello_world"
* uncamelCase("helloWorld") = "hello_world"
*/ */
public static String camelCase(String s) { public static String camelCase(String s) {
if (s == null) { if (s == null) {
return null; return null;
} }
s = s.toLowerCase(); s = s.toLowerCase();
StringBuilder sb = new StringBuilder(s.length()); StringBuilder sb = new StringBuilder(s.length());
boolean upperCase = false; boolean upperCase = false;
for (int i = 0, j = 0; i < s.length(); i++) { for (int i = 0, j = 0; i < s.length(); i++) {
char c = s.charAt(i); char c = s.charAt(i);
if (c == UNDERLINE.charAt(0) || c == MINUS.charAt(0)) { if (c == UNDERLINE.charAt(0) || c == MINUS.charAt(0)) {
upperCase = j > 1; // 不允许第二个字符是大写 upperCase = j > 1; // 不允许第二个字符是大写
} else if (upperCase) { } else if (upperCase) {
sb.append(Character.toUpperCase(c)); sb.append(Character.toUpperCase(c));
upperCase = false; upperCase = false;
j++; j++;
} else { } else {
sb.append(c); sb.append(c);
j++; j++;
} }
} }
return sb.toString(); return sb.toString();
} }
/** /**
* 转换为驼峰命名法（首字母大写） * 转换为驼峰命名法（首字母大写）
* @return *
* camelCase("hello_world") == "helloWorld" * @return camelCase("hello_world") == "helloWorld"
* capCamelCase("hello_world") == "HelloWorld" * capCamelCase("hello_world") == "HelloWorld"
* uncamelCase("helloWorld") = "hello_world" * uncamelCase("helloWorld") = "hello_world"
*/ */
public static String capCamelCase(String s) { public static String capCamelCase(String s) {
return cap(camelCase(s)); return cap(camelCase(s));
} }
/** /**
* 取消驼峰命名发 * 取消驼峰命名发
* @return *
* camelCase("hello_world") == "helloWorld" * @return camelCase("hello_world") == "helloWorld"
* capCamelCase("hello_world") == "HelloWorld" * capCamelCase("hello_world") == "HelloWorld"
* uncamelCase("helloWorld") = "hello_world" * uncamelCase("helloWorld") = "hello_world"
*/ */
public static String uncamelCase(String s) { public static String uncamelCase(String s) {
if (s == null) { if (s == null) {
return null; return null;
} }
StringBuilder sb = new StringBuilder(); StringBuilder sb = new StringBuilder();
boolean upperCase = false; boolean upperCase = false;
for (int i = 0; i < s.length(); i++) { for (int i = 0; i < s.length(); i++) {
char c = s.charAt(i); char c = s.charAt(i);
boolean nextUpperCase = true; boolean nextUpperCase = true;
if (i < (s.length() - 1)) { if (i < (s.length() - 1)) {
nextUpperCase = Character.isUpperCase(s.charAt(i + 1)); nextUpperCase = Character.isUpperCase(s.charAt(i + 1));
} }
if ((i > 0) && Character.isUpperCase(c)) { if ((i > 0) && Character.isUpperCase(c)) {
if (!upperCase || !nextUpperCase) { if (!upperCase || !nextUpperCase) {
sb.append(UNDERLINE); sb.append(UNDERLINE);
} }
upperCase = true; upperCase = true;
} else { } else {
upperCase = false; upperCase = false;
} }
sb.append(Character.toLowerCase(c)); sb.append(Character.toLowerCase(c));
} }
return sb.toString(); return sb.toString();
} }
/** /**
* 转换为JS获取对象值，生成三目运算返回结果 * 转换为JS获取对象值，生成三目运算返回结果
* @param objectString 对象串 * @param objectString 对象串
* 例如：row.user.id * 例如：row.user.id
* 返回：!row?'':!row.user?'':!row.user.id?'':row.user.id * 返回：!row?'':!row.user?'':!row.user.id?'':row.user.id
*/ */
public static String jsGetVal(String objectString){ public static String jsGetVal(String objectString) {
StringBuilder result = new StringBuilder(); StringBuilder result = new StringBuilder();
StringBuilder val = new StringBuilder(); StringBuilder val = new StringBuilder();
String[] vals = split(objectString, "."); String[] vals = split(objectString, ".");
for (String s : vals) { for (String s : vals) {
val.append(".").append(s); val.append(".").append(s);
result.append("!").append(val.substring(1)).append("?'':"); result.append("!").append(val.substring(1)).append("?'':");
} }
result.append(val.substring(1)); result.append(val.substring(1));
return result.toString(); return result.toString();
} }
/** /**
* 获取随机字符串 * 获取随机字符串
@@ -425,7 +456,7 @@ public class StringUtils extends org.apache.commons.lang3.StringUtils {
public static String getRandomStr(int count) { public static String getRandomStr(int count) {
char[] codeSeq = {'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', char[] codeSeq = {'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J',
'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W',
'X', 'Y', 'Z', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9' }; 'X', 'Y', 'Z', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9'};
return getRandom(count, codeSeq); return getRandom(count, codeSeq);
} }
@@ -440,7 +471,8 @@ public class StringUtils extends org.apache.commons.lang3.StringUtils {
/** /**
* 获取随机字符串 * 获取随机字符串
* @param count 长度 *
* @param count 长度
* @param codeSeq 因子 * @param codeSeq 因子
*/ */
private static String getRandom(int count, char[] codeSeq) { private static String getRandom(int count, char[] codeSeq) {
@@ -452,15 +484,15 @@ public class StringUtils extends org.apache.commons.lang3.StringUtils {
} }
return s.toString(); return s.toString();
} }
/** /**
* 获取树节点名字 * 获取树节点名字
* @param isShowCode 是否显示编码<br> * @param isShowCode 是否显示编码<br>
* true or 1：显示在左侧：(code) name<br> * true or 1：显示在左侧：(code) name<br>
* 2：显示在右侧：name (code)<br> * 2：显示在右侧：name (code)<br>
* false or null：不显示编码：name * false or null：不显示编码：name
* @param code 编码 * @param code 编码
* @param name 名称 * @param name 名称
*/ */
public static String getTreeNodeName(String isShowCode, String code, String name) { public static String getTreeNodeName(String isShowCode, String code, String name) {
if ("true".equals(isShowCode) || "1".equals(isShowCode)) { if ("true".equals(isShowCode) || "1".equals(isShowCode)) {