* Utility class for XML-related operations.
 *
 * This class provides methods to escape special characters in XML strings,
 * strip invalid XML characters, and parse XML content into a map of data.
 *
 * <p>
 * The class is final and cannot be instantiated.
 * </p>
 *
 * <h2>Methods:</h2>
 * <ul>
 *   <li>{@link #escapeXml(String)}: Escapes special characters in an XML string.</li>

        assertNotNull(urlFilter);
    }

    /**
     * Test special characters in URL patterns
     */
    public void test_specialCharactersInPatterns() {
        String sessionId = "test-session-018";
        urlFilter.init(sessionId);

        // Test patterns with special regex characters
        urlFilter.addInclude("https://example\\.com/\\?.*");

    /**
     * Checks if the given character is a valid URL character.
     *
     * Valid URL characters include:
     * - Lowercase letters (a-z)
     * - Uppercase letters (A-Z)
     * - Digits (0-9)
     * - Special characters: . - * _ : / + % = & ? # [ ] @ ~ ! $ ' ( ) , ;
     *
     * @param c the character to check
     * @return {@code true} if the character is a valid URL character, {@code false} otherwise
     */

        }
        testRule.setRuleId(longId.toString());
        assertEquals(longId.toString(), testRule.getRuleId());

        // Special characters in rule ID
        testRule.setRuleId("rule-id_with.special@chars#123");
        assertEquals("rule-id_with.special@chars#123", testRule.getRuleId());

        // Unicode characters
        testRule.setRuleId("ルール日本語");

        // Test special characters
        String specialText = "テスト@#$%^&*()";
        String specialId = SuggestUtil.createSuggestTextId(specialText);
        assertNotNull(specialId);
        assertEquals(Base64.getEncoder().encodeToString(specialText.getBytes(CoreLibConstants.CHARSET_UTF_8)), specialId);
    }

    @Test

 *
 * <p>
 * This class provides methods to:
 * </p>
 * <ul>
 *   <li>Detect the MIME type based on the input stream and filename.</li>
 *   <li>Normalize the filename to handle special characters.</li>
 *   <li>Configure whether to use the filename for MIME type detection.</li>
 *   <li>Configure whether to use the filename for MIME type detection when the stream is octet-stream.</li>
 * </ul>
 *
 * <p>

 * FileTransformer stores the content of a crawled resource as a file on the file system.
 * It extends HtmlTransformer and provides functionality to:
 * </p>
 * <ul>
 *     <li>Specify a base directory for storing files.</li>
 *     <li>Generate file paths from URLs, replacing special characters.</li>
 *     <li>Handle duplicated file paths by appending a counter.</li>
 *     <li>Store the file path in the result data.</li>

        assertNotNull(tokens);
        assertTrue(tokens.isEmpty());
    }

    @Test
    public void testAnalyzeWithSpecialCharacters() {
        // Test analyze with special characters
        String text = "******@****.*** #hashtag $100";
        String field = "content";
        String lang = "en";

        List<AnalyzeToken> tokens = analyzer.analyze(text, field, lang);

        assertNotNull(results);
    }

    @Test
    public void testConvertWithSpecialCharacters() throws IOException {
        // Test convert with special characters
        String text = "test@#$%123";
        String field = "content";

        List<String> results = converter.convert(text, field, "en");

        assertNotNull(results);
    }

    }

    /**
     * Test name with special characters
     */
    public void test_name_specialCharacters() {
        // Test with spaces
        testTransformer.setName("name with spaces");
        assertEquals("name with spaces", testTransformer.getName());

        // Test with special characters
        testTransformer.setName("name-with_special.chars#123");