/**
 * Builds OpenSearch queries for suggestion requests.
 *
 * <p>This class encapsulates the query building logic extracted from SuggestRequest,
 * including reading conversion, normalization, and function score query construction.</p>
 */
public class SuggestQueryBuilder {

    private final ReadingConverter readingConverter;
    private final Normalizer normalizer;

import org.codelibs.fess.mylasta.direction.FessConfig;
import org.codelibs.fess.util.ComponentUtil;
import org.lastaflute.web.util.LaRequestUtil;
import org.lastaflute.web.validation.theme.conversion.ValidateTypeFailure;

import jakarta.validation.constraints.Size;

/**
 * Base search form class that extends SearchRequestParams.
 * Provides form fields and methods for handling search requests in the web interface.

└── Update Alias: {baseIndex}.update   (write operations)
```

### Text Processing Pipeline

```
Input Text
    ↓
[Normalization] - NormalizerChain
    ↓
[Reading Conversion] - ReadingConverterChain
    ↓
[Analysis] - SuggestAnalyzer
```

Note: Suggester has TWO ReadingConverter instances:
- `readingConverter` - For query/metadata fields

        // Query was processed successfully
    }

    @Test
    public void test_convertWildcardQuery_caseInsensitive() throws Exception {
        // Test lowercase conversion with wildcard enabled (default)
        QueryContext queryContext1 = new QueryContext("TEST*", false);
        WildcardQuery wildcardQuery1 = new WildcardQuery(new Term("title", "TEST*"));

    }
}
```

/// note | Nota

Ten en cuenta que aunque el `item` se declaró de la misma manera que antes, ahora se espera que esté dentro del cuerpo con una clave `item`.

///

**FastAPI** hará la conversión automática del request, de modo que el parámetro `item` reciba su contenido específico y lo mismo para `user`.

///

## Преобразование типа параметра запроса { #query-parameter-type-conversion }

Вы также можете объявлять параметры с типом `bool`, которые будут преобразованы соответственно:

{* ../../docs_src/query_params/tutorial003_py310.py hl[7] *}

В этом случае, если вы сделаете запрос:

```

    // ============================================================
    // Conversion Rules
    // ============================================================

    /** Common conversion rule for entity fields. */
    public static final String[] COMMON_CONVERSION_RULE = { "crudMode", "createdBy", "createdTime", "updatedBy", "updatedTime" };

    /** Common API conversion rule for CRUD operations. */

            assertTrue(result.length > 0, "Result should not be empty");

            // Verify round-trip conversion
            String roundTrip = new String(result, StandardCharsets.UTF_16LE);
            assertEquals(UNICODE_STRING, roundTrip, "Round-trip conversion should preserve Unicode");
        }

        @Test
        @DisplayName("getASCIIBytes should encode string as ASCII")

   * @throws IllegalArgumentException if the number of actual and formal parameters differ; if an
   *     unwrapping conversion for primitive arguments fails; or if, after possible unwrapping, a
   *     parameter value cannot be converted to the corresponding formal parameter type by a method
   *     invocation conversion.
   * @throws InvocationTargetException if the underlying method or constructor throws an exception.
   */

            DirectoryChangeType changeType = convertAction(action);
            
            // Notify lease manager
            leaseManager.handleDirectoryChange(handle.directoryPath, fileName, changeType);
            
            if (nextEntryOffset == 0) break;
            offset += nextEntryOffset;
        }
    }
    
    private DirectoryChangeType convertAction(int action) {
        switch (action) {