import org.codelibs.fess.util.ComponentUtil;
import org.junit.jupiter.api.Test;
import org.opensearch.index.query.MatchPhraseQueryBuilder;
import org.opensearch.index.query.PrefixQueryBuilder;
import org.opensearch.index.query.QueryBuilder;
import org.opensearch.index.query.TermQueryBuilder;
import org.opensearch.index.query.WildcardQueryBuilder;
import org.opensearch.search.sort.SortBuilder;

from fastapi import FastAPI, Query

app = FastAPI()


@app.get("/items/")
async def read_items(
    q: str | None = Query(
        default=None,
        alias="item-query",
        title="Query string",
        description="Query string for the items to search in the database that have a good match",
        min_length=3,
        max_length=50,
        pattern="^fixedquery$",
        deprecated=True,
    ),
):

        // Default constructor
    }

    /**
     * Wraps a query string with wildcard characters to enable partial matching.
     * This method ensures that the query string is surrounded by asterisks (*)
     * to support prefix and suffix matching in search operations.
     *
     * @param query the query string to wrap with wildcards
     * @return the wrapped query string with leading and trailing asterisks
     */

import org.opensearch.index.query.MoreLikeThisQueryBuilder;
import org.opensearch.index.query.PrefixQueryBuilder;
import org.opensearch.index.query.QueryBuilder;
import org.opensearch.index.query.QueryBuilders;
import org.opensearch.index.query.QueryStringQueryBuilder;
import org.opensearch.index.query.RangeQueryBuilder;
import org.opensearch.index.query.RegexpQueryBuilder;
import org.opensearch.index.query.SpanTermQueryBuilder;

     * Creates a search intent result with a Fess query.
     *
     * @param query the Fess query string
     * @param reasoning the detection reasoning
     * @return the search intent result
     */
    public static IntentDetectionResult search(final String query, final String reasoning) {
        return new IntentDetectionResult(ChatIntent.SEARCH, query, null, reasoning);
    }

    /**

        assertTrue(str.contains("query"));
        assertTrue(str.contains(query));
    }

    @Test
    public void test_query_complexFessSyntax() {
        final String query = "title:\"security policy\"^2 OR (+security +policy (guide OR document))";
        final IntentDetectionResult result = IntentDetectionResult.search(query, "complex query");

        assertEquals(query, result.getQuery());
    }

    @Test

{* ../../docs_src/path_params_numeric_validations/tutorial006_an_py310.py hl[13] *}

## Резюме { #recap }

С помощью `Query`, `Path` (и других классов, которые мы пока не затронули) вы можете добавлять метаданные и строковую валидацию тем же способом, как и в главе [Query-параметры и валидация строк](query-params-str-validations.md).

А также вы можете добавить валидацию числовых данных:

* `gt`: больше (`g`reater `t`han)

/// note | Teknik Detaylar

`Cookie`, `Path` ve `Query`'nin "kardeş" sınıfıdır. O da aynı ortak `Param` sınıfından miras alır.

Ancak `fastapi`'dan `Query`, `Path`, `Cookie` ve diğerlerini import ettiğinizde, bunlar aslında özel sınıflar döndüren fonksiyonlardır, bunu unutmayın.

///

/// info | Bilgi

Cookie'leri tanımlamak için `Cookie` kullanmanız gerekir, aksi halde parametreler query parametreleri olarak yorumlanır.

///

Ardından `Field`'ı model attribute'larıyla birlikte kullanabilirsiniz:

{* ../../docs_src/body_fields/tutorial001_an_py310.py hl[11:14] *}

`Field`, `Query`, `Path` ve `Body` ile aynı şekilde çalışır; aynı parametrelerin tamamına sahiptir, vb.

/// note | Teknik Detaylar

但請記得，當你從 `fastapi` 匯入 `Query`、`Path`、`Header` 等時，它們其實是會回傳特殊類別的函式。

///

/// info | 說明

要宣告標頭，必須使用 `Header`，否則參數會被解讀為查詢參數。

///

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

在 `Path`、`Query`、`Cookie` 提供的功能之上，`Header` 還有一些額外的小功能。

大多數標準標頭的單字以連字號（減號，`-`）分隔。

但像 `user-agent` 這樣的變數名稱在 Python 中是無效的。

因此，`Header` 會在預設情況下把參數名稱中的底線（`_`）轉換為連字號（`-`），以便讀取並在文件中顯示該標頭。