/**
 * Interface representing a client for a web crawler.
 * This client is responsible for executing requests and handling responses.
 * It extends {@link AutoCloseable} to allow for resource management.
 */
public interface CrawlerClient extends AutoCloseable {

    /**
     * Sets the initialization parameters for the crawler client.
     *
     * @param params a map containing the initialization parameters
     */

     * @param client The CrawlerClient instance.
     */
    @Override
    public void addClient(final String regex, final CrawlerClient client) {
        factory.addClient(regex, client);
    }

    /**
     * Adds a client to the wrapped factory at a specific position.
     * @param regex The regular expression for the client.
     * @param client The CrawlerClient instance.

     */
    public CrawlerClient getClient(final String urlKey) {
        if (StringUtil.isBlank(urlKey)) {
            return null;
        }

        for (final Map.Entry<Pattern, CrawlerClient> entry : clientMap.entrySet()) {
            final Matcher matcher = entry.getKey().matcher(urlKey);
            if (matcher.matches()) {
                return entry.getValue();
            }

    }

    /**
     * Closes the underlying CrawlerClient and releases any resources associated with it.
     *
     * @throws Exception if an error occurs during the close operation
     */
    @Override
    public void close() throws Exception {
        client.close();
    }

    /**
     * Returns the underlying CrawlerClient.
     * @return The CrawlerClient instance.
     */

    /** Value for HC5 client selection. */
    public static final String HC5_CLIENT = "hc5";

    /** The HC4 HTTP client instance. */
    protected CrawlerClient hc4Client;

    /** The HC5 HTTP client instance. */
    protected CrawlerClient hc5Client;

    /** Flag indicating which client is selected (true = hc5, false = hc4). */
    private boolean useHc5 = true;

    /**

import jakarta.annotation.Resource;

/**
 * Abstract base class for CrawlerClient implementations.
 * Provides common functionality for handling initialization parameters,
 * content length checks, and default method implementations.
 * It defines the basic structure and configuration options for crawler clients.
 */
public abstract class AbstractCrawlerClient implements CrawlerClient {

        if (logger.isDebugEnabled()) {
            logger.debug("loading {}", componentName);
        }
        try (CrawlerClient client = crawlerContainer.getComponent(componentName)) {
            crawlerClientFactory.addClient(regex, client);
        } catch (final Exception e) {
            if (logger.isDebugEnabled()) {

└── fess-crawler-opensearch/   # OpenSearch backend
```

### Key Design Patterns

- **Factory**: `CrawlerClientFactory`, `ExtractorFactory` - protocol/format-specific component selection
- **Strategy**: `CrawlerClient`, `Extractor`, `Transformer` - pluggable implementations
- **Builder**: `RequestDataBuilder`, `ExtractorBuilder` - fluent construction
- **Template Method**: `AbstractCrawlerClient`, `AbstractExtractor` - common logic with overrides