@Resource
    protected AccessTokenService accessTokenService;

    /**
     * HTTP servlet request object providing access to request parameters, headers,
     * and other request-specific information needed for API processing.
     */
    @Resource
    protected HttpServletRequest request;

    /**
     * Returns an empty OptionalThing for login manager since API actions

 * and request tracing capabilities.
 *
 * <p>Each request is associated with a {@link ProtoSession} that contains the configuration
 * and context necessary for request processing, including:
 * <ul>
 *   <li>User and system properties for interpolation</li>
 *   <li>Session start time information</li>
 *   <li>Project directory structures</li>
 * </ul>
 *

                }
                break;
            }

            log.info("Processing async notification: {} for {}", eventType, notification.getResourceName());

            // Process the notification through the standard path
            processNotification(notification);

        } catch (Exception e) {
            log.error("Error processing async notification message", e);
        }
    }

    /**

 * <li>Field names and keys used throughout the application</li>
 * <li>Date/time format patterns</li>
 * <li>Authentication type identifiers</li>
 * <li>Reserved words and regex patterns for query processing</li>
 * </ul>
 */
public class Constants extends CoreLibConstants {

    /**
     * Private constructor to prevent instantiation of this utility class.

  PrimitiveSink putUnencodedChars(CharSequence charSequence);

  /**
   * Puts a string into this sink using the given charset.
   *
   * <p><b>Warning:</b> This method, which reencodes the input before processing it, is useful only
   * for cross-language compatibility. For other use cases, prefer {@link #putUnencodedChars}, which
   * is faster, produces the same output across Java releases, and processes every {@code char} in

 *
 * <p>
 * A Sitemap file provides search engines with a list of URLs available for crawling.
 * This class encapsulates the essential attributes of a Sitemap entry, allowing for efficient management
 * and processing of Sitemap data.
 * </p>
 *
 * <p>
 * The {@code loc} attribute specifies the URL of the Sitemap, while the {@code lastmod} attribute

                if (edge == null) { // no edges - don't need this vertex anymore
                    if (entry.equals(v)) { // unless it's an entry point.
                        // currently processing the entry point - it should not have any entry incident edges
                        res.getEntry().getMd().setWhy("This is a graph entry point. No links.");
                    }
                } else {

/**
 * Base search form class that extends SearchRequestParams.
 * Provides form fields and methods for handling search requests in the web interface.
 * Contains validation constraints and convenience methods for parameter processing.
 */
public class SearchForm extends SearchRequestParams {

    /**
     * Map of additional search fields with their values.
     */
    public Map<String, String[]> fields = new HashMap<>();

    /**

import org.xml.sax.InputSource;

import jakarta.annotation.PostConstruct;

/**
 * A transformer implementation for processing HTML documents using XPath expressions.
 * This class extends XpathTransformer to provide Fess-specific document processing capabilities
 * including content extraction, metadata processing, and robots tag handling.
 */
public class FessXpathTransformer extends XpathTransformer implements FessTransformer {

import jakarta.annotation.Resource;

/**
 * The {@code CrawlerThread} class represents a thread that executes the crawling process.
 * It is responsible for fetching URLs from the queue, accessing the content,
 * processing the response, and extracting child URLs.
 *
 * <p>
 * This class implements the {@link Runnable} interface, allowing it to be executed in a separate thread.