feat: StringTools 新增工具方法

新增 StringTools#isBlank、StringTools#isEmpty、StringTools#isNotEmpty、StringTools#isURL、StringTools#isEmail

src/test/java/xyz/zhouxy/plusone/commons/util/StringToolsTests.java

@@ -32,6 +32,10 @@ import org.junit.jupiter.api.Test;
 public
 class StringToolsTests {
 
+    // ================================
+    // #region - isNotBlank
+    // ================================
+
     @Test
     void isNotBlank_NullString_ReturnsFalse() {
         assertFalse(StringTools.isNotBlank(null));
@@ -52,6 +56,206 @@ class StringToolsTests {
         assertTrue(StringTools.isNotBlank("Hello"));
     }
 
+    // ================================
+    // #endregion - isNotBlank
+    // ================================
+
+    // ================================
+    // #region - isBlank
+    // ================================
+
+    @Test
+    void isBlank_NullString_ReturnsTrue() {
+        assertTrue(StringTools.isBlank(null));
+    }
+
+    @Test
+    void isBlank_EmptyString_ReturnsTrue() {
+        assertTrue(StringTools.isBlank(""));
+    }
+
+    @Test
+    void isBlank_WhitespaceString_ReturnsTrue() {
+        assertTrue(StringTools.isBlank("   "));
+    }
+
+    @Test
+    void isBlank_NonWhitespaceString_ReturnsFalse() {
+        assertFalse(StringTools.isBlank("Hello"));
+    }
+
+    // ================================
+    // #endregion - isBlank
+    // ================================
+
+    // ================================
+    // #region - isNotEmpty
+    // ================================
+
+    @Test
+    void isNotEmpty_NullString_ReturnsFalse() {
+        assertFalse(StringTools.isNotEmpty(null));
+    }
+
+    @Test
+    void isNotEmpty_EmptyString_ReturnsFalse() {
+        assertFalse(StringTools.isNotEmpty(""));
+    }
+
+    @Test
+    void isNotEmpty_WhitespaceString_ReturnsTrue() {
+        assertTrue(StringTools.isNotEmpty("   "));
+    }
+
+    @Test
+    void isNotEmpty_NonWhitespaceString_ReturnsTrue() {
+        assertTrue(StringTools.isNotEmpty("Hello"));
+    }
+
+    // ================================
+    // #endregion - isNotEmpty
+    // ================================
+
+    // ================================
+    // #region - isEmpty
+    // ================================
+
+    @Test
+    void isEmpty_NullString_ReturnsTrue() {
+        assertTrue(StringTools.isEmpty(null));
+    }
+
+    @Test
+    void isEmpty_EmptyString_ReturnsTrue() {
+        assertTrue(StringTools.isEmpty(""));
+    }
+
+    @Test
+    void isEmpty_WhitespaceString_ReturnsFalse() {
+        assertFalse(StringTools.isEmpty("   "));
+    }
+
+    @Test
+    void isEmpty_NonWhitespaceString_ReturnsFalse() {
+        assertFalse(StringTools.isEmpty("Hello"));
+    }
+
+    // ================================
+    // #endregion - isEmpty
+    // ================================
+
+    // ================================
+    // #region - EMAIL
+    // ================================
+
+    @Test
+    public void testValidEmails() {
+        assertTrue(StringTools.isEmail("test@example.com"));
+        assertTrue(StringTools.isEmail("user.name+tag+sorting@example.com"));
+        assertTrue(StringTools.isEmail("user@sub.example.com"));
+        assertTrue(StringTools.isEmail("user@123.123.123.123"));
+    }
+
+    @Test
+    public void testInvalidEmails() {
+        assertFalse(StringTools.isEmail(".username@example.com"));
+        assertFalse(StringTools.isEmail("@missingusername.com"));
+        assertFalse(StringTools.isEmail("plainaddress"));
+        assertFalse(StringTools.isEmail("username..username@example.com"));
+        assertFalse(StringTools.isEmail("username.@example.com"));
+        assertFalse(StringTools.isEmail("username@-example.com"));
+        assertFalse(StringTools.isEmail("username@-example.com"));
+        assertFalse(StringTools.isEmail("username@.com.com"));
+        assertFalse(StringTools.isEmail("username@.com.my"));
+        assertFalse(StringTools.isEmail("username@.com"));
+        assertFalse(StringTools.isEmail("username@com."));
+        assertFalse(StringTools.isEmail("username@com"));
+        assertFalse(StringTools.isEmail("username@example..com"));
+        assertFalse(StringTools.isEmail("username@example.com-"));
+        assertFalse(StringTools.isEmail("username@example.com."));
+        assertFalse(StringTools.isEmail("username@example"));
+    }
+
+    // ================================
+    // #endregion - EMAIL
+    // ================================
+
+    // ================================
+    // #region - isURL
+    // ================================
+
+        /**
+     * TC1: 验证标准HTTP协议URL
+     */
+    @Test
+    void isURL_ValidHttpURL_ReturnsTrue() {
+        assertTrue(StringTools.isURL("http://example.com"));
+    }
+
+    /**
+     * TC2: 验证带路径参数的HTTPS复杂URL
+     */
+    @Test
+    void isURL_ValidHttpsComplexURL_ReturnsTrue() {
+        assertTrue(StringTools.isURL("https://test.com:8080/api/v1?param=value#anchor"));
+    }
+
+    /**
+     * TC3: 验证FTP协议URL
+     */
+    @Test
+    void isURL_ValidFtpURL_ReturnsTrue() {
+        assertTrue(StringTools.isURL("ftp://files.example.com/directory/"));
+    }
+
+    /**
+     * TC4: 验证非法协议处理
+     */
+    @Test
+    void isURL_InvalidProtocol_ReturnsFalse() {
+        assertFalse(StringTools.isURL("httpx://invalid.com"));
+    }
+
+    /**
+     * TC5: 验证null输入处理
+     */
+    @Test
+    void isURL_NullInput_ReturnsFalse() {
+        assertFalse(StringTools.isURL(null));
+    }
+
+    /**
+     * TC6: 验证空字符串处理
+     */
+    @Test
+    void isURL_EmptyString_ReturnsFalse() {
+        assertFalse(StringTools.isURL(StringTools.EMPTY_STRING));
+    }
+
+    /**
+     * TC7: 验证缺失协议头处理
+     */
+    @Test
+    void isURL_MissingProtocol_ReturnsFalse() {
+        assertFalse(StringTools.isURL("www.example.com/path"));
+    }
+
+    /**
+     * TC8: 验证未编码特殊字符处理
+     */
+    @Test
+    void isURL_UnencodedSpecialChars_ReturnsTrue() {
+        assertTrue(StringTools.isURL("http://example.com/测试"));
+    }
+
+    // ================================
+    // #endregion - isURL
+    // ================================
+
+    // ================================
+    // #region - repeat
+    // ================================
+
     @Test
     void repeat_NullString_ThrowsException() {
         IllegalArgumentException exception = assertThrows(IllegalArgumentException.class, () -> {
@@ -90,6 +294,10 @@ class StringToolsTests {
         assertEquals("", StringTools.repeat("Hello", 0));
     }
 
+    // ================================
+    // #endregion - repeat
+    // ================================
+
     @Test
     void test_constructor_isNotAccessible_ThrowsIllegalStateException() {
         Constructor<?>[] constructors = StringTools.class.getDeclaredConstructors();