一、子依赖
在依赖注入系统中可以构建任意深度的依赖关系,FastAPI会负责进行解析。而一个依赖项依赖于另一个依赖项,那么另一个依赖项就被称为子依赖。比如:
from typing import Optional from fastapi import Cookie, Depends, FastAPI app = FastAPI() def query_extractor(q: Optional[str] = None): return q def query_or_cookie_extractor( q: str = Depends(query_extractor), last_query: Optional[str] = Cookie(None) ): if not q: return last_query return q @app.get("/items/") async def read_query(query_or_default: str = Depends(query_or_cookie_extractor)): return {"q_or_cookie": query_or_default}
- read_query路径操作函数的依赖项是query_or_cookie_extractor
- query_or_cookie_extractor依赖项又依赖于query_extractor依赖项
- query_extractor就是query_or_cookie_extractor的子依赖
当请求过来时,路径操作函数调用query_or_cookie_extractor依赖项,并且将参数传递给这个依赖项;在这个依赖项函数执行中又调用query_extractor依赖项,并且将参数进行传递。当自已来执行完毕后返回值被依赖项声明的参数进行接收,依赖项执行完毕返回值被路径操作函数声明的参数进行接收。
二、子依赖缓存
如果你的依赖项在同一个路径操作中被声明了多次,比如,多个依赖项有一个子依赖项,FastAPI在每一次请求中只会调用一次子依赖项。然后会将子依赖项的返回值保存在内存中,以此传递给需要它的依赖项。而不是同一个请求子依赖项被调用多次。
不过,在一些高级场景中,如果你需要依赖项在每一步都要执行,而不是去使用缓存,此时可以设置参数use_cache=False来进行更改。
... async def needy_dependency(fresh_value: str = Depends(get_value, use_cache=False)) return {"fresh_value": fresh_value} ...
此时,get_value子依赖每次都会执行,而不会去取其缓存的值。