子依赖
- 就是嵌套依赖，和嵌套 Pydantic Model 差不多意思
- 可以根据需求创建多层嵌套的依赖关系
比如上图，E 依赖 C、D，C、D 又依赖 B，B 又依赖 A.....
两层依赖的栗子
第一层依赖
from typing import Optional
# 1、第一层依赖
def query_extractor(q: Optional[str] = None):
return q
就是个普通函数，接收一个 q 参数，类型 str，直接返回 q
第二层依赖
from fastapi import Cookie, Depends, FastAPI
from typing import Optional
# 1、第一层依赖
def query_extractor(q: Optional[str] = None):
return q
# 2、第二层依赖
def query_or_cookie_extractor(
# 声明依赖项
q: str = Depends(query_extractor),
# 另外一个参数，接收 Cookie
last_query: Optional[str] = Cookie(None)
):
if not q:
return last_query
return q
- 参数 q 依赖于 query_extractor，并将 query_extractor 的返回值赋值给 q
- 如果没有传 q，则返回 last_query，模拟返回上一次的查询结果
- 如果有传 q，则直接返回 q
路径操作函数声明依赖项
#!usr/bin/env python
# -*- coding:utf-8 _*-
"""
# author: 小菠萝测试笔记
# blog: https://www.cnblogs.com/poloyy/
# time: 2021/9/25 10:26 上午
# file: 27_sub_depend.py
"""
from typing import Optional
import uvicorn
from fastapi import Cookie, Depends, FastAPI
app = FastAPI()
# 1、第一层依赖
def query_extractor(q: Optional[str] = None):
return q
# 2、第二层依赖
def query_or_cookie_extractor(
# 声明依赖项
qq: str = Depends(query_extractor),
# 另外一个参数，接收 Cookie
last_query: Optional[str] = Cookie(None)
):
if not qq:
return last_query
return qq
@app.get("/items/")
async def read_query(
# 3、声明依赖项
query_or_default: str = Depends(query_or_cookie_extractor)
):
return {"q_or_cookie": query_or_default}
if __name__ == "__main__":
uvicorn.run(app="27_sub_depend:app", host="127.0.0.1", port=8080, reload=True, debug=True)
FastAPI 的执行顺序图
先执行第一层依赖，然后第二层，最后才会执行路径操作函数
查看 Swagger API 文档
正确传参的请求结果
user_cache 的作用
- 默认是 true，表示使用缓存
- 当同一个依赖项被多次调用时，FastAPI 知道每个请求只会调用该依赖项一次
- 它会将返回值保存在缓存中，并将其传给需要它的所有地方，而不会重复调用该依赖项多次
- 当然，如果不想使用缓存的话，可以将 user_cache 设置为 False
async def needy_dependency(fresh_value: str = Depends(get_value, use_cache=False)):
return {"fresh_value": fresh_value}
多个路径操作函数声明同一个依赖项
