* It builds and runs a command-line process to generate suggest data,
 * handling classpath setup, system properties, and process monitoring.
 */
public class SuggestJob extends ExecJob {

    private static final Logger logger = LogManager.getLogger(SuggestJob.class);

    /**
     * Constructs a new suggest job.
     */
    public SuggestJob() {
        // do nothing
    }

    @Override
    public String execute() {

                            if (logger.isTraceEnabled()) {
                                logger.trace(msg);
                            } else if (logger.isDebugEnabled()) {
                                logger.debug(msg);
                            } else if (logger.isWarnEnabled()) {
                                logger.warn(msg);
                            } else if (logger.isErrorEnabled()) {

public class AccessTimeoutTarget implements TimeoutTarget {

    private static final Logger logger = LogManager.getLogger(AccessTimeoutTarget.class);

    private static final int MAX_LOOP_COUNT = 10;

    /** The thread being monitored. */
    protected Thread runningThread;

    /** Flag indicating if the thread is still running. */
    protected AtomicBoolean running = new AtomicBoolean();

    /**

 * supports dependency injection via the {@link Resource} annotation.
 * </p>
 */
public class ExtractorFactory {

    /** Logger instance for this class */
    private static final Logger logger = LogManager.getLogger(ExtractorFactory.class);

    /** Container for managing crawler components */
    @Resource
    protected CrawlerContainer crawlerContainer;

 * <ul>
 *   <li>Retry up to 5 times</li>
 *   <li>Wait 500ms between retries</li>
 * </ul>
 *
 */
public class FaultTolerantClient implements CrawlerClient {

    /** Logger instance for this class */
    private static final Logger logger = LogManager.getLogger(FaultTolerantClient.class);

    /** The underlying crawler client */
    protected CrawlerClient client;

    /** Maximum number of retry attempts */

/**
 * API action for admin related query management.
 * Provides REST endpoints for managing related search queries.
 */
public class ApiAdminRelatedqueryAction extends FessApiAdminAction {

    private static final Logger logger = LogManager.getLogger(ApiAdminRelatedqueryAction.class);

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

 */
public class FessCrawlerThread extends CrawlerThread {

    /**
     * Default constructor.
     */
    public FessCrawlerThread() {
        super();
    }

    private static final Logger logger = LogManager.getLogger(FessCrawlerThread.class);

    /** Configuration key for crawler clients used in parameter maps */
    protected static final String CRAWLER_CLIENTS = "crawlerClients";

        // Default constructor
    }

    /** Logger instance for this class. */
    private static final Logger logger = LogManager.getLogger(CrawlerStatsHelper.class);

    /** Key used to store the begin timestamp in statistics objects. */
    private static final String BEGIN_KEY = "begin";

    /** Logger instance specifically for outputting crawler statistics. */
    protected Logger statsLogger = null;

 * This searcher handles query execution, response processing, and document highlighting.
 */
public class DefaultSearcher extends RankFusionSearcher {

    /** Logger for this class. */
    private static final Logger logger = LogManager.getLogger(DefaultSearcher.class);

    /**
     * Creates a new instance of DefaultSearcher.
     * This constructor initializes the default rank fusion searcher for performing

        } catch (final InvalidQueryException e) {
            if (logger.isDebugEnabled()) {
                logger.debug("Invalid query: {}", form.q, e);
            }
            throwValidationError(e.getMessageCode(), this::asListHtml);
        } catch (final ResultOffsetExceededException e) {
            if (logger.isDebugEnabled()) {
                logger.debug("Invalid offset: {}", form.offset, e);
            }