the copyright owner that is granting the License.

      "Legal Entity" shall mean the union of the acting entity and all
      other entities that control, are controlled by, or are under common
      control with that entity. For the purposes of this definition,
      "control" means (i) the power, direct or indirect, to cause the
      direction or management of such entity, whether by contract or

        assertNotNull(tokens);
        assertEquals(2, tokens.size());
        assertEquals("test", tokens.get(0).getTerm());
        assertEquals("text", tokens.get(1).getTerm());
        // Check that readings are added
        assertEquals("TEST", ((TestAnalyzeToken) tokens.get(0)).getReading());
        assertEquals("TEXT", ((TestAnalyzeToken) tokens.get(1)).getReading());
    }

    @Test

      the copyright owner that is granting the License.

      "Legal Entity" shall mean the union of the acting entity and all
      other entities that control, are controlled by, or are under common
      control with that entity. For the purposes of this definition,
      "control" means (i) the power, direct or indirect, to cause the
      direction or management of such entity, whether by contract or

    public void setInitialBufferSize(final int initialBufferSize) {
        this.initialBufferSize = initialBufferSize;
    }

    /**
     * Sets whether duplicated terms are replaced.
     * @param replaceDuplication If true, duplicated terms are replaced.
     */
    public void setReplaceDuplication(final boolean replaceDuplication) {
        this.replaceDuplication = replaceDuplication;
    }

    /**

         * - ISO control characters and space characters are treated as spaces.
         * - Alphanumeric characters (0-9, A-Z, a-z) are appended to the buffer.
         * - Symbol characters (!-/, :-@, [-`, {-~) are appended to the buffer.
         * - Duplicate terms can be removed based on the `duplicateTermRemoved` flag.

        hashCodes.add(CrawlerStatus.RUNNING.hashCode());
        hashCodes.add(CrawlerStatus.DONE.hashCode());

        // While not guaranteed, typically enum hashCodes are different
        assertTrue(hashCodes.size() > 1);
    }

    /**
     * Test compareTo method
     */
    public void test_compareTo() {
        // Compare with self

 * using URLs with the "storage" protocol.
 *
 * <p>
 * The URL format is expected to be: {@code storage://bucketName/objectName}.
 * The bucket name and object name are extracted from the URL.
 * </p>
 *
 * <p>
 * The handler relies on environment variables for configuration:
 * </p>
 * <ul>
 *   <li>{@code STORAGE_ENDPOINT}: The endpoint URL of the MinIO service.</li>

 * and handling the overall crawling lifecycle.
 *
 * <p>It implements the Runnable interface to be executed in a separate thread,
 * and the AutoCloseable interface to ensure resources are properly released after use.
 *
 * <p>The crawler uses several services and components, such as UrlQueueService, DataService,
 * UrlFilter, RuleManager, CrawlerContainer, IntervalController, and CrawlerClientFactory,

# Run with verbose output
mvn surefire:test -Dmaven.surefire.debug=true
```

### Running Tests with Coverage

```bash
mvn clean jacoco:prepare-agent test jacoco:report
```

Coverage reports are generated in `target/site/jacoco/`.

## Common Use Cases

### E-commerce Search

```java
// Product search suggestions
SuggestItem product = new SuggestItem(

        assertArrayEquals(new String[] { "reading1" }, itemReadings[0]);
    }

    @Test
    public void testToSuggestItemWithNullTagsAndRoles() {
        // Test toSuggestItem when tags and roles are null (converted to empty lists)
        String word = "null tags and roles";
        float boost = 1.0f;
        List<String> readings = Arrays.asList("reading1");
        List<String> fields = Arrays.asList("field1");