信号机制 Signal

Django 提供一个“信号分发器”,允许解耦的应用在框架的其它地方发生操作时会被通知到。简单来说,信号允许若干 sender(寄件人)通知一组 receiver(接收者)某些操作已经发生。这在多处代码和同一事件有关联的情况下很有用。
Django 提供一组内建信号,允许用户的代码获得 Django 特定操作的通知。这包含一些有用的通知:

  • django.db.models.signals.pre_save
    django.db.models.signals.post_save
    在模型 save() 方法调用之前或之后发送。

  • django.db.models.signals.pre_delete
    django.db.models.signals.post_delete
    在模型 delete() 方法或查询集的 delete() 方法调用之前或之后发送。

  • django.db.models.signals.m2m_changed
    模型上的 ManyToManyField 修改时发送。

  • django.core.signals.request_started
    django.core.signals.request_finished
    Django 建立或关闭 HTTP 请求时发送。

自定义信号

class Signal([providing_args=list])​

所有信号都是 django.dispatch.Signal 的实例。providing_args 是一个参数名称列表,实际上这些参数并没有多大用处。
例如:

from django.dispatch import Signal

pizza_done = Signal(providing_args=["toppings", "size"])

这段代码声明了 pizza_done 信号,它向接受者提供 toppings 和 size 参数。

Receiver 函数

receiver 相当于一个回调函数,相关事件发生了就会触发它被执行。

def my_callback(sender, **kwargs):
    print "Request finished!"

注意:函数接受一个 sender 参数,以及通配符关键字参数(**kwargs);所有信号处理器都必须接受这些参数。

可是每次取值都得从 kwargs 中取,看起来可读性也变差了。个人用法是函数中经常会用到的参数直接列出来,比如:

def my_callback(sender, instance, created, **kwargs):
    pass

接下来,要做的就是绑定 receiver 到 signal,有两种方法可以将一个接收器连接到信号。

  • 手动连接:
from django.core.signals import request_finished

request_finished.connect(my_callback)
  • 使用 receiver 装饰器来自动连接:
receiver(signal)
    Parameters: signal – A signal or a list of signals to connect a function to.​
from django.core.signals import request_finished
from django.dispatch import receiver

@receiver(request_finished)
def my_callback(sender, **kwargs):
    print "Request finished!"

现在,我们的 my_callback 函数会在每次请求结束时调用。
当你这么设置好了后,就会收到各种 signals 发来的通知。可是,如果我的回调函数只对特定 sender 感兴趣的话怎么办呢?可以通过指定 connect 函数的 sender 参数来过滤:

Signal.connect(receiver[, sender=None, weak=True, dispatch_uid=None])
    Parameters: 
        receiver – 和这个信号连接的回调函数
        sender – 指定一个特定的 sender,来从它那里接受信号
        weak – Django 通常以弱引用储存信号处理器。这就是说,如果你的 receiver 是个局部变量,可能会被垃圾回收。当你调用信号的 connect()方法时,传递 weak=False 来防止这样做
        dispatch_uid – 一个信号 receiver 的唯一标识符,以防信号多次发送,通常是一个字符串​ 

使用装饰器方式过滤:

from django.db.models.signals import pre_save
from django.dispatch import receiver
from myapp.models import MyModel


@receiver(pre_save, sender=MyModel)
def my_handler(sender, **kwargs):
    ... 

my_handler 函数只在 MyModel 实例保存时被调用。

发送信号

Django 中有两种方法用于发送信号:

Signal.send(sender, **kwargs)

Signal.send_robust(sender, **kwargs)

调用 Signal.send() 或者 Signal.send_robust() 来发送信号。你必须提供 sender 参数(大多数情况下它是一个类),并且可以提供尽可能多的关键字参数。

例如,这样来发送我们的 pizza_done 信号:

class PizzaStore(object):
    ...

    def send_pizza(self, toppings, size):
        pizza_done.send(sender=self.__class__, toppings=toppings, size=size)
        ...

send() 和 send_robust() 都会返回一个含有二元组的列表 [(receiver, response), ...
],它代表了被调用的接收器函数和他们的响应值。

send() 与 send_robust() 在处理 receiver 函数产生的异常时有所不同。send() 不会捕获任何由 receiver 产生的异常。它会简单地让错误往上传递。所以在错误产生的情况,不是所有 receiver 都会获得通知。

send_robust() 捕获所有继承自 Python Exception 类的异常,并且确保所有 receiver 都能得到信号的通知。如果发生错误,错误实例会在产生错误的 receiver 的二元组中返回。

断开信号

Signal.disconnect([receiver=None, sender=None, weak=True, dispatch_uid=None])

调用 Signal.disconnect() 来断开信号的接收器。 Signal.connect() 中描述了所有参数。如果接收器成功断开,返回 True ,否则返回 False。

receiver 参数表示要断开的已注册 receiver。如果使用 dispatch_uid 标识 receiver,它可以为 None。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,530评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 86,403评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,120评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,770评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,758评论 5 367
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,649评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,021评论 3 398
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,675评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,931评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,659评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,751评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,410评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,004评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,969评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,203评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,042评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,493评论 2 343

推荐阅读更多精彩内容