}

    /**
     * Creates a temporary file.
     * @param prefix The prefix string to be used in generating the file's name.
     * @param suffix The suffix string to be used in generating the file's name.
     * @param directory The directory in which the file is to be created, or null if the default temporary-file directory is to be used.
     * @return The created temporary file.
     */

    /**
     * Converts the given text into a list of readings based on the specified field and languages.
     *
     * @param text the text to be converted.
     * @param field the field to be used for conversion.
     * @param langs the languages to be used for conversion.
     * @return a list of readings for the given text.
     * @throws IOException if an I/O error occurs during conversion.
     */

    /**
     * A class that provides an input stream for reading from a temporary file.
     * This class wraps a {@link FileInputStream} to read from the specified temporary file.
     *
     * @param tempFile the temporary file to be read
     * @throws FileNotFoundException if the specified file does not exist
     */
    public TemporaryFileInputStream(final File tempFile) throws FileNotFoundException {
        this.tempFile = tempFile;

 *
 * 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>

    }

    /**
     * The container that provides crawler components.
     */
    @Resource
    protected CrawlerContainer crawlerContainer;

    /**
     * The name of the component to be retrieved from the CrawlerContainer.
     */
    protected String componentName;

    /**
     * The listener that is called when a pooled object is destroyed.
     */

     * @param rule the rule to be added
     */
    /**
     * Adds a rule to the specified index.
     *
     * @param index the position at which the rule should be added
     * @param rule the rule to be added
     */
    void addRule(int index, Rule rule);

    /**
     * Removes the specified rule from the rule manager.
     *
     * @param rule the rule to be removed

     * Identifies the location of the Sitemap. This location can be a Sitemap,
     * an Atom file, RSS file or a simple text file.
     */
    private String loc;

    /**
     * Identifies the time that the corresponding Sitemap file was modified. It
     * does not correspond to the time that any of the pages listed in that
     * Sitemap were changed. The value for the lastmod tag should be in W3C
     * Datetime format.
     *

     *
     * @param method the HTTP method to be set (e.g., GET, POST, etc.)
     */
    void setMethod(String method);

    /**
     * Retrieves the URL from the queue.
     *
     * @return the URL as a String.
     */
    String getUrl();

    /**
     * Sets the URL for this UrlQueue.
     *
     * @param url the URL to be set
     */
    void setUrl(String url);

    /**

     */
    public void test_addInclude_invalidRegex() {
        String sessionId = "test-session-004";
        urlFilter.init(sessionId);

        // Invalid regex pattern should be handled gracefully
        urlFilter.addInclude(".*[invalid");
        urlFilter.addInclude("https://valid.com/.*");

        // Valid pattern should still work

         * - Symbol characters (!-/, :-@, [-`, {-~) are appended to the buffer.
         * - Duplicate terms can be removed based on the `duplicateTermRemoved` flag.
         * - The maximum size of alphanumeric and symbol terms can be limited by `maxAlphanumTermSize` and `maxSymbolTermSize` respectively.
         *