FastAPI依赖注入系统系列(三) 子依赖

一、子依赖

在依赖注入系统中可以构建任意深度的依赖关系，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子依赖每次都会执行，而不会去取其缓存的值。