前言
有多个模型,且请求/响应需要声明多个模型的时候,可以根据不同使用场景结合 typing 库里面的 Union、List 来达到目的
Union
作用
联合类型,详细教程
使用 Union 时,建议首先包含具体的类型,然后是不太具体的类型
实际代码
代码语言:javascript复制#!usr/bin/env python
# -*- coding:utf-8 _*-
"""
# author: 小菠萝测试笔记
# blog: https://www.cnblogs.com/poloyy/
# time: 2021/9/22 8:28 上午
# file: 19_extra models.py
"""
import uvicorn
from fastapi import FastAPI
from typing import Optional, Union, List, Dict
from pydantic import BaseModel, EmailStr
app = FastAPI()
class BaseItem(BaseModel):
description: str
type: str
class CarItem(BaseItem):
# 给了个默认值
type = "car"
class PlaneItem(BaseItem):
type = "plane"
size: int
items = {
"item1": {"description": "All my friends drive a low rider", "type": "car"},
"item2": {
"description": "Music is my aeroplane, it's my aeroplane",
"type": "plane",
"size": 5,
},
}
@app.get("/items/{item_id}", response_model=Union[PlaneItem, CarItem])
async def read_item(item_id: str):
# item_id 作为键去 items 中找到对应的值
return items[item_id]
if __name__ == "__main__":
uvicorn.run(app="20_union_list_dict:app", host="127.0.0.1", port=8080, reload=True, debug=True)
item_id = item1 的请求结果
item_id = item2 的请求结果
List
代码语言:javascript复制class Item(BaseModel):
name: str
description: str
items = [
{"name": "Foo", "description": "There comes my hero"},
{"name": "Red", "description": "It's my aeroplane", "size": 123}, # 多了个 size 字段
]
@app.get("/items/", response_model=List[Item])
async def read_items():
return items
正确传参的请求结果
返回的是一个数组
假设响应内容多了个 size
items1 多了个 size 字段,但因为响应模型并不包含 size,所以最终返回的数据也不会包含 size
假设响应内容不包含 description
代码语言:javascript复制 raise ValidationError(errors, field.type_)
pydantic.error_wrappers.ValidationError: 1 validation error for Item
response -> 1 -> description
field required (type=value_error.missing)
- 因为响应模型声明了 name、description 都是必传参数,假设不传就会报错
- 但又因为是响应数据有问题,代表应用程序(服务端)有问题,所以客户端发送请求就会报 500