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

作者：麦克煎蛋   出处：https://www.cnblogs.com/mazhiyong/ 转载请保留这段声明，谢谢！

我们可以创建有子依赖项的依赖项，具体依赖深度不受限制。

FastAPI会处理好依赖项之间的关系。

我们先声明第一个依赖项函数：

def query_extractor(q11: str, q12: str):
    return q11 + q12

然后声明第二个依赖项函数：

def query_or_cookie_extractor(q2: str = Depends(query_extractor), last_query: str = Cookie(None)):
    if not q2:
        return last_query
    return q2

在第二个依赖项函数中，同时又声明了它对第一个依赖项函数的依赖。

完整示例：

from fastapi import Cookie, Depends, FastAPI

app = FastAPI()


def query_extractor(q11: str, q12: str):
    return q11 + q12


def query_or_cookie_extractor(q2: str = Depends(query_extractor), last_query: str = Cookie(None)):
    if not q2:
        return last_query
    return q2


@app.get("/items/")
async def read_query(query_or_default: str = Depends(query_or_cookie_extractor)):
return {"q_or_cookie": query_or_default}

我们在路径操作函数中，仅声明了一个依赖项query_or_cookie_extractor。

但FastAPI知道它必须首先解决第一个依赖项query_extractor，然后把结果传递给第二个依赖项。

通过可交互式文档，我们可以直观的看到实际路径参数：

通过可交互式文档我们可以及时进行文档查看以及代码调试。

依赖项的多次调用

如果某个依赖项在同一个路径操作中被声明了多次，例如，多个依赖项都有一个共同的子依赖项，那么FastAPI默认在每一次请求中只会调用这个依赖项一次。

FastAPI会把这个依赖项的返回值缓存起来，然后把这个值传递给需要的依赖项，而不是在同一个请求中多次调用这个依赖项。

在有些场景下，我们并不需要缓存这个依赖项的返回值，而是需要多次调用，那么我们可以使用参数use_cache=False来禁止依赖项的缓存。

async def needy_dependency(fresh_value: str = Depends(get_value, use_cache=False)):
return {"fresh_value": fresh_value}