FastAPI-Body、Field

参考：模式的额外信息 - 例子 - FastAPI

在FastAPI中，Body和Field是两个常用的注解，它们用于定义请求体中的数据或路径参数、查询参数等的处理方式。这两个注解都来自于Pydantic库，用于数据验证和解析，但它们的应用场景有所不同。

Body

Body是一个注解，用来指示FastAPI从HTTP请求的主体（即请求体）中读取数据，并根据提供的模型或类型进行解析和验证。当期望客户端通过POST、PUT等方法发送JSON对象或其他格式的数据时，就会用到Body。它常与Pydantic的模型类一起使用来定义请求体的结构。

Field

Field是Pydantic模型类中用于定义模型字段属性的一个方法。它允许你为模型的字段添加额外的元数据，比如默认值、标题、描述等。Field通常不直接用于FastAPI的路由定义中，而是用于定义Pydantic模型的结构，这些模型随后可能作为Body、查询参数、路径参数等使用。

举例：

from typing import List, Set, Union, Optional
import uvicorn
from fastapi import FastAPI, Body
from pydantic import BaseModel, HttpUrl, Field
from typing_extensions import Annotated# 初始化FastAPI应用程序
app = FastAPI()# 定义Item模型，表示商品项的属性
class Item(BaseModel):name: strdescription: Union[str, None] = Noneprice: floattax: Union[float, None] = None# 定义Item_1模型，与Item类似，但提供了更详细的字段示例
class Item_1(BaseModel):name: str = Field(examples=["Foo"])description: Union[str, None] = Field(default=None, examples=["A very nice Item"])price: float = Field(examples=[35.4])tax: Union[float, None] = Field(default=None, examples=[3.2])# 更新物品信息的API端点
# 接收一个item_id参数和一个Item实例作为请求体
@app.put("/items/{item_id}")
async def update_item(item_id: int, item: Item):results = {"item_id": item_id, "item": item}return results# 另一个更新物品信息的API端点，使用了更详细的Annotated注解来指定请求体的期望格式
@app.put("/items_1/{item_id}")
async def update_item(item_id: int,item: Annotated[Item_1,Body(examples=[{"name": "Foo","description": "A very nice Item","price": 35.4,"tax": 3.2,}],),],
):results = {"item_id": item_id, "item": item}return results# 主函数，用于启动FastAPI应用程序
# 注释中提供了两种运行模式：线上模式和调试模式
# 主函数，用于启动FastAPI应用程序
if __name__ == "__main__":## 线上模式# uvicorn.run("abr_server:app", host="0.0.0.0", port = 1218)## debug 模式uvicorn.run("test4:app", host="0.0.0.0", port=1218, reload=True, )