import javax.xml.xpath.XPathFactory;
import javax.xml.xpath.XPathNodes;

import org.codelibs.fess.crawler.exception.CrawlerSystemException;
import org.w3c.dom.Node;

/**
 * The XPathAPI class provides methods to evaluate XPath expressions and select nodes or node lists from an XML document.
 * It uses the javax.xml.xpath.XPath and javax.xml.xpath.XPathFactory classes to create and evaluate XPath expressions.
 *

import org.opensearch.common.unit.TimeValue;
import org.opensearch.index.query.QueryBuilder;
import org.opensearch.transport.client.Client;

/**
 * SuggestIndexWriter is an implementation of the SuggestWriter interface that provides methods to write, delete,
 * and delete by query suggest items in an OpenSearch index.
 */
public class SuggestIndexWriter implements SuggestWriter {
    /**
     * Constructs a new {@link SuggestIndexWriter}.
     */

 * This exception indicates a failure or error that occurred while extracting content from a crawled resource.
 * It extends {@link org.codelibs.fess.crawler.exception.CrawlerSystemException} and provides constructors
 * to handle different scenarios such as wrapping another exception or providing a specific error message.
 */
public class ExtractException extends CrawlerSystemException {

import org.apache.http.auth.AuthScope;
import org.apache.http.auth.Credentials;
import org.codelibs.fess.crawler.client.http.Authentication;

/**
 * Implementation of the {@link Authentication} interface.
 * This class provides methods to handle authentication details such as
 * authentication scope, credentials, and authentication scheme.
 *
 * <p>
 * It includes constructors to initialize these details and getter and setter

      origin of the Work and reproducing the content of the NOTICE file.

   7. Disclaimer of Warranty. Unless required by applicable law or
      agreed to in writing, Licensor provides the Work (and each
      Contributor provides its Contributions) on an "AS IS" BASIS,
      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
      implied, including, without limitation, any warranties or conditions

 * 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.
 *
 * <p>This class provides the following functionalities:</p>
 * <ul>
 *   <li>Normalization of a string containing Hankaku Kana to Zenkaku Kana.</li>
 *   <li>Conversion of individual Hankaku Kana characters to Zenkaku Kana characters.</li>

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>

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

/**
 * Configuration class for OpenSearch crawler settings.
 * This class provides configuration for index names, shards, and replicas
 * for the queue, data, and filter indices used by the crawler.
 */
public class OpenSearchCrawlerConfig {
    /**
     * Constructs a new OpenSearchCrawlerConfig.

 * This wrapper allows for parameter management and initialization before delegating to the wrapped factory.
 *
 * The wrapper maintains its own parameter map which can be initialized separately from the wrapped factory,
 * and provides access to the wrapped factory instance through getParent().
 *
 * All crawler client management operations (adding, getting clients, setting client map) are delegated
 * to the wrapped factory instance.
 *

import org.xml.sax.Attributes;
import org.xml.sax.InputSource;
import org.xml.sax.helpers.DefaultHandler;

/**
 * Utility class for XML-related operations.
 *
 * This class provides methods to escape special characters in XML strings,
 * strip invalid XML characters, and parse XML content into a map of data.
 *
 * <p>
 * The class is final and cannot be instantiated.
 * </p>
 *