### Google Search Appliance (GSA) / Google Mini

Fess provides comprehensive GSA migration support through configuration import and API compatibility.

#### Configuration Import

Fess can directly import GSA XML configuration files, automatically converting them to native Fess configurations.

**Step 1: Export GSA Configuration**

Export your GSA configuration as XML. A typical GSA configuration includes:

 * governing permissions and limitations under the License.
 */
package org.codelibs.fess.exception;

/**
 * Exception thrown when GSA (Google Search Appliance) configuration errors occur.
 * This exception extends FessSystemException and is used to handle specific
 * configuration-related issues when working with GSA integration.
 *
 */
public class GsaConfigException extends FessSystemException {

        Throwable intermediateCause = new RuntimeException("Intermediate problem", rootCause);
        GsaConfigException exception = new GsaConfigException("Top level GSA error", intermediateCause);

        assertNotNull(exception);
        assertEquals("Top level GSA error", exception.getMessage());

        // Check first level cause
        assertNotNull(exception.getCause());

import org.xml.sax.helpers.DefaultHandler;

/**
 * Parser for Google Search Appliance (GSA) configuration files.
 * This SAX-based parser reads GSA XML configuration files and converts them into
 * Fess configuration objects including web crawling configurations, file crawling
 * configurations, and label types for access control.
 *
 * <p>The parser handles the following GSA configuration elements:
 * <ul>
 * <li>Collections with good/bad URL patterns</li>

            logger.debug("GSA XML import started: fileName={}", fileName);
        }

        final GsaConfigParser configParser = ComponentUtil.getComponent(GsaConfigParser.class);
        try (final InputStream in = new FileInputStream(tempFile)) {
            configParser.parse(new InputSource(in));
        } catch (final IOException e) {

        /** Search request type. */
        SEARCH,
        /** Admin search request type. */
        ADMIN_SEARCH,
        /** JSON request type. */
        JSON,
        /** GSA request type. */
        GSA,
        /** Suggest request type. */
        SUGGEST;
    }

    /**
     * Returns the response fields.
     *
     * @return The response fields.
     */

query.additional.not.analyzed.fields=
# Fields for GSA response in queries.
query.gsa.response.fields=UE,U,T,RK,S,LANG
# Default language for GSA queries.
query.gsa.default.lang=en
# Default sort for GSA queries.
query.gsa.default.sort=
# Meta prefix for GSA queries.
query.gsa.meta.prefix=MT_
# Charset field for GSA index queries.
query.gsa.index.field.charset=charset
# Content type field for GSA index queries.

    /** Property key for suggest web API configuration. */
    public static final String WEB_API_SUGGEST_PROPERTY = "web.api.suggest";

    /** Property key for GSA web API configuration. */
    public static final String WEB_API_GSA_PROPERTY = "web.api.gsa";

    /** Property key for popular word web API configuration. */
    public static final String WEB_API_POPULAR_WORD_PROPERTY = "web.api.popularword";

    }

    /**
     * Processes search preferences specifically for GSA (Google Search Appliance) compatible requests.
     * This method determines the preference value based on configuration and query content.
     *
     * @param req the HTTP servlet request
     * @param query the search query string
     * @return the preference value for GSA search requests, or null if not applicable
     */

    public String userSessionId;

    /** Time range filter for search logs (format: "yyyy-MM-dd HH:mm - yyyy-MM-dd HH:mm"). */
    public String requestedTimeRange;

    /** Access type filter for search logs (web, json, gsa, admin, other). */
    public String accessType;

    /**
     * Default constructor for creating a new SearchLogPager instance.
     */
    public SearchLogPager() {
        // Default constructor
    }