// Null-safety: return null for blank templates
        // Early return is safe here as no resources have been allocated yet
        if (StringUtil.isBlank(template)) {
            if (logger.isDebugEnabled()) {
                logger.debug("Template is blank, returning null");
            }
            return null;
        }

        // Null-safety: use empty map if paramMap is null

import java.util.Map;

/**
 * {@link HashMap} with an upper limit on the number of entries. When a new entry is added, the oldest entry is discarded using LRU if the limit is exceeded.
 * <p>
 * <strong>Thread-Safety:</strong> This class is <strong>NOT thread-safe</strong>.
 * It extends {@link LinkedHashMap} without synchronization. If multiple threads access
 * an instance concurrently, and at least one thread modifies the map structurally,

import org.dbflute.utflute.core.PlainTestCase;

/**
 * Test class for {@link Handler} and its inner class {@link Handler.GcsURLConnection}.
 * This test covers URL parsing, connection state management, and thread-safety.
 */
public class HandlerTest extends PlainTestCase {
    @Override
    protected void setUp() throws Exception {
        super.setUp();
        new StandardCrawlerContainer();
    }

    /**

 *   <li>{@link DataService} - The service for managing access results.</li>
 * </ul>
 *
 * <p>Each parameter is stored in a ThreadLocal variable to ensure thread safety.</p>
 *
 * <p>Usage example:</p>
 * <pre>
 * {@code
 * UrlQueue<?> urlQueue = CrawlingParameterUtil.getUrlQueue();
 * CrawlingParameterUtil.setUrlQueue(newUrlQueue);
 *

| Packages | lowercase | `org.codelibs.fess.suggest` |

### JavaDoc Requirements

All public classes and methods require JavaDoc with `@param`, `@return`, and `@throws` tags.

### Best Practices

**Null Safety:**
```java
public Suggester(final Client client, final SuggestSettings settings) {
    this.client = Objects.requireNonNull(client, "client must not be null");

**Template Method**: `AbstractCrawlerClient`, `AbstractExtractor` - common logic with overrides
**DI**: LastaFlute container with `@Resource` and XML config

### Core Principles

**Thread Safety**:
- `AtomicLong` for counters (`CrawlerContext.accessCount`)
- `volatile` for status flags
- Synchronized blocks for critical sections
- Thread-local storage via `CrawlingParameterUtil`

**Resource Management**:

labels.roomNumber=Room Number
labels.user_description=Description
labels.description=Description
labels.user_title=Title
labels.title=Title
labels.user_pager=Pager
labels.pager=Pager
labels.user_street=Street
labels.street=Street
labels.user_postalCode=Postal Code
labels.postalCode=Postal Code
labels.user_physicalDeliveryOfficeName=Office
labels.physicalDeliveryOfficeName=Office
labels.user_destinationIndicator=Destination Indicator

import org.dbflute.utflute.core.PlainTestCase;

/**
 * Test class for {@link Handler} and its inner class {@link Handler.StorageURLConnection}.
 * This test covers URL parsing, connection state management, and thread-safety.
 */
public class HandlerTest extends PlainTestCase {
    @Override
    protected void setUp() throws Exception {
        super.setUp();
        new StandardCrawlerContainer();
    }

    /**

                    }
                    return exitValue;
                }
            } else {
                // This is a secondary timeout, a safety net.
                logger.warn("{} is unresponsive and could not be terminated within the safety timeout.", getName());
                if (!task.isExecuted()) {
                    task.run();
                }
            }

        assertFalse(CharUtil.isUrlChar('`')); // backtick (just before 'a')
        assertFalse(CharUtil.isUrlChar('{')); // left brace (just after 'z')
        assertFalse(CharUtil.isUrlChar('^')); // caret (before 'a' range)
        assertFalse(CharUtil.isUrlChar('|')); // pipe (not in valid set)
    }