from typing import Annotated

from fastapi import FastAPI, Query

app = FastAPI()


@app.get("/items/")
async def read_items(
    q: Annotated[
        str | None, Query(min_length=3, max_length=50, pattern="^fixedquery$")
    ] = None,
):
    results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
    if q:
        results.update({"q": q})

            cb.query().setTerm_Wildcard(wrapQuery(keyMatchPager.term));
        }
        if (StringUtil.isNotBlank(keyMatchPager.query)) {
            cb.query().setQuery_Wildcard(wrapQuery(keyMatchPager.query));
        }
        // TODO Long, Integer, String supported only.

        // setup condition
        cb.query().addOrderBy_Term_Asc();

        // search

    }

{* ../../docs_src/request_forms/tutorial001_an_py310.py hl[3] *}

## Definir parámetros de `Form` { #define-form-parameters }

Crea parámetros de formulario de la misma manera que lo harías para `Body` o `Query`:

{* ../../docs_src/request_forms/tutorial001_an_py310.py hl[9] *}

/// note | 技術詳細

`Header`は`Path`や`Query`、`Cookie`の「姉妹」クラスです。また、同じ共通の`Param`クラスを継承しています。

しかし、`fastapi`から`Query`や`Path`、`Header`などをインポートする場合、それらは実際には特殊なクラスを返す関数であることを覚えておいてください。

///

/// info | 情報

ヘッダーを宣言するには、`Header`を使う必要があります。なぜなら、そうしないと、パラメータがクエリのパラメータとして解釈されてしまうからです。

///

## 自動変換 { #automatic-conversion }

`Header`は`Path`や`Query`、`Cookie`が提供する機能に加え、少しだけ追加の機能を持っています。

    //                                                                               Query
    //                                                                               =====
    public BsDuplicateHostCQ query() {
        assertQueryPurpose();
        return doGetConditionQuery();
    }

    protected BsDuplicateHostCQ doGetConditionQuery() {

    //                                                                               Query
    //                                                                               =====
    public BsRelatedQueryCQ query() {
        assertQueryPurpose();
        return doGetConditionQuery();
    }

    protected BsRelatedQueryCQ doGetConditionQuery() {

    /** Query parameter name for main search query. */
    public static final String OPTION_QUERY_Q = "q";

    /** Query parameter name for constraint query. */
    public static final String OPTION_QUERY_CQ = "cq";

    /** Query parameter name for optional query. */
    public static final String OPTION_QUERY_OQ = "oq";

    /** Query parameter name for negative query. */

from typing import Annotated, Literal

from fastapi import FastAPI, Query
from pydantic import BaseModel, Field

app = FastAPI()


class FilterParams(BaseModel):
    model_config = {"extra": "forbid"}

    limit: int = Field(100, gt=0, le=100)
    offset: int = Field(0, ge=0)
    order_by: Literal["created_at", "updated_at"] = "created_at"
    tags: list[str] = []


@app.get("/items/")

    // ===================================================================================
    //                                                                               Query
    //                                                                               =====
    public BsWebConfigCQ query() {
        assertQueryPurpose();
        return doGetConditionQuery();
    }

    protected BsWebConfigCQ doGetConditionQuery() {

     */
    public SearchForm() {
    }

    /**
     * The search term field for key match configuration.
     */
    public String term;

    /**
     * The query field for key match configuration.
     */
    public String query;