@SuppressWarnings("unchecked")
        final Map<String, StateData> states = (Map<String, StateData>) session.getAttribute(STATES);
        if (states != null) {
            final long now = ComponentUtil.getSystemHelper().getCurrentTimeAsLong();
            states.entrySet()
                    .stream()

        assertNotNull(authors);
        assertEquals("John Doe", authors[0]);

        final String[] dates = extractData.getValues("frontmatter.date");
        assertNotNull(dates);
        assertEquals("2025-01-15", dates[0]);
    }

    public void test_headingExtraction() {
        final InputStream in = ResourceUtil.getResourceAsStream("extractor/markdown/test.md");

    public void test_noOpBehavior() {
        // Verify that NullResponseProcessor truly does nothing
        NullResponseProcessor processor = new NullResponseProcessor();

        // Create ResponseData in various states
        ResponseData data1 = null;
        ResponseData data2 = new ResponseData();
        ResponseData data3 = new ResponseData();
        data3.setUrl("https://example.com");
        data3.setHttpStatusCode(404);

- Use behavior classes to access OpenSearch

### Helpers
- Cross-cutting utilities in `helper.*`
- Stateless, injected via DI
- Access via `ComponentUtil.getFooHelper()`

## Development Notes

- **Code Style**: Enforced by `mvn formatter:format`
- **License Headers**: Required (Apache 2.0) - use `mvn license:format`
- **Logging**: Log4j2 - `src/main/resources/log4j2.xml`

/**
 * FessIntervalController extends DefaultIntervalController to provide
 * Fess-specific interval control functionality for web crawling operations.
 * This controller manages delays and timing for various crawling states
 * including processing delays, queue waiting times, and new URL discovery.
 */
public class FessIntervalController extends DefaultIntervalController {

```java
suggester.suggest()
    .setQuery("search")
    .execute()
    .done(response -> { /* handle success */ })
    .error(throwable -> { /* handle error */ });
```

---

## Important Notes

### Thread Safety
- **Suggester**: Thread-safe for queries
- **SuggestIndexer**: Thread-safe for indexing
- **SuggestSettings**: NOT thread-safe for modifications

### Performance

- `mapping.txt` - Character/token mappings

**Example directory structure:**
```
dictionary/
└── sv/
    ├── stopwords.txt
    ├── stemmer_override.txt
    └── protwords.txt
```

## Important Notes

### No Database Changes Required

- Language configuration is entirely file-based
- No database or OpenSearch index updates needed
- Settings are loaded at application startup and cached

 * </p>
 * <ul>
 *   <li>Starting and finishing threads</li>
 *   <li>Starting and cleaning up crawling</li>
 *   <li>Handling unsupported URLs</li>
 *   <li>Checking last modified dates</li>
 *   <li>Getting content</li>
 *   <li>Handling redirects</li>
 *   <li>Processing responses</li>
 *   <li>Handling exceptions during crawling and child URL processing</li>

				"application/vnd.3gpp.pic-bw-var",
				"application/vnd.3gpp.sms",
				"application/vnd.3gpp2.bcmcsinfo+xml",
				"application/vnd.3gpp2.sms",
				"application/vnd.3gpp2.tcap",
				"application/vnd.3m.post-it-notes",
				"application/vnd.accpac.simply.aso",
				"application/vnd.accpac.simply.imp",
				"application/vnd.acucobol",
				"application/vnd.acucorp",
				"application/vnd.adobe.air-application-installer-package+zip",

 * <li>System configuration property keys</li>
 * <li>Default values for crawling and indexing operations</li>
 * <li>User agent strings and patterns for web crawling</li>
 * <li>Status constants for job execution and system states</li>
 * <li>Field names and keys used throughout the application</li>
 * <li>Date/time format patterns</li>
 * <li>Authentication type identifiers</li>
 * <li>Reserved words and regex patterns for query processing</li>