Python Web框架Flask信号机制(signals)介绍


Posted in Python onJanuary 01, 2015

信号(signals)

Flask信号(signals, or event hooking)允许特定的发送端通知订阅者发生了什么(既然知道发生了什么,那我们可以知道接下来该做什么了)。

Flask提供了一些信号(核心信号)且其它的扩展提供更多的信号。信号是用于通知订阅者,而不应该鼓励订阅者修改数据。相关信号请查阅文档。

信号依赖于Blinker库。

钩子(hooks)

Flask钩子(通常出现在蓝图或应用程序现存的方法中,比如一些内置装饰器,例如before_request)不需要Blinker库并且允许你改变请求对象(request)或者响应对象(response)。这些改变了应用程序(或者蓝图)的行为。比如before_request()装饰器。

信号看起来和钩子做同样的事情。然而在工作方式上它们存在不同。譬如核心的before_request()处理程序以特定的顺序执行,并且可以在返回响应之前放弃请求。相比之下,所有的信号处理器是无序执行的,并且不修改任何数据。

一般来说,钩子用于改变行为(比如,身份验证或错误处理),而信号用于记录事件(比如记录日志)。

创建信号

因为信号依赖于Blinker库,请确保已经安装。

如果你要在自己的应用中使用信号,你可以直接使用Blinker库。最常见的使用情况是命名一个自定义的Namespace的信号。这也是大多数时候推荐的做法:

from blinker import Namespace

my_signals = Namespace()

现在你可以像这样创建新的信号:

model_saved = my_signals.signal('model-saved')

这里使用唯一的信号名并且简化调试。可以用name属性来访问信号名。

对扩展开发者:

如果你正在编写一个Flask扩展,你想优雅地减少缺少Blinker安装的影响,你可以这样做使用flask.signals.Namespace类。

订阅信号

你可以使用信号的connect()方法来订阅信号。第一个参数是信号发出时要调用的函数,第二个参数是可选的,用于确定信号的发送者。一个信号可以拥有多个订阅者。你可以用disconnect()方法来退订信号。

对于所有的核心Flask信号,发送者都是发出信号的应用。当你订阅一个信号,请确保也提供一个发送者,除非你确实想监听全部应用的信号。这在你开发一个扩展的时候尤其正确。

比如这里有一个用于在单元测试中找出哪个模板被渲染和传入模板的变量的助手上下文管理器:

from flask import template_rendered

from contextlib import contextmanager
@contextmanager

def captured_templates(app):

    recorded = []

    def record(sender, template, context, **extra):

        recorded.append((template, context))

    template_rendered.connect(record, app)

    try:

        yield recorded

    finally:

        template_rendered.disconnect(record, app)

现在可以轻松地与测试客户端配对:

with captured_templates(app) as templates:

    rv = app.test_client().get('/')

    assert rv.status_code == 200

    assert len(templates) == 1

    template, context = templates[0]

    assert template.name == 'index.html'

    assert len(context['items']) == 10

确保订阅使用了一个额外的 **extra 参数,这样当 Flask 对信号引入新参数时你的调用不会失败。

代码中,从 with 块的应用 app 中流出的渲染的所有模板现在会被记录到templates 变量。无论何时模板被渲染,模板对象的上下文中添加上它。

此外,也有一个方便的助手方法(connected_to()) ,它允许你临时地用它自己的上下文管理器把函数订阅到信号。因为上下文管理器的返回值不能按那种方法给定,则需要把列表作为参数传入:

from flask import template_rendered
def captured_templates(app, recorded, **extra):

    def record(sender, template, context):

        recorded.append((template, context))

    return template_rendered.connected_to(record, app)

上面的例子看起来像这样:

templates = []

with captured_templates(app, templates, **extra):

    ...

    template, context = templates[0]

发送信号

如果你想要发送信号,你可以通过调用 send() 方法来达到目的。它接受一个发件者作为第一个参数和一些可选的被转发到信号用户的关键字参数:

class Model(object):

    ...
    def save(self):

        model_saved.send(self)

永远尝试选择一个合适的发送者。如果你有一个发出信号的类,把 self 作为发送者。如果你从一个随机的函数发出信号,把current_app._get_current_object()作为发送者。

基于信号订阅的装饰器

在Blinker 1.1中通过使用新的connect_via()装饰器你也能够轻易地订阅信号:

from flask import template_rendered
@template_rendered.connect_via(app)

def when_template_rendered(sender, template, context, **extra):

    print 'Template %s is rendered with %s' % (template.name, context)

举例

模板渲染

template_rendered信号是Flask核心信号。

当一个模版成功地渲染,这个信号会被发送。这个信号与模板实例 template 和上下文的词典(名为 context )一起调用。

信号发送:

def _render(template, context, app):

    """Renders the template and fires the signal"""

    rv = template.render(context)

    template_rendered.send(app, template=template, context=context)

    return rv

订阅示例:
def log_template_renders(sender, template, context, **extra):

    sender.logger.debug('Rendering template "%s" with context %s',

                        template.name or 'string template',

                        context)
