/**
 * Exception thrown when theme-related operations fail.
 * This exception is used for errors during theme installation, uninstallation, or configuration.
 */
public class ThemeException extends FessSystemException {

    private static final long serialVersionUID = 1L;

    /**
     * Constructs a new ThemeException with the specified message and cause.
     *
     * @param message the exception message

/**
 * Exception thrown when thumbnail generation fails.
 * This exception is used for errors during thumbnail creation and processing.
 */
public class ThumbnailGenerationException extends FessSystemException {

    private static final long serialVersionUID = 1L;

    /**
     * Constructs a new ThumbnailGenerationException with the specified message and cause.
     *
     * @param message the exception message

 * 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;

    /**

 * This exception is typically used in authentication and authorization contexts
 * where a provided access token is invalid, expired, or malformed.
 */
public class InvalidAccessTokenException extends FessSystemException {

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

    /** Type of the invalid access token */
    private final String type;

    /**

import org.codelibs.fess.app.web.api.ApiResult.ApiUpdateResponse;
import org.codelibs.fess.app.web.api.ApiResult.Status;
import org.codelibs.fess.app.web.api.admin.FessApiAdminAction;
import org.codelibs.fess.exception.FessSystemException;
import org.codelibs.fess.helper.SuggestHelper;
import org.codelibs.fess.opensearch.config.exentity.BadWord;
import org.codelibs.fess.util.ComponentUtil;
import org.lastaflute.web.Execute;

     * @throws FessSystemException if no access token is available
     */
    public String getServerPath() {
        return getSessionManager().getAttribute(Constants.SEARCH_ENGINE_API_ACCESS_TOKEN, String.class)
                .map(token -> ADMIN_SERVER + token)
                .orElseThrow(() -> new FessSystemException("Cannot create an access token."));
    }

    /**

 * It can be used to wrap underlying storage exceptions, providing a
 * consistent error handling mechanism for storage operations.
 */
public class StorageException extends FessSystemException {
    private static final long serialVersionUID = 1L;

    /**
     * Constructs a new storage exception with the specified detail message and cause.
     *
     * @param message The detail message.

        if (configId == null) {
            throw new FessSystemException("configId is null.");
        }
        if (configId.length() < 2) {
            throw new FessSystemException("Invalid configId: " + configId);
        }
        final CrawlingConfig config = crawlingConfigHelper.getCrawlingConfig(configId);
        if (config == null) {
            throw new FessSystemException("No crawlingConfig: " + configId);
        }

 * This exception is typically used in search contexts where a provided
 * 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 */

 * This is a system-level exception that indicates problems with data store
 * configuration, connectivity, or data processing.
 */
public class DataStoreException extends FessSystemException {
    private static final long serialVersionUID = 1L;

    /**
     * Creates a new DataStoreException with the specified message and cause.
     *
     * @param message the error message