FastAPI 学习之路（十）请求体的字段

系列文章：

　　FastAPI 学习之路（一）fastapi--高性能web开发框架

　　FastAPI 学习之路（二）

　　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类实例化，然后校验。

 

 FieldInfo其实是继承了父类Representation，然后实现了对应的方法。

 

 

 那么我们在来看下boby，    Query、Path 方法，

 body，是一个方法，他是params的Query方法，

 

 我们在往下看，发下，params的body类。

 

 而Body的父类就是FieldInfo。和我们上面的Field一样，只不过Field是直接使用的FieldInfo，body只是上面两层做 了简单的封装，其实都是FieldInfo。

 

 我们看下query

 

  然后看到这里可能就发现下面就是一个Query类，

 

  它是集成了Param类，Param类才是集成了FieldInfo类。

 

 我们看下path

 

 它也是params里面的Path类，

 

  然后Param继承了FieldInfo方法。

 

 

其实他们的共同的父类就是Representation。

    从上面的代码一顿跳转，我们就能看出来，他们最后的根都是Representation，只是上面的boby，    Query、Path方法的父类都是直接或者间接的继承FieldInfo，而Field就是FieldInfo的实例化，FieldInfo继承了Representation，它们本质上就是Representation类的子类。所以他们几个的使用方法，和使用参数没有太大的区别。

 

        请记住当你从 fastapi 导入 Query、Path 等对象时，他们实际上是返回特殊类的函数。

        你可以在 Field、Query、Body 中声明额外的信息。这些信息将包含在生成的 JSON Schema 中。

文章首发在公众号，欢迎关注。