FastAPI 学习之路（二十四）子依赖项

FastAPI支持创建含子依赖项的依赖项。并且，可以按需声明任意深度的子依赖项嵌套层级。

FastAPI负责处理解析不同深度的子依赖项。

我们去实现一个简单的demo

from fastapi import FastAPI, Depends
from typing import Optional

app = FastAPI()

fake_db_items = [{"city": "beijing"}, {"city": "shanghai"}, {"city": "guangzhou"}]

def query_extractor(desc: Optional[str] = None):
    return desc


def extend_query(desc: str = Depends(query_extractor), name: Optional[str] = ""):
    if not desc:
        return name
    return desc


@app.get("/items")
def read_items(query: str = Depends(extend_query)):
   return query


if __name__ == '__main__':
    import uvicorn
    uvicorn.run("main:app", reload=True, debug=True)

我们去看下接口请求

我们可以看到，我们实现的子依赖是成功的。

• 尽管该函数自身是依赖项，但还声明了另一个依赖项（它「依赖」于其他对象）

       该函数依赖 query_extractor, 并把 query_extractor 的返回值赋给参数 desc

• 同时，该函数还声明了类型是 str 的可选name  用户未提供desc 时，则使用name

 多次使用同一个依赖项

• 如果在同一个路径操作 多次声明了同一个依赖项，例如，多个依赖项共用一个子依赖项，FastAPI 在处理同一请求时，只调用一次该子依赖项。
• FastAPI 不会为同一个请求多次调用同一个依赖项，而是把依赖项的返回值进行「缓存」，并把它传递给同一请求中所有需要使用该返回值的「依赖项」。

其实依赖注入系统非常简单。

依赖注入无非是与路径操作函数一样的函数罢了。

但它依然非常强大，能够声明任意嵌套深度的「图」或树状的依赖结构。