* This exception wraps Lucene's ParseException to provide consistent error handling
 * within the Fess search framework.
 *
 */
public class QueryParseException extends FessSystemException {

    /** Serial version UID for serialization compatibility */
    private static final long serialVersionUID = 1L;

    /**
     * Constructs a new QueryParseException with the specified ParseException as the cause.
     *

 * query is malformed, contains invalid syntax, or violates query constraints.
 */
public class InvalidQueryException extends FessSystemException {

    /** Serial version UID for serialization */
    private static final long serialVersionUID = 1L;

    /** Message code for localized error messages */
    private final transient VaMessenger<FessMessages> messageCode;

    /**

 * This exception is typically thrown during authentication or user lookup operations
 * when the specified user does not exist in the system.
 */
public class FessUserNotFoundException extends FessSystemException {

    /** Serial version UID for serialization compatibility */
    private static final long serialVersionUID = 1L;

    /**
     * Constructs a new FessUserNotFoundException with the specified username.
     *

 * This exception is typically used for issues during dictionary file
 * reading, writing, parsing, or other dictionary-related operations.
 */
public class DictionaryException extends FessSystemException {

    /** Serial version UID for serialization. */
    private static final long serialVersionUID = 1L;

    /**
     * Creates a new DictionaryException with the specified message and cause.
     *

 * such as configuration errors, initialization failures, or critical runtime issues.
 */
public class FessSystemException extends RuntimeException {

    /** Serial version UID for serialization compatibility */
    private static final long serialVersionUID = 1L;

    /**
     * Constructs a new FessSystemException with the specified detail message and cause.
     *

import org.jspecify.annotations.Nullable;

/**
 * Implementation of {@link ImmutableSet} with exactly one element.
 *
 * @author Kevin Bourrillion
 * @author Nick Kralevich
 */
@GwtCompatible
@SuppressWarnings("serial") // uses writeReplace(), not default serialization
final class SingletonImmutableSet<E> extends ImmutableSet<E> {
  // We deliberately avoid caching the asList and hashCode here, to ensure that with

        }

        /**
         * Sets the URL associated with this statistics key object.
         *
         * @param url the URL to associate with this object
         */
        public void setUrl(final String url) {
            this.url = url;
        }

        /**
         * Gets the URL associated with this statistics key object.
         *

  private static Runnable runnableThrowing(RuntimeException e) {
    return new Runnable() {
      @Override
      public void run() {
        throw e;
      }
    };
  }

  @SuppressWarnings("serial")
  private static class SampleCheckedException extends Exception {}

            m.setGroupId(GROUP_ID);
            m.setVersion(VERSION);
            Repository repository = new Repository();
            repository.setId(REPO_ID);
            repository.setUrl(REPO_URL);
            repository.setLayout(REPO_LAYOUT);
            m.getRepositories().add(repository);
            return m;
        }
        return null;
    }

 * and processing time metrics. It's used throughout the Fess search system to
 * manage collections of search results and crawled documents.
 *
 */
public class DocList extends ArrayList<Map<String, Object>> {

    /** Serial version UID for serialization */
    private static final long serialVersionUID = 1L;

    /** Total content size of all documents in this list */
    private long contentSize = 0;