}

    /**
     * Gets a String value from the map with a default value.
     *
     * @param map The source map
     * @param key The key to look up
     * @param defaultValue The default value to return if key doesn't exist or value is null
     * @return The string value, or defaultValue if not found
     */

     *
     * @param ipAddress the IP address
     */
    public void setIpAddress(String ipAddress) {
        this.ipAddress = ipAddress;
    }

    /**
     * Sets the IP address from an InetAddress.
     *
     * @param address the InetAddress
     */
    public void setIpAddress(InetAddress address) {
        if (address != null) {
            this.ipAddress = address.getHostAddress();

     *
     * @param content the content chunk
     * @param done true if this is the final chunk
     */
    void onChunk(String content, boolean done);

    /**
     * Called when an error occurs during processing.
     *
     * @param phase the phase where the error occurred
     * @param error the error message
     */
    void onError(String phase, String error);

        return 0L;
    }

    /**
     * Updates a specific field of a document in the search index.
     *
     * @param searchEngineClient the search engine client to use for the update
     * @param id the document ID to update
     * @param field the field name to update
     * @param value the new value for the field
     * @return true if the update was successful, false otherwise
     */

         * For quoted queries on the default field, creates a phrase query instead of a term query.
         *
         * @param field the field to query
         * @param queryText the query text
         * @param quoted whether the query is quoted
         * @return the created Query object
         * @throws ParseException if the query cannot be parsed
         */
        @Override

        setNumberOfReplicas(crawlerConfig.getQueueReplicas());
    }

    /**
     * Creates a new instance of OpenSearchUrlQueueService.
     * @param name The name.
     * @param type The type.
     */
    public OpenSearchUrlQueueService(final String name, final String type) {
        index = name + "." + type;
    }

    /**
     * Initializes the service.
     */
    @PostConstruct

    @Execute
    @Secured({ ROLE, ROLE + VIEW })
    public HtmlResponse index() {
        saveToken();
        return asListHtml();
    }

    /**
     * Show the list page.
     * @param pageNumber The page number.
     * @param form The search form.
     * @return The HTML response.
     */
    @Execute
    @Secured({ ROLE, ROLE + VIEW })
    public HtmlResponse list(final Integer pageNumber, final SearchForm form) {

     *
     * This method fetches stemmer override entries with pagination support, updating
     * the provided pager with the current page state and navigation information.
     *
     * @param dictId The ID of the stemmer override dictionary to query
     * @param stemmerOvberridePager The pager object for pagination control and state
     * @return A list of stemmer override items for the current page, or empty list if dictionary not found
     */

     *
     * @param documentList The list of documents returned by the search
     * @param allRecordCount The total number of matching records
     * @param allRecordCountRelation The relation type for the record count
     * @param queryTime The time taken to execute the query in milliseconds
     * @param partialResults Whether the results are partial
     * @param facetResponse The facet response containing aggregated data

    /**
     * Resolves an array of SIDs to obtain their account and domain names.
     *
     * @param authorityServerName the server to use for SID resolution
     * @param auth the authentication credentials to use
     * @param sids the array of SIDs to resolve
     * @param offset the starting offset in the array
     * @param length the number of SIDs to resolve
     * @throws IOException if there is an error resolving the SIDs
     */