});
        final OptionalEntity<SearchResponse> searchResponseOpt = sendRequest(query, params, userBean);
        return processResponse(searchResponseOpt);
    }

    /**
     * Processes the OpenSearch response and converts it to a SearchResult.
     *
     * @param searchResponseOpt the optional search response from OpenSearch
     * @return the processed search result
     */

     *
     * @param context the Tomcat context for this web resource root
     */
    public FessWebResourceRoot(final Context context) {
        super(context);
    }

    /**
     * Processes WEB-INF/lib directory and additionally scans WEB-INF/plugin for Fess plugins.
     * This method extends the standard processing to include plugin JAR files that contain
     * the "Fess-WebAppJar" manifest attribute.
     *

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

    /**
     * Processes uploaded search request files and executes them against the search engine.
     *
     * @param form the upload form containing the request file
     * @return action response with the search results or error page
     */

        if (logger.isDebugEnabled()) {
            logger.debug("store {} in session", stateData);
        }
        stateMap.put(state, stateData);
    }

    /**
     * Processes authentication data from the OAuth2 callback.
     * @param request The HTTP servlet request containing authentication data.
     * @return The login credential or null if processing fails.
     */

    @Resource
    private FailureUrlService failureUrlService;
    @Resource
    private FailureUrlPager failureUrlPager;
    /** Helper for managing crawler processes */
    @Resource
    protected ProcessHelper processHelper;

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

    //                                                                           =========
    @Resource
    private CrawlingInfoService crawlingInfoService;

    /** Helper for managing crawling processes and session information */
    @Resource
    protected ProcessHelper processHelper;

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

      into.putInt(from);
    }

    @Override
    public String toString() {
      return "Funnels.integerFunnel()";
    }
  }

  /**
   * Returns a funnel that processes an {@code Iterable} by funneling its elements in iteration
   * order with the specified funnel. No separators are added between the elements.
   *
   * @since 15.0
   */

      into.putInt(from);
    }

    @Override
    public String toString() {
      return "Funnels.integerFunnel()";
    }
  }

  /**
   * Returns a funnel that processes an {@code Iterable} by funneling its elements in iteration
   * order with the specified funnel. No separators are added between the elements.
   *
   * @since 15.0
   */

                logger.warn(message, e);
            }
            response.sendError(e.getStatusCode(), message);
        }
    }

    /**
     * Processes API requests to the search engine.
     * Handles both regular API calls and plugin requests.
     *
     * @param request  the HTTP servlet request
     * @param response the HTTP servlet response

        return System.getProperty(TOMCAT_CONFIG_PATH);
    }

    /**
     * Sets up the web application context with Fess-specific configurations.
     * Configures the web resource root and cookie processor for the context.
     */
    @Override
    protected void setupWebappContext() {
        super.setupWebappContext();
        String contextPath = getContextPath();