/**
     * Executes a search operation with the specified parameters.
     * This method must be implemented by concrete searcher classes.
     *
     * @param query the search query string
     * @param params the search request parameters including pagination, filters, etc.
     * @param userBean the optional user bean for access control and personalization
     * @return the search result containing matched documents and metadata
     */

 */
public class ResultOffsetExceededException extends FessSystemException {
    private static final long serialVersionUID = 1L;

    /**
     * Constructor.
     * @param message The exception message.
     */
    public ResultOffsetExceededException(final String message) {
        super(message);
    }

     * Sets the maximum number of compiled scripts to cache.
     *
     * @param scriptCacheSize the cache size
     */
    public void setScriptCacheSize(final int scriptCacheSize) {
        this.scriptCacheSize = scriptCacheSize;
    }

    /**
     * Sets the maximum length of script text included in warning log messages.
     *
     * @param maxScriptLogLength the max length
     */

    private static final long serialVersionUID = 1L;

    /**
     * Constructs a new LDAP configuration exception with the specified detail message.
     *
     * @param message The detail message.
     */
    public LdapConfigurationException(final String message) {
        super(message);
    }

        }
    }

    /**
     * Stores a failure URL with error information for later analysis.
     *
     * @param crawlerContext the crawler context
     * @param urlQueue the URL queue containing the failed URL
     * @param errorName the name/type of the error
     * @param e the throwable that caused the failure
     * @return the stored FailureUrl entity
     */

            buf.append(e.getSecond());
        });
        return buf.toString();
    }

    /**
     * Loads configuration parameters into a map.
     *
     * @param paramMap the parameter map
     * @param configParam the configuration parameter string
     */
    public static void loadConfigParams(final Map<String, Object> paramMap, final String configParam) {

     * Default constructor.
     */
    private OptionalUtil() {
        // Default constructor
    }

    /**
     * Creates an OptionalEntity from a nullable entity.
     *
     * @param <T> the type of the entity
     * @param entity the entity (can be null)
     * @return the OptionalEntity
     */
    public static <T> OptionalEntity<T> ofNullable(final T entity) {
        return OptionalEntity.ofNullable(entity, () -> {});

     * The template is processed using the script engine's templating mechanism,
     * with parameters from the paramMap substituted into the template.
     *
     * @param template the template string to evaluate
     * @param paramMap the map of parameters to substitute into the template
     * @return the result of evaluating the template, or null if evaluation fails
     */

        response.getWriter().write("{\"error\":\"ip_blocked\",\"message\":\"Access denied.\"}");
    }

    /**
     * Send a 429 Too Many Requests response.
     * @param response the HTTP response
     * @param retryAfterSeconds the Retry-After header value
     * @throws IOException if an I/O error occurs
     */

    //                                                                      ==============

    /**
     * Retrieves crawling info logs with pagination support.
     *
     * @param body the search body containing pagination and filter parameters
     * @return JSON response containing list of crawling info logs
     */
    // GET /api/admin/crawlinginfo/logs
    // PUT /api/admin/crawlinginfo/logs