enhance StrUtil

CHANGELOG.md

@@ -11,6 +11,7 @@
 * 【core   】     XmlUtil.cleanComment（pr#191@Gitee）
 * 【core   】     ArrayUtil.unWrap增加默认值（pr#1149@Github）
 * 【core   】     ArrayUtil.indexOf修改double的equals判断（pr#1147@Github）
+* 【core   】     优化StrUtil中部分参数校验以及逻辑处理（pr#1144@Github）
 
 ### Bug修复
 * 【core   】     解决农历判断节日未判断大小月导致的问题（issue#I1XHSF@Gitee）

hutool-core/src/main/java/cn/hutool/core/util/StrUtil.java

@@ -34,53 +34,95 @@ public class StrUtil {
 
 	public static final int INDEX_NOT_FOUND = -1;
 
-	/** 字符常量：空格符 ' ' */
+	/**
+	 * 字符常量：空格符 ' '
+	 */
 	public static final char C_SPACE = CharUtil.SPACE;
-	/** 字符常量：制表符 \t */
+	/**
+	 * 字符常量：制表符 \t
+	 */
 	public static final char C_TAB = CharUtil.TAB;
-	/** 字符常量：点 . */
+	/**
+	 * 字符常量：点 .
+	 */
 	public static final char C_DOT = CharUtil.DOT;
-	/** 字符常量：斜杠 / */
+	/**
+	 * 字符常量：斜杠 /
+	 */
 	public static final char C_SLASH = CharUtil.SLASH;
-	/** 字符常量：反斜杠 \ */
+	/**
+	 * 字符常量：反斜杠 \
+	 */
 	public static final char C_BACKSLASH = CharUtil.BACKSLASH;
-	/** 字符常量：回车符 \r */
+	/**
+	 * 字符常量：回车符 \r
+	 */
 	public static final char C_CR = CharUtil.CR;
-	/** 字符常量：换行符 \n */
+	/**
+	 * 字符常量：换行符 \n
+	 */
 	public static final char C_LF = CharUtil.LF;
-	/** 字符常量：下划线 _ */
+	/**
+	 * 字符常量：下划线 _
+	 */
 	public static final char C_UNDERLINE = CharUtil.UNDERLINE;
-	/** 字符常量：逗号 , */
+	/**
+	 * 字符常量：逗号 ,
+	 */
 	public static final char C_COMMA = CharUtil.COMMA;
-	/** 字符常量：花括号（左） { */
+	/**
+	 * 字符常量：花括号（左） {
+	 */
 	public static final char C_DELIM_START = CharUtil.DELIM_START;
-	/** 字符常量：花括号（右） } */
+	/**
+	 * 字符常量：花括号（右） }
+	 */
 	public static final char C_DELIM_END = CharUtil.DELIM_END;
-	/** 字符常量：中括号（左） [ */
+	/**
+	 * 字符常量：中括号（左） [
+	 */
 	public static final char C_BRACKET_START = CharUtil.BRACKET_START;
-	/** 字符常量：中括号（右） ] */
+	/**
+	 * 字符常量：中括号（右） ]
+	 */
 	public static final char C_BRACKET_END = CharUtil.BRACKET_END;
-	/** 字符常量：冒号 : */
+	/**
+	 * 字符常量：冒号 :
+	 */
 	public static final char C_COLON = CharUtil.COLON;
-	/** 字符常量：艾特 @ */
+	/**
+	 * 字符常量：艾特 @
+	 */
 	public static final char C_AT = CharUtil.AT;
 
-	/** 字符串常量：空格符 ' ' */
+	/**
+	 * 字符串常量：空格符 ' '
+	 */
 	public static final String SPACE = " ";
-	/** 字符串常量：制表符 \t */
+	/**
+	 * 字符串常量：制表符 \t
+	 */
 	public static final String TAB = "	";
-	/** 字符串常量：点 . */
+	/**
+	 * 字符串常量：点 .
+	 */
 	public static final String DOT = ".";
 	/**
 	 * 字符串常量：双点 ..
 	 * 用途：作为指向上级文件夹的路径 "../path"
 	 */
 	public static final String DOUBLE_DOT = "..";
-	/** 字符串常量：斜杠 / */
+	/**
+	 * 字符串常量：斜杠 /
+	 */
 	public static final String SLASH = "/";
-	/** 字符串常量：反斜杠 \ */
+	/**
+	 * 字符串常量：反斜杠 \
+	 */
 	public static final String BACKSLASH = "\\";
-	/** 字符串常量：空字符串 "" */
+	/**
+	 * 字符串常量：空字符串 ""
+	 */
 	public static final String EMPTY = "";
 	/**
 	 * 字符串常量："null"
@@ -92,45 +134,79 @@ public class StrUtil {
 	 * 解释：该字符常用于表示 Linux 系统和 MacOS 系统下的文本换行
 	 */
 	public static final String CR = "\r";
-	/** 字符串常量：换行符 \n */
+	/**
+	 * 字符串常量：换行符 \n
+	 */
 	public static final String LF = "\n";
 	/**
 	 * 字符串常量：Windows 换行 \r\n
 	 * 解释：该字符串常用于表示 Windows 系统下的文本换行
 	 */
 	public static final String CRLF = "\r\n";
-	/** 字符串常量：下划线 _ */
+	/**
+	 * 字符串常量：下划线 _
+	 */
 	public static final String UNDERLINE = "_";
-	/** 字符串常量：减号（中划线） - */
+	/**
+	 * 字符串常量：减号（中划线） -
+	 */
 	public static final String DASHED = "-";
-	/** 字符串常量：逗号 , */
+	/**
+	 * 字符串常量：逗号 ,
+	 */
 	public static final String COMMA = ",";
-	/** 字符串常量：花括号（左） { */
+	/**
+	 * 字符串常量：花括号（左） {
+	 */
 	public static final String DELIM_START = "{";
-	/** 字符串常量：花括号（右） } */
+	/**
+	 * 字符串常量：花括号（右） }
+	 */
 	public static final String DELIM_END = "}";
-	/** 字符串常量：中括号（左） [ */
+	/**
+	 * 字符串常量：中括号（左） [
+	 */
 	public static final String BRACKET_START = "[";
-	/** 字符串常量：中括号（右） ] */
+	/**
+	 * 字符串常量：中括号（右） ]
+	 */
 	public static final String BRACKET_END = "]";
-	/** 字符串常量：冒号 : */
+	/**
+	 * 字符串常量：冒号 :
+	 */
 	public static final String COLON = ":";
-	/** 字符串常量：艾特 @ */
+	/**
+	 * 字符串常量：艾特 @
+	 */
 	public static final String AT = "@";
 
-	/** 字符串常量：HTML 空格转义 */
+	/**
+	 * 字符串常量：HTML 空格转义
+	 */
 	public static final String HTML_NBSP = " ";
-	/** 字符串常量：HTML And 符转义 & */
+	/**
+	 * 字符串常量：HTML And 符转义 &
+	 */
 	public static final String HTML_AMP = "&";
-	/** 字符串常量：HTML 双引号转义 " */
+	/**
+	 * 字符串常量：HTML 双引号转义 "
+	 */
 	public static final String HTML_QUOTE = """;
-	/** 字符串常量：HTML 单引号转义 ' */
+	/**
+	 * 字符串常量：HTML 单引号转义 '
+	 */
 	public static final String HTML_APOS = "'";
-	/** 字符串常量：HTML 小于号转义 < */
+	/**
+	 * 字符串常量：HTML 小于号转义 <
+	 */
 	public static final String HTML_LT = "<";
-	/** 字符串常量：HTML 大于号转义 > */
+	/**
+	 * 字符串常量：HTML 大于号转义 >
+	 */
 	public static final String HTML_GT = ">";
-	/** 字符串常量：空 JSON "{}" */
+	/**
+	 * 字符串常量：空 JSON "{}"
+	 */
 	public static final String EMPTY_JSON = "{}";
 
 	// ------------------------------------------------------------------------ Blank
@@ -189,8 +265,7 @@ public class StrUtil {
 	 *
 	 * @param obj 对象
 	 * @return 如果为字符串是否为空串
-	 *
-	 * @see   StrUtil#isBlank(CharSequence)
+	 * @see StrUtil#isBlank(CharSequence)
 	 * @since 3.3.0
 	 */
 	public static boolean isBlankIfStr(Object obj) {
@@ -667,7 +742,7 @@ public class StrUtil {
 	 * @return 是否开始
 	 */
 	public static boolean startWith(CharSequence str, char c) {
-		if(true == isEmpty(str)) {
+		if (isEmpty(str)) {
 			return false;
 		}
 		return c == str.charAt(0);
@@ -677,8 +752,8 @@ public class StrUtil {
 	 * 是否以指定字符串开头<br>
 	 * 如果给定的字符串和开头字符串都为null则返回true，否则任意一个值为null返回false
 	 *
-	 * @param str          被监测字符串
-	 * @param prefix       开头字符串
+	 * @param str        被监测字符串
+	 * @param prefix     开头字符串
 	 * @param ignoreCase 是否忽略大小写
 	 * @return 是否以指定字符串开头
 	 * @since 5.4.3
@@ -693,14 +768,14 @@ public class StrUtil {
 	 *
 	 * @param str          被监测字符串
 	 * @param prefix       开头字符串
-	 * @param ignoreCase 是否忽略大小写
+	 * @param ignoreCase   是否忽略大小写
 	 * @param ignoreEquals 是否忽略字符串相等的情况
 	 * @return 是否以指定字符串开头
 	 * @since 5.4.3
 	 */
 	public static boolean startWith(CharSequence str, CharSequence prefix, boolean ignoreCase, boolean ignoreEquals) {
 		if (null == str || null == prefix) {
-			if(false == ignoreEquals){
+			if (false == ignoreEquals) {
 				return false;
 			}
 			return null == str && null == prefix;
@@ -713,7 +788,7 @@ public class StrUtil {
 			isStartWith = str.toString().startsWith(prefix.toString());
 		}
 
-		if(isStartWith){
+		if (isStartWith) {
 			return (false == ignoreEquals) || (false == equals(str, prefix, ignoreCase));
 		}
 		return false;
@@ -782,7 +857,7 @@ public class StrUtil {
 	 * @return 是否结尾
 	 */
 	public static boolean endWith(CharSequence str, char c) {
-		if(true == isEmpty(str)) {
+		if (isEmpty(str)) {
 			return false;
 		}
 		return c == str.charAt(str.length() - 1);
@@ -4004,7 +4079,7 @@ public class StrUtil {
 		}
 		int len = value.length();
 		for (int i = 0; i < len; i++) {
-			if(false == matcher.match(value.charAt(i))) {
+			if (false == matcher.match(value.charAt(i))) {
 				return false;
 			}
 		}