系列文章:
FastAPI 学习之路(一)fastapi--高性能web开发框架
FastAPI 学习之路(二)
FastAPI 学习之路(三)
FastAPI 学习之路(四)
FastAPI 学习之路(五)
FastAPI 学习之路(七)字符串的校验
FastAPI 学习之路(八)路径参数和数值的校验
FastAPI 学习之路(九)请求体有多个参数如何处理?
与使用 Query、Path 和 Body 在路径操作函数中声明额外的校验和元数据的方式相同,你可以使用 Pydantic 的 Field 在 Pydantic 模型内部声明校验和元数据。我们看一个简单的例子。
from typing import Optional from fastapi import Body, FastAPI from pydantic import BaseModel, Field app = FastAPI() class Item(BaseModel): name: str description: Optional[str] = Field( None, title="这是描述", max_length=300 ) price: float = Field(..., gt=0, description="价格必须大于0") tax: Optional[float] = None @app.put("/items/{itemid}") async def update_items(itemid: int, item: Item = Body(..., embed=True)): results = {"itemid": itemid, "item": item} return results
这里还是举的一个物品的价格,还打折的例子,我们对于描述和price用了Field,我们看下效果。我们用postman请求下。问可以看到item还是一个参数组
那么我们看下我们代码中条件,假如,我们现在的价格小于0.
我们可以看到,接口正常给我们返回了不应该小于0。我们可以看下接口文档
Field 的工作方式和 Query、Path 和 Body 相同,包括它们的参数等等也完全相同。
我们可以看下Field的源码。它里面是FieldInfo类实例化,然后校验。
那么我们在来看下boby, Query、Path 方法,
body,是一个方法,他是params的Query方法
我们在往下看,发下,params的body类。