python fastapi Query

在Python的FastAPI框架中，`Query`是一个装饰器，用于处理请求查询字符串参数。当你在路由定义中使用`Query`，它允许你在URL中动态地传递参数，并提供了一些便利的功能，比如类型提示、默认值、限制长度等。例如：

from fastapi import FastAPI, Query

app = FastAPI()

@app.get("/items/")
async def read_items(q: str = Query(..., min_length=3, max_length=50, description="搜索关键字", example="apple")):
    # 这里的q参数就是从查询字符串获取的，如果没有传值，默认会取None，如果传了则会校验长度
    return {"items": [item async for item in get_items_by_keyword(q)]}

在这个例子中，`q`参数可以接受一个字符串，长度介于3到50字符之间，用户可以在访问`/items/?q=your_search_term`时传递这个参数。`description`和`example`可用于文档生成，方便开发者了解其用途。