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;

/**
 * The list form for Search List.
 */
public class ListForm extends SearchRequestParams {

    /**
     * Default constructor.

@GwtCompatible
final class NullnessCasts {
  /**
   * Accepts a {@code @Nullable T} and returns a plain {@code T}, without performing any check that
   * that conversion is safe.
   *
   * <p>This method is intended to help with usages of type parameters that have {@linkplain
   * ParametricNullness parametric nullness}. If a type parameter instead ranges over only non-null

`Query`, `Path`, `Header` 그리고 다른 것들을 `fastapi`에서 임포트 할 때, 이들은 실제로 특별한 클래스를 반환하는 함수임을 기억하세요.

///

/// info | 정보

헤더를 선언하기 위해서 `Header`를 사용해야 합니다. 그렇지 않으면 해당 매개변수를 쿼리 매개변수로 해석하기 때문입니다.

///

## 자동 변환 { #automatic-conversion }

`Header`는 `Path`, `Query` 그리고 `Cookie`가 제공하는 것 외에 기능이 조금 더 있습니다.

대부분의 표준 헤더는 "마이너스 기호" (`-`)라고도 하는 "하이픈" 문자로 구분됩니다.

그러나 파이썬에서 `user-agent`와 같은 형태의 변수는 유효하지 않습니다.

Також зверніть увагу, що **FastAPI** достатньо розумний, щоб визначити, що параметр шляху `item_id` є параметром шляху, а `q` — ні, отже, це параметр query.

///

## Перетворення типу параметра query { #query-parameter-type-conversion }

Ви також можете оголошувати параметри типу `bool`, і вони будуть автоматично конвертовані:

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

У цьому випадку, якщо ви перейдете за:

```

在這種情況下，函式參數 `q` 為選用，且預設為 `None`。

/// check | 注意

另外請注意，FastAPI 能辨識出路徑參數 `item_id` 是路徑參數，而 `q` 不是，因此 `q` 會被當作查詢參數。

///

## 查詢參數型別轉換 { #query-parameter-type-conversion }

你也可以宣告 `bool` 型別，值會被自動轉換：

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

在這種情況下，如果你造訪：

```
http://127.0.0.1:8000/items/foo?short=1
```

或

```

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.

    }
}
```

/// 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] *}

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

```

        // 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*"));

    // ============================================================
    // 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. */