from flask import template_rendered

template_rendered.connect(log_template_renders, app)


帐号追踪

user_logged_in是Flask-User中定义的信号,当用户成功登入之后,这个信号会被发送。

发送信号:

# Send user_logged_in signal

user_logged_in.send(current_app._get_current_object(), user=user)

下面这个例子追踪登录次数和登录IP:
# This code has not been tested
from flask import request

from flask_user.signals import user_logged_in
@user_logged_in.connect_via(app)

def _track_logins(sender, user, **extra):

    user.login_count += 1

    user.last_login_ip = request.remote_addr

    db.session.add(user)

    db.session.commit()

小结

信号可以让你在一瞬间安全地订阅它们。例如,这些临时的订阅对测试很有帮助。使用信号时,不要让信号订阅者(接收者)发生异常,因为异常会造成程序中断。

Python 相关文章推荐
使用Python的Flask框架实现视频的流媒体传输
Mar 31 Python
python获取局域网占带宽最大3个ip的方法
Jul 09 Python
利用Python爬取可用的代理IP
Aug 18 Python
解决matplotlib库show()方法不显示图片的问题
May 24 Python
Python二进制串转换为通用字符串的方法
Jul 23 Python
使用pytorch进行图像的顺序读取方法
Jul 27 Python
python中文编码与json中文输出问题详解
Aug 24 Python
Python中的CSV文件使用"with"语句的方式详解
Oct 16 Python
python 多线程重启方法
Feb 18 Python
Django 重写用户模型的实现
Jul 29 Python
Python语言异常处理测试过程解析
Jan 08 Python
Python爬取豆瓣数据实现过程解析
Oct 27 Python
Python模拟登录12306的方法
Dec 30 #Python
python执行shell获取硬件参数写入mysql的方法
Dec 29 #Python
简单的抓取淘宝图片的Python爬虫
Dec 25 #Python
简单使用Python自动生成文章
Dec 25 #Python
Python 抓取动态网页内容方案详解
Dec 25 #Python
利用Psyco提升Python运行速度
Dec 24 #Python
Python解决鸡兔同笼问题的方法
Dec 20 #Python
You might like
如何对PHP程序中的常见漏洞进行攻击
2006/10/09 PHP
PHP 开发者该知道的 5 个 Composer 小技巧
2016/02/03 PHP
IE6下CSS图片缓存问题解决方法
2010/12/09 Javascript
多个表单中如何获得这个文件上传的网址实现js代码
2013/03/25 Javascript
JS控制文本框textarea输入字数限制的方法
2013/06/17 Javascript
jquery判断元素是否隐藏的多种方法
2014/05/06 Javascript
Node.js抓取中文网页乱码问题和解决方法
2015/02/10 Javascript
js简单实现点击左右运动的方法
2015/04/10 Javascript
JavaScript DOM进阶方法
2015/04/13 Javascript
jquery实现带渐变淡入淡出并向右依次展开的多级菜单效果实例
2015/08/22 Javascript
jQuery自定义数值抽奖活动代码
2016/06/11 Javascript
用js实现简单算法的实例代码
2016/09/24 Javascript
微信小程序 实例应用(记账)详解
2016/09/28 Javascript
js按条件生成随机json:randomjson实现方法
2017/04/07 Javascript
ES6新特性五:Set与Map的数据结构实例分析
2017/04/21 Javascript
AngularJS中controller控制器继承的使用方法
2017/11/03 Javascript
vue中mint-ui的使用方法
2018/04/04 Javascript
vue项目中公用footer组件底部位置的适配问题
2018/05/10 Javascript
vue.js使用3DES加密的方法示例
2018/05/18 Javascript
Bootstrap Fileinput 4.4.7文件上传实例详解
2018/07/25 Javascript
vue实现按需加载组件及异步组件功能
2019/05/27 Javascript
js实现三角形粒子运动
2020/09/22 Javascript
Vue中使用JsonView来展示Json树的实例代码
2020/11/16 Javascript
python实现人民币大写转换
2018/06/20 Python
Python3 获取一大段文本之间两个关键字之间的内容方法
2018/10/11 Python
python 数据生成excel导出(xlwt,wlsxwrite)代码实例
2019/08/23 Python
简单瞅瞅Python vars()内置函数的实现
2019/09/27 Python
python中数据库like模糊查询方式
2020/03/02 Python
Sneaker Studio捷克:购买运动鞋
2018/07/08 全球购物
Foot Locker澳洲官网:美国运动服和鞋类零售商
2019/10/11 全球购物
ORLY官网:美国专业美甲一线品牌
2019/12/11 全球购物
文员个人的求职信范文
2013/09/26 职场文书
同学会邀请书大全
2014/01/12 职场文书
环保建议书
2014/03/12 职场文书
MySQL实例精讲单行函数以及字符数学日期流程控制
2021/10/15 MySQL
介绍一下28个JS常用数组方法
2022/05/06 Javascript