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

This commit is contained in:
thinkgem
2025-10-10 19:25:41 +08:00
parent 1199d947ff
commit d475e154a6

View File

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