FastAPI 提供了简单易用，但功能强大的依赖注入系统。这个依赖系统设计的简单易用，可以让开发人员轻松地把组件集成至 FastAPI。

什么是依赖注入？

    

    声明代码（本文中为路径操作函数 ）运行所需的，或要使用的「依赖」的一种方式。

然后，由系统（本文中为 FastAPI）负责执行任意需要的逻辑，为代码提供这些依赖（注入依赖项）。

依赖注入常用于以下场景：

  • 共享业务逻辑（复用相同的代码逻辑）
  • 共享数据库连接
  • 实现安全、验证、角色权限
  • 等……

上述场景均可以使用依赖注入，将代码重复最小化。

  

接下来，我们学习一个非常简单的例子，尽管它过于简单，不过很实用。



from typing import Optional
from fastapi import Depends, FastAPI
app = FastAPI()
def common_parameters(q: Optional[str] = None,
                            skip: int = 0,
                            limit: int = 100):
    return {"q": q, "skip": skip, "limit": limit}
@app.get("/items/")
def read_items(commons: dict = Depends(common_parameters)):
    return commons
@app.get("/users/")
def read_users(commons: dict = Depends(common_parameters)):
    return commons


我们看下最后的请求

FastAPI 学习之路（二十二）依赖项_默认值

 

 FastAPI 学习之路（二十二）依赖项_赋值_02

 

 

     

    依赖项函数的形式和结构与路径操作函数一样。

因此，可以把依赖项当作没有「装饰器」（即，没有 ​​@app.get("/path")​​ ）的路径操作函数。

依赖项可以返回各种内容。

本例中的依赖项预期接收如下参数：

  • 类型为 str 的可选查询参数 q
  • 类型为 int 的可选查询参数 skip，默认值是 0
  • 类型为 int 的可选查询参数 limit，默认值是 100

然后，依赖项函数返回包含这些值的 ​​dict​​。

 

    

    接收到新的请求时，FastAPI 执行如下操作：

  • 用正确的参数调用依赖项函数（「可依赖项」）
  • 获取函数返回的结果
  • 把函数返回的结果赋值给路径操作函数的参数   

FastAPI 兼容性

依赖注入系统如此简洁的特性，让 FastAPI 可以与下列系统兼容：

  • 关系型数据库
  • NoSQL 数据库
  • 外部支持库
  • 外部 API
  • 认证和鉴权系统
  • API 使用监控系统
  • 响应数据注入系统 

 

 欢迎关注。

FastAPI 学习之路（二十二）依赖项_函数返回_03