import org.opensearch.action.search.GetAllPitNodesResponse;
import org.opensearch.action.search.MultiSearchRequest;
import org.opensearch.action.search.MultiSearchRequestBuilder;
import org.opensearch.action.search.MultiSearchResponse;
import org.opensearch.action.search.SearchRequest;
import org.opensearch.action.search.SearchRequestBuilder;
import org.opensearch.action.search.SearchResponse;
import org.opensearch.action.search.SearchScrollRequest;

 */
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 {
    /**

 */
public interface ContentsParser {
    /**
     * Parses the given search words and creates a SuggestItem.
     *
     * @param words the array of search words
     * @param readings the array of readings corresponding to the search words
     * @param fields the array of fields associated with the search words
     * @param tags the array of tags associated with the search words
     * @param roles the array of roles associated with the search words

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.
 */

    //                                                                      Search Execute
    //                                                                      ==============
    /**
     * The index page.
     * @param form The search form.
     * @return The HTML response.
     */
    @Execute
    public HtmlResponse index(final SearchForm form) {
        return search(form);
    }

    /**
     * The advance search page.

/**
 * Helper class for handling search operations in Fess.
 *
 * This class provides comprehensive search functionality including document search,
 * scroll search, and bulk operations. It handles search request parameter processing,
 * query building, response formatting, and search log management.
 *
 * Key features:
 * - Document search with pagination and faceting
 * - Scroll search for large result sets

        });
    }

    /**
     * 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) {

import org.opensearch.search.aggregations.bucket.sampler.SamplerAggregationBuilder;
import org.opensearch.search.aggregations.bucket.terms.SignificantTermsAggregationBuilder;
import org.opensearch.search.aggregations.bucket.terms.TermsAggregationBuilder;
import org.opensearch.search.aggregations.metrics.AvgAggregationBuilder;
import org.opensearch.search.aggregations.metrics.CardinalityAggregationBuilder;

# Default permissions for search roles.
role.search.default.permissions=
# Default display permissions for search roles.
role.search.default.display.permissions={role}guest
# Guest permissions for search roles.
role.search.guest.permissions={role}guest

# Prefix for user roles in search.
role.search.user.prefix=1
# Prefix for group roles in search.
role.search.group.prefix=2

tags:
  - name: search
    description: Search operations
  - name: popularword
    description: Popular word operations
  - name: monitor
    description: Monitoring operations
  - name: suggest
    description: Suggest operations
  - name: favorite
    description: Favorite operations
paths:
  /documents:
    get:
      tags:
        - search
      summary: Finds documents by query