*/
package org.codelibs.fess.crawler.entity;

import java.io.Serializable;

/**
 * Represents an alternate link entry within a sitemap URL.
 * This class encapsulates the properties of an alternate link as defined in the hreflang annotation.
 *
 * <p>
 * The hreflang attribute tells search engines about alternate versions of a page in different languages

    /**
     * Gets the list of alternate links associated with this URL.
     * @return the list of alternate links, or an empty list if none
     */
    public List<SitemapAlternateLink> getAlternateLinks() {
        if (alternateLinks == null) {
            alternateLinks = new ArrayList<>();
        }
        return alternateLinks;
    }

    /**
     * Adds an alternate link to this sitemap URL.

            } else if (XHTML_LINK_ELEMENT.equals(elementName)) {
                // Handle hreflang alternate links
                final String rel = attributes.getValue("rel");
                final String hreflang = attributes.getValue("hreflang");
                final String href = attributes.getValue("href");
                if ("alternate".equals(rel) && hreflang != null && href != null) {

                        + "    <xhtml:link rel=\"alternate\" hreflang=\"en\" href=\"http://www.example.com/en/page.html\" />\n"
                        + "    <xhtml:link rel=\"alternate\" hreflang=\"ja\" href=\"http://www.example.com/ja/page.html\" />\n"
                        + "    <xhtml:link rel=\"alternate\" hreflang=\"x-default\" href=\"http://www.example.com/page.html\" />\n"

/**
 * Helper class for managing related query configurations.
 * This class provides functionality to load, cache, and retrieve related queries
 * based on search terms and virtual hosts. Related queries are used to suggest
 * alternative or supplementary search terms to improve search results.
 */
public class RelatedQueryHelper extends AbstractConfigHelper {
    private static final Logger logger = LogManager.getLogger(RelatedQueryHelper.class);

    /**

*[Fess Site Search](https://github.com/codelibs/fess-site-search)* is a free alternative to [Google Site Search](https://enterprise.google.com/search/products/gss.html). For more details, see the [FSS JS Generator documentation](https://fss-generator.codelibs.org/docs/manual).

## Website

*[Fess Site Search](https://github.com/codelibs/fess-site-search)* ist eine kostenlose Alternative zur [Google Site Search](https://enterprise.google.com/search/products/gss.html). Weitere Details finden Sie in der [Dokumentation des FSS JS Generators](https://fss-generator.codelibs.org/docs/manual).

## Website

     * @return the embedded file, or null if not found
     */
    protected PDEmbeddedFile getEmbeddedFile(final PDComplexFileSpecification fileSpec) {
        // search for the first available alternative of the embedded file
        PDEmbeddedFile embeddedFile = null;
        if (fileSpec != null) {
            embeddedFile = fileSpec.getEmbeddedFileUnicode();
            if (embeddedFile == null) {

*[Fess Site Search](https://github.com/codelibs/fess-site-search)* est une alternative gratuite à [Google Site Search](https://enterprise.google.com/search/products/gss.html). Pour plus de détails, consultez la [documentation FSS JS Generator](https://fss-generator.codelibs.org/docs/manual).

## Site Web

2. **Update client applications** to use Fess's JSON Search API (see [API Reference](#api-reference) section)
3. **Gradually migrate** from GSA query format to Fess's native API

**Alternative Approach**: Instead of relying on GSA API compatibility, we recommend migrating client applications to use Fess's modern JSON API (`/api/v1/documents`), which provides more features and better performance.

---