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

/**
 * The HankakuKanaToZenkakuKana class implements the Normalizer interface to convert
 * half-width Katakana characters (Hankaku Kana) to full-width Katakana characters (Zenkaku Kana).
 * It also handles the conversion of voiced and semi-voiced sound marks.
 *

 * to the wrapped factory instance.
 *
 * This class implements the decorator pattern to extend CrawlerClientFactory functionality while
 * maintaining the same interface.
 *
 */
public class CrawlerClientFactoryWrapper extends CrawlerClientFactory {
    /**
     * The underlying CrawlerClientFactory instance to which operations are delegated.
     */

import org.codelibs.fess.crawler.filter.UrlFilter;
import org.codelibs.fess.crawler.service.UrlFilterService;

import jakarta.annotation.Resource;

/**
 * Implementation of the {@link UrlFilter} interface.
 * This class provides functionality to filter URLs based on include and exclude patterns.
 * It uses a {@link UrlFilterService} to manage the URL filtering rules.

 * including adding URLs to the queue, filtering URLs, managing crawler threads,
 * and handling the overall crawling lifecycle.
 *
 * <p>It implements the Runnable interface to be executed in a separate thread,
 * and the AutoCloseable interface to ensure resources are properly released after use.
 *
 * <p>The crawler uses several services and components, such as UrlQueueService, DataService,

 *
 * <p>
 * This class encapsulates the properties of a URL as defined in the sitemap XML format,
 * including its location, last modification date, change frequency, and priority.
 * It implements the {@link Sitemap} interface.
 * </p>
 *
 * <p>
 * The {@code SitemapUrl} class provides getter and setter methods for each of these properties,
 * as well as implementations for {@code equals()}, {@code hashCode()}, and {@code toString()} methods.

import org.opensearch.transport.client.Client;

/**
 * <p>
 * {@link ESSourceReader} reads documents from Elasticsearch using the scroll API.
 * It implements the {@link DocumentReader} interface to provide a way to iterate over documents
 * in a large index without loading all of them into memory at once.
 * </p>
 *
 * <p>

import java.util.Map;

import com.ibm.icu.text.Transliterator;

/**
 * Converts Katakana characters to their corresponding Alphabet representations.
 *
 * <p>
 * This class implements the {@link ReadingConverter} interface and provides a method to convert a given
 * Katakana string into a list of possible Alphabet readings. It uses a predefined mapping of Katakana

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

import org.codelibs.core.beans.util.BeanUtil;
import org.codelibs.fess.crawler.Constants;

/**
 * Implementation of the {@link AccessResult} interface.
 *
 * @param <IDTYPE> the type of the identifier for the access result
 */
public class AccessResultImpl<IDTYPE> implements AccessResult<IDTYPE> {

    /**
     * Creates a new instance of AccessResultImpl.

import org.codelibs.fess.crawler.service.DataService;
import org.codelibs.fess.crawler.util.AccessResultCallback;

import jakarta.annotation.Resource;

/**
 * Implementation of the {@link DataService} interface for managing access result data.
 * This class provides methods to store, retrieve, update, and delete access results,
 * as well as to iterate over them. It uses a {@link MemoryDataHelper} to store the data in memory.
 *
 * <p>

import org.codelibs.fess.crawler.exception.CrawlingAccessException;
import org.codelibs.fess.crawler.helper.LogHelper;
import org.codelibs.fess.crawler.log.LogType;

/**
 * Implementation of the {@link LogHelper} interface.
 * This class provides methods for logging various events during the crawling process.
 * It uses Log4j2 for logging.
 *
 * <p>
 * The class contains methods for logging different types of events, such as:
 * </p>