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;

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;

    /**
     * Map of advanced search conditions.
     */
    public Map<String, String[]> as = new HashMap<>();

    /**
     * The main search query string.
     */
    @Size(max = 1000)
    public String q;

    /**
     * The sort parameter for search results.
     */
    @Size(max = 1000)
    public String sort;

    /**
     * The number of search results to return per page.
     */

    private static final long serialVersionUID = 1L;

    /** Log type constant for search logs. */
    public static final String LOG_TYPE_SEARCH = "search";

    /** Log type constant for hourly search count aggregation. */
    public static final String LOG_TYPE_SEARCH_COUNT_HOUR = "search_count_hour_agg";

    /** Log type constant for daily search count aggregation. */

  - [Google Site Search (GSS) / Google Custom Search](#google-site-search-gss--google-custom-search-gse)
  - [Elasticsearch / OpenSearch](#elasticsearch--opensearch)
  - [Apache Solr](#apache-solr)
  - [Other Search Systems](#other-search-systems)
- [Data Import Methods](#data-import-methods)
- [Configuration Migration](#configuration-migration)
- [API Reference](#api-reference)
- [Troubleshooting](#troubleshooting)
- [Migration Checklist](#migration-checklist)

        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);
    }

import jakarta.servlet.http.HttpSession;

/**
 * Abstract base class for search-related actions in the Fess search application.
 * Provides common functionality for search operations, including search form handling,
 * label management, user authentication, and search result processing.
 *
 * This class extends FessBaseAction and serves as the foundation for all search-related
 * web actions in the application.
 */

        });
    }

    /**
     * Performs a search for failure URLs based on the provided criteria.
     *
     * @param form the search form containing filter criteria
     * @return HTML response for the failure URL list page with search results
     */
    @Execute
    @Secured({ ROLE, ROLE + VIEW })
    public HtmlResponse search(final SearchForm form) {

 */
package org.codelibs.fess.entity;

import java.util.Map;

/**
 * Interface for search log events in the Fess search system.
 *
 * This interface defines the contract for search log event objects that can be
 * written to log files or stored in the search index. Implementations include
 * search logs, click logs, favorite logs, and user information logs.
 */
public interface SearchLogEvent {
    /**

    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;

    /**