/**
     * Number of days to keep search logs before purging.
     * Set to -1 to disable automatic purging of search logs.
     */
    @Min(-1)
    @Max(100000)
    @ValidateTypeFailure
    public Integer purgeSearchLogDay;

    /**
     * Number of days to keep job logs before purging.
     * Set to -1 to disable automatic purging of job logs.
     */
    @Min(-1)
    @Max(100000)

import org.codelibs.fess.helper.SystemHelper;
import org.codelibs.fess.util.ComponentUtil;

/**
 * Job for purging old log entries from the system.
 * This job removes old crawling sessions, search logs, job logs, and user info logs
 * based on configured retention periods. It helps maintain system performance by
 * preventing log tables from growing too large.
 */
public class PurgeLogJob {

    /** Logger instance for this class */

import java.io.Serializable;
import java.util.List;

import org.codelibs.fess.util.ComponentUtil;

/**
 * Pager class for search log pagination and filtering.
 *
 * This class provides pagination functionality for various types of search logs
 * including search logs, click logs, favorite logs, and user information logs.
 * It also supports different aggregation types for analytics and reporting.
 */

    // GET /api/admin/failureurl/logs
    // PUT /api/admin/failureurl/logs
    /**
     * Retrieves failure URL logs with pagination.
     *
     * @param body the search criteria
     * @return JSON response containing the failure URL logs
     */
    @Execute
    public JsonResponse<ApiResult> logs(final SearchBody body) {
        validateApi(body, messages -> {});

    // GET /api/admin/joblog/logs
    /**
     * Returns list of job logs.
     * Supports filtering and pagination for job execution history.
     *
     * @param body search parameters for filtering and pagination
     * @return JSON response containing job logs list with pagination info
     */
    @Execute
    public JsonResponse<ApiResult> logs(final SearchBody body) {

            cb.specify().doColumn("searchField.*");
        }, this::indexFromSearchLog);
    }

    /**
     * Indexes suggest data from a list of search logs.
     *
     * @param searchLogList The list of search logs to index.
     */
    public void indexFromSearchLog(final List<SearchLog> searchLogList) {
        final Map<String, LocalDateTime> duplicateSessionMap = new HashMap<>();

    /**
     * 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
    @Execute
    public JsonResponse<ApiResult> logs(final SearchBody body) {
        validateApi(body, messages -> {});

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 String queryId;

    /**
     * The user session ID field for filtering logs by session.
     */
    public String userSessionId;

    /**
     * The requested time range field for filtering logs by date.
     */
    public String requestedTimeRange;

    /**
     * The access type field for filtering logs by access method.
     */
    public String accessType;

    /**

    }

    /**
     * Retrieves a specific job log by its ID.
     *
     * @param id the unique identifier of the job log
     * @return an optional entity containing the job log if found
     */
    public OptionalEntity<JobLog> getJobLog(final String id) {
        return jobLogBhv.selectByPK(id);
    }

    /**
     * Stores a job log entry in the database.