应用情境¶

    这与 请求情境 类似,它在请求期间跟踪请求级数据。推送请求情境时会推送相应的应用情境。

    应用对象具有诸如 config 之类的属性,这些属性对于在视图和 中访问很有用。但是,在项目中的模块内导入 app 实例容易导致循环导入问题。当使用应用程序工厂方案 或编写可重用的 或 extensions 时,根本不会有应用程序实例导入。

    Flask 通过 应用情境 解决了这个问题。不是直接引用一个 app ,而是使用
    代理,该代理指向处理当前活动的应用。

    处理请求时, Flask 自动 推送 应用情境。在请求期间运行的视图函数、错误处理器和其他函数将有权访问 current_app

    运行使用 .cli.command() 注册到 Flask.cli 的 CLI 命令时,Flask 还会自动推送应用情境。

    应用情境根据需要创建和销毁。当 Flask 应用开始处理请求时,它会推送应用情境和 。当请求结束时,它会在请求情境中弹出,然后在应用情境中弹出。通常,应用情境将具有与请求相同的生命周期。

    如果您尝试在应用情境之外访问 current_app ,或其他任何使用它的东西,则会看到以下错误消息:

    如果在配置应用时发现错误(例如初始化扩展时),那么可以手动推送上下文。因为你可以直接访问 。在 with 块中使用 ,块中运行的所有内容都可以访问 current_app 。:

    如果您在代码中的其他地方看到与配置应用无关的错误,则很可能表明应该将该代码移到视图函数或 CLI 命令中。

    应用情境是在请求或 CLI 命令期间存储公共数据的好地方。Flask 为此提供了 。它是一个简单的命名空间对象,与应用情境具有相同的生命周期。

    Note

    g 表示“全局”的意思,但是指的是数据在 情境 之中是全局的。 g中的数据在情境结束后丢失,因此它不是在请求之间存储数据的恰当位置。使用session 或数据库跨请求存储数据。

    • teardown_X() 关闭或以其他方式解除分配资源(如果存在)。它被注册为 处理器。
      例如,您可以使用以下方案管理数据库连接:

    在一个请求中,每次调用 get_db() 会返回同一个连接,并且会在请求结束时自动关闭连接。

    你可以使用 LocalProxy 基于 生成一个新的本地情境:

    访问 db 就会内部调用 get_db ,与 的工作方式相同。


    如果你正在编写扩展, g 应该保留给用户。你可以将内部数据存储在情境本身中,但一定要使用足够唯一的名称。当前上下文使用 访问。 欲了解更多信息,请参阅Flask 扩展开发

    当应用情境被弹出时,应用将调用使用 注册的函数。

    如果 signals_available 为真,则发送以下信号: 、 appcontext_tearing_down 和 。