}

    /**
     * Gets the path to configuration files, falling back to classpath resources if not found.
     * First attempts to find the file in the configuration directory, then searches the classpath.
     *
     * @param names the path components to append to the configuration directory
     * @return the Path object pointing to the configuration file, either in conf directory or classpath
     */

            if (logger.isDebugEnabled()) {
                logger.debug("Failed to process a search request.", e);
            }
            writeJsonResponse(HttpServletResponse.SC_BAD_REQUEST, e);
        } catch (final Exception e) {
            if (logger.isDebugEnabled()) {
                logger.debug("Failed to process a search request.", e);
            }

   |
   | Default: false
  <offline>false</offline>
  -->

  <!-- pluginGroups
   | This is a list of additional group identifiers that will be searched when resolving plugins by their prefix, i.e.
   | when invoking a command line like "mvn prefix:goal". Maven will automatically add the group identifiers

        public long getCurrentTimeAsLong() {
            return System.currentTimeMillis();
        }

        @Override
        public String getSearchRoleByRole(String role) {
            return "search_" + role;
        }
    }

    static class MockPermissionHelper extends PermissionHelper {
        public MockPermissionHelper() {
            this.systemHelper = new MockSystemHelper();
        }
    }

import org.opensearch.action.search.ClearScrollRequest;
import org.opensearch.action.search.ClearScrollRequestBuilder;
import org.opensearch.action.search.ClearScrollResponse;
import org.opensearch.action.search.CreatePitRequest;
import org.opensearch.action.search.CreatePitResponse;
import org.opensearch.action.search.DeletePitRequest;
import org.opensearch.action.search.DeletePitResponse;

        }
    }

    /**
     * Searches the LDAP directory with the specified parameters.
     *
     * @param baseDn the base DN for the search
     * @param filter the search filter
     * @param returningAttrs the attributes to return from the search
     * @param envSupplier the supplier for environment configuration
     * @param consumer the consumer to handle search results
     */

    /**
     * Searches for classes handled by this instance and calls the handler for each class.
     * <p>
     * If a root package is specified at instance construction, only classes under the root package are targeted.
     * </p>
     *
     * @param handler the handler to process classes
     */
    void forEach(ClassHandler handler);

    /**

import org.opensearch.search.aggregations.bucket.terms.TermsAggregationBuilder;
import org.opensearch.search.aggregations.metrics.AvgAggregationBuilder;
import org.opensearch.search.aggregations.metrics.CardinalityAggregationBuilder;
import org.opensearch.search.aggregations.metrics.ExtendedStatsAggregationBuilder;
import org.opensearch.search.aggregations.metrics.MaxAggregationBuilder;

        return null; // ignore
    }

    /**
     * Executes a search based on the provided search criteria.
     *
     * @param form the list form containing search criteria
     * @return HTML response with search results
     */
    @Execute
    @Secured({ ROLE, ROLE + VIEW })
    public HtmlResponse search(final ListForm form) {
        saveToken();
        return doSearch(form);
    }

    protected boolean partialResults;

    /** The actual search query executed against the search engine. */
    protected String searchQuery;

    /** Time taken to execute the search query in milliseconds. */
    protected long queryTime;

    /** Timestamp when the search request was made. */
    protected long requestedTime;

    /** Unique identifier for this search query session. */
    protected String queryId;

    /**