FastAPI(6)- 详解 Query
可选参数
上一篇文章讲过查询参数可以不是必传的,可以是可选参数
from fastapi import FastAPI from typing import Optional import uvicorn app = FastAPI() # 必传参数+可选参数 @app.get("/items") async def read_item(item_id: str, name: Optional[str] = None): return {"item_id": item_id, "name": name} if __name__ == "__main__": uvicorn.run(app="4_get_valiation:app", host="127.0.0.1", port=8080, debug=True, reload=True)
postman 请求结果
可选其实也是一种校验
Query
为了对查询参数进行额外的校验,可以导入 Query 库
Query 支持多种校验
可选参数有默认值+长度最大为 10
# 需要先导入 Query 库 from fastapi import Query @app.get("/itmes/") async def read_items(name: Optional[str] = Query(default=None, max_length=10)): results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]} if name: results.update({"name": name}) return results
不传 name 的请求结果
传了 name,校验成功的请求结果
name 长度大于 10,校验失败的请求结果
友好的错误提示啊!!直接说清楚哪个字段长度不满足了...
name: Optional[str] = Query(None) 等价于
name: Optional[str] = None
Optional 的作用
为了让 IDE 更好的支持智能提示
一个参数多个校验
# 多条校验 @app.get("/items/twice") async def read_items(name: Optional[str] = Query(default=None, min_length=3, max_length=10)): return {"name": name}
校验成功的请求结果
name 长度小于 3,校验失败的请求结果
添加正则表达式校验
# 正则表达式 @app.get("/items/regular") async def read_items( name: Optional[str] = Query( default=None, min_length=3, max_length=10, regex="^小.*菠萝$" )): return {"name": name}
校验成功的请求结果
name 不满足正则,校验失败的请求结果
查看 Swagger API 文档
正则表达式教程
https://www.cnblogs.com/poloyy/category/1796055.html
必传参数+长度最小为 3
不使用 Query 时,查询参数怎么必传?
不指定默认值就行
name: str
当使用 Query 时,查询参数怎么必传?
Query 默认值参数 default 是必传的,传了默认值不就变成可选参数了吗,那怎么办呢?
# 必传参数 @app.get("/items/require") async def read_items(name: Optional[str] = Query(default=..., max_length=10)): return {"name": name}
只需要将 ... 赋值给 default 参数,FastAPI 就会知道这个参数是必传的
校验成功的请求结果
没有传必传参数,校验失败的请求结果
因为是必传参数,不传则报错!
查看 Swagger API 文档
大大的 required 标识!代表必传哦!
List 类型的查询参数
使用 Query 时,可以指定查询参数的类型为 List,即一个参数可以接收多个值
from typing import List # List[str] @app.get("/list") async def read_item(address: Optional[List[str]] = Query([], max_length=2)): return {"address": address}
没有传参的请求结果
取 address 默认值 []
正确传参的请求结果
设置了校验 max_length=2,但传了三个 address 也正常,证明这个 max_length 的校验对数组长度并不生效
校验失败的请求结果
看来 max_length 校验仍然会对数组里面的字符串生效!
查看 Swagger API 文档
List 类型的查询参数有多个默认值
@app.get("/list/default") async def read_item(address: Optional[List[str]] = Query(["广州", "深圳"])): return {"address": address}
不传参的请求结果
元数据
Query 可以添加元数据相关信息,这些信息将包含在生成的 OpenAPI 中,并由文档用户界面和外部工具使用
四种元数据参数
# 别名 alias: Optional[str] = None # 标题 title: Optional[str] = None # 描述 description: Optional[str] = None # 是否弃用 deprecated: Optional[bool] = None
实际代码
# 元数据 @app.get("/items/all") async def read_items( name: Optional[str] = Query( default=None, min_length=2, max_length=50, regex="^菠萝$", alias="name_alias_query", title="标题", description="很长很长的描述", deprecated=True, ) ): return {"name": name}
不使用 alias 进行传参的请求结果
当做不存在的查询参数处理
用 alias 进行传参的请求结果
定义了 alias,记得要用 alias 进行传参
查看 Swagger API 文档
- title 字段并不会显示在这里,只会显示在 JSON Schema 中
- 而 JSON Schema 只有请求参数方式为 Request Body 才会显示,这里是查询参数,所以并没有 JSON Schema 这一说;后面的文章会详细介绍
总结
限定于字符串的校验:
- min_length
- max_length
- regex
Path
除了可以给查询参数添加额外的校验,也可以给路径参数添加额外的校验
Path 的具体教程:https://www.cnblogs.com/poloyy/p/15308131.html