### 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:

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) {

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