API

信号

flask.signals_available

当信号系统可用时为 True ，即在 blinker 已经被安装的情况下。

flask.template_rendered

当一个模板成功渲染的时候，这个信号会发出。这个信号带着一个模板实例 template 和为一个字典的上下文（叫 context ）两个参数被调用。

flask.request_started

这个信号在处建立请求上下文之外的任何请求处理开始前发送。因为请求上下文 这个信号在任何对请求的处理前发送，但是正好是在请求的上下文被建立的时候。 因为请求上下文已经被约束了，用户可以使用 request 之类的标 准全局代理访问请求对象。

flask.request_finished

这个信号恰好在请求发送给客户端之前发送。它传递名为 response 的将被发送 的响应。

flask.got_request_exception

这个信号在请求处理中抛出异常时发送。它在标准异常处理生效 之前 ，甚至是 在不会处理异常的调试模式下也是如此。这个异常会被将作为一个 exception 传递到用户那。

flask.request_tearing_down

这个信号在请求销毁时发送。它总会被调用，即使发生异常。在这种清况下，造 成teardown的异常将会通过一个叫 exc 的关键字参数传递出来。

在 0.9 版更改: 添加了 exc 参数

flask.appcontext_tearing_down

这个信号在应用上下文销毁时发送。它总会被调用，即使发生异常。在这种清况 下，造成teardown的异常将会通过一个叫 exc 的关键字参数传递出来。发送 者是application对象。

flask.appcontext_pushed

当应用上下文被压入栈后会发送这个信号。发送者是application对象

0.10 新版功能.

flask.appcontext_popped

当应用上下文出栈后会发送这个信号。发送者是application对象。这常常与 appcontext_tearing_down 这个信号一致。

0.10 新版功能.

flask.message_flashed

This signal is sent when the application is flashing a message. The messages is sent as message keyword argument and the 当闪现一个消息时会发送这个信号。消息的内容将以 message 关键字参数 发送，而消息的种类则是 category 关键字参数。

0.10 新版功能.

classflask.signals.Namespace

blinker.base.Namespace 的别名，如果 blinker 可用的话。否则， 是一个发送伪信号的伪造的类。这个类对想提供与 Flask 相同的备用系统的 Flask扩展有用。

signal(name, doc=None)

在此命名空间中创建一个新信号，如果 blinker 可用的话。否则返回一个 带有不做任何事的发送方法，任何操作都会（包括连接）报错为 RuntimeError 的伪信号。