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

Fess provides a [Google Search Appliance](https://enterprise.google.com/search/products/gsa.html) (GSA) compatible API. To enable this API, set `web.api.gsa=true` to system.properties. This will enable an enpoint at `<Fess Server Name>:8080/gsa`. When a search query is sent to `<Fess Server Name>:8080/gsa/?q=QUERY`, a GSA compatible response will be returned

        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());

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

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>

<a href="fess-webapp-classic-api/" title="fess-webapp-classic-api/">fess-webapp-classic-api/</a>                                         -         -      
<a href="fess-webapp-gsa-api/" title="fess-webapp-gsa-api/">fess-webapp-gsa-api/</a>                                             -         -      

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.

        final int fileType;
        if (fileName.startsWith("system") && fileName.endsWith(".properties")) {
            fileType = 1;
        } else if (fileName.startsWith("gsa") && fileName.endsWith(".xml")) {
            fileType = 2;
        } else if (fileName.endsWith(".bulk")) {
            fileType = 3;
        } else if (fileName.startsWith("fess") && fileName.endsWith(".json")) {

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

    String QUERY_GSA_RESPONSE_FIELDS = "query.gsa.response.fields";

    /** The key of the configuration. e.g. en */
    String QUERY_GSA_DEFAULT_LANG = "query.gsa.default.lang";

    /** The key of the configuration. e.g.  */
    String QUERY_GSA_DEFAULT_SORT = "query.gsa.default.sort";

    /** The key of the configuration. e.g. MT_ */
    String QUERY_GSA_META_PREFIX = "query.gsa.meta.prefix";

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