}

  /**
   * Test to ensure we don't  throw a read timeout on responses that are progressing.  For this
   * case, we take a 4KiB body and throttle it to 1KiB/second.  We set the read timeout to two
   * seconds.  If our implementation is acting correctly, it will not throw, as it is progressing.
   */
  @Test
  fun readTimeoutMoreGranularThanBodySize() {
    val body = CharArray(4096) // 4KiB to read.

**Technology Stack:**
- Java 21+, Maven
- OpenSearch (provided dependency)
- Apache Lucene (query parsing, text analysis)
- ICU4J (Unicode text processing)
- JUnit 4 (testing)

**Repository:** https://github.com/codelibs/fess-suggest

---

## Architecture

### Package Structure

```
org.codelibs.fess.suggest/

        assertNotNull(result);
        assertTrue(result.contains("3 documents")); // Verify the job executes
    }

    // Test handling of processing exception
    @Test
    public void test_execute_withProcessingException() {
        // Create a mock that returns 0 to simulate processing error
        SearchEngineClient errorClient = new SearchEngineClient() {
            @Override
            public long updateByQuery(String index,

import jakarta.annotation.PostConstruct;

/**
 * Helper class for document processing and manipulation in the Fess search system.
 * This class provides utilities for processing document content, titles, and digests,
 * handling text normalization, content extraction, and similar document hash encoding/decoding.
 * It also manages document processing requests and integrates with the crawler system.
 *
 */
public class DocumentHelper {

├── security/    # Security & MessageDigest utilities
├── sql/         # SQL type utilities
├── stream/      # Stream utilities
├── text/        # Text processing (JSON, Tokenizer)
├── timer/       # Timer utilities
├── xml/         # XML processing
├── zip/         # ZIP file utilities
└── CoreLibConstants.java
src/test/java/   # Test classes (mirrors main structure)
```

## Development Commands

```bash

    @Resource
    protected LabelTypeHelper labelTypeHelper;

    /** Helper for query processing and transformation. */
    @Resource
    protected QueryHelper queryHelper;

    /** Configuration for query field mappings and processing. */
    @Resource
    protected QueryFieldConfig queryFieldConfig;

    /** Helper for role-based query filtering and security. */
    @Resource

 * Centralizes scroll logic to reduce code duplication across settings and indexer classes.
 *
 * <p>This class provides methods to perform scroll-based searches with different processing patterns:
 * <ul>
 * <li>{@link #scrollSearch(Client, SuggestSettings, String, QueryBuilder, int, HitProcessor)} - Collects results into a list</li>

   * processing and may run concurrently, for example, if the JVM flag {@code
   * -XX:+ExplicitGCInvokesConcurrent} is used.
   *
   * <p>Whenever possible, it is preferable to test directly for some observable change resulting
   * from GC, as with {@link #awaitClear}. Because there are no guarantees for the order of GC

import okio.ByteString.Companion.encodeUtf8
import okio.Options

/**
 * A decoded [mapping table] that can perform the [mapping step] of IDNA processing.
 *
 * This implementation is optimized for readability over efficiency.
 *
 * This implements non-transitional processing by preserving deviation characters.
 *
 * This implementation's STD3 rules are configured to `UseSTD3ASCIIRules=false`. This is

   * processing and may run concurrently, for example, if the JVM flag {@code
   * -XX:+ExplicitGCInvokesConcurrent} is used.
   *
   * <p>Whenever possible, it is preferable to test directly for some observable change resulting
   * from GC, as with {@link #awaitClear}. Because there are no guarantees for the order of GC