* This method does not close the input stream.
     *
     * @param in Input stream for a sitemap
     * @return a sitemap set
     */
    public SitemapSet parse(final InputStream in) {
        return parse(in, true);
    }

    /**
     * Parses a sitemap from the given input stream.
     * @param in the input stream to parse
     * @param recursive whether to recursively parse compressed files

     * Constructor for SuggestItem.
     * @param text The text.
     * @param readings The readings.
     * @param fields The fields.
     * @param docFreq The document frequency.
     * @param queryFreq The query frequency.
     * @param userBoost The user boost.
     * @param tags The tags.
     * @param roles The roles.
     * @param languages The languages.
     * @param kind The kind.
     */

    }

    /**
     * Extracts URLs from HTML tag attributes using XPath.
     *
     * @param url the base URL for resolving relative URLs
     * @param document the document to extract URLs from
     * @param xpath the XPath expression to select elements
     * @param attr the attribute name to extract URLs from
     * @param encoding the character encoding to use
     * @return a list of extracted URLs
     */

     * Deletes documents from the specified index based on the given query.
     *
     * @param client the OpenSearch client to use for executing the query and delete operations
     * @param settings the settings for the suggest feature, including timeouts and scroll settings
     * @param index the name of the index from which documents should be deleted
     * @param queryBuilder the query used to identify documents to delete

 */
public interface ContentsParser {
    /**
     * Parses the given search words and creates a SuggestItem.
     *
     * @param words the array of search words
     * @param readings the array of readings corresponding to the search words
     * @param fields the array of fields associated with the search words
     * @param tags the array of tags associated with the search words
     * @param roles the array of roles associated with the search words

                clientConnectionManager.shutdown();
            }
        }
    }

    /**
     * Adds a property to the HTTP client configuration.
     *
     * @param name The property name
     * @param value The property value
     */
    public void addHttpClientProperty(final String name, final Object value) {
        if (StringUtil.isNotBlank(name) && value != null) {

            throw new CrawlingAccessException("Could not access bucket:" + name, e);
        }
    }

    /**
     * Processes a storage request with timeout management.
     * @param uri the URI to process
     * @param includeContent whether to include the actual content in the response
     * @return the response data for the request
     * @throws CrawlingAccessException if an error occurs while processing the request

     * Adds a URL to the queue.
     *
     * @param sessionId The session ID.
     * @param url The URL.
     */
    void add(String sessionId, String url);

    /**
     * Inserts a URL queue.
     *
     * @param urlQueue The URL queue.
     */
    void insert(QUEUE urlQueue);

    /**
     * Deletes a URL queue.
     *
     * @param sessionId The session ID.
     */
    void delete(String sessionId);

/**
 * Represents the result of accessing a resource.
 *
 * @param <IDTYPE> the type of the identifier for the access result
 */
public interface AccessResult<IDTYPE> {

    /**
     * Initializes the access result with the given response and result data.
     *
     * @param responseData the response data
     * @param resultData the result data
     */

                buf.append(c);
            }
        }
        return buf.toString().trim();
    }

    /**
     * Parses the XML content from the provided {@link AccessResultData} and returns a map of the data.
     *
     * @param accessResultData the data containing the XML content to be parsed
     * @return a map containing the parsed data from the XML content