23：django 信号（signal）

柔光的暖阳◎ 2023-06-04 05:51 10阅读 0赞

django包含了一个“信号分配器”使得当一些动作在框架的其他地方发生的时候，解耦的应用可以得到提醒。通俗来讲，就是一些动作发生的时候，信号允许特定的发送者去提醒一些接受者，这是特别有用的设计因为有些代码对某些事件是特别感兴趣的，比如删除动作。

为此，django提供了很多内置的信号，比如一些常用的功能（以几个在django.db.models.signal目录下的信号为例）：

*  save：pre\_save和post\_save
 *  delete：pre\_delete和post\_delete
 *  change：m2m\_changed

如果你想了解更多，可以查阅django的内置信号文档，本节的最后也会有一个所有内置信号的简略介绍。

# 监听信号 #

要想接受信号，你首先要注册一个接收器函数，当信号被Signal.connect()方法发射的时候，这个函数会被调用

Signal.connect(receiver\[,sender=None,weak=True,dispatch\_uid=None\])

参数解释：

*  receiver：连接到这个信号的回调函数
 *  sender：信号的发送者
 *  weak：是否是弱引用，默认是真。因此，如果你的接收器是是一个本地函数，会被当做垃圾回收，如果你不想，请在使用connect()方法的时候使用weak=False
 *  dispatch\_uid：一个唯一的标识符给信号接收器，避免重复的信号被发送

下面让我们来看一个具体的例子来解释这些参数吧吧，这个例子以request\_finished信号（每个HTTP请求结束的时候会被调用）：

### 回调函数receiver ###

回调函数可以是一个函数或者方法，比如我们可以这样定义一个接收器：

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

注意的是所有的信号处理器都需要这两个参数：sender和\*\*kwargs。因为所有的信号都是发送关键字参数的，可能你处理的时候没有任何参数，但不意味着在处理的过程中（在你写的处理函数之前）有任何的参数生成，如果没有传\*\*kwargs参数的话，可能会发生问题；基于这样的考虑，这两个参数都是必须的。

### 连接到你的receiver回调函数 ###

有两种方法可以把信号和接收器连接到一起：

connect方法

from django.core.signals import request_finished
    
    request_finished.connect(my_callback)

装饰器方法

from django.core.signals import request_finished
    from django.dispatch import receiver
    
    @receiver(request_finished)
    def my_callback(sender, **kwargs):
        print "Request finished!"

这样配置之后，每次HTTP接受的时候都会调用这个接收器回调函数了

### 绑定特定的发送者 ###

记上面之后，你会不会想到这样的一个问题：每次都调用，会不会很烦啊？如果是我的话，我肯定觉得很烦，毕竟我不是想接受所有人的信号的，所以你需要设置sender关键字参数

第二个知识：每一类的信号都对应着特定的发送者，所以要绑定发送者也得绑定对应的发送者类型，例如，request\_finished对应的是handler class，而pre\_save对应则是model class

下面我们以pre-save为例子绑定特定的发送者（模型）：

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):

### 预防重复的信号 ###

使用dispatch\_uid关键字参数

request_finished.connect(my_callback, dispatch_uid="my_unique_identifier")

说完了如何监听一个信号，下面我们继续讲解定义和发送信号吧】

## 定义信号 ##

class Signal(\[providing\_args=list\])

所有的信号都是django.dispatch.Signal的实例，参数providing\_args是一个信号提供给监听器的参数名的列表，比如：

import django.dispatch
    
    pizza_done = django.dispatch.Signal(providing_args=["toppings", "size"])

这段代码定义了一个pizza\_done的信号，参数有toppings和size

## 发送信号 ##

有两个方法发送信号

Signal.send(sender,\*\*kwargs)

Signal.send\_robust(sender,\*\*kwargs)

sender参数是必须的，关键字参数可选

class PizzaStore(object):
        ...
    
        def send_pizza(self, toppings, size):
            pizza_done.send(sender=self, toppings=toppings, size=size)

这两种方法都返回一个元组对\[(receiver,respose),...\]的列表，一个代表被调用的receiver回调函数和他们的response的列表

这两种方法的区别在于send不会捕捉任何的异常，（放任错误的传播），而send\_robust则是捕捉所有的异常，并确保每个接收器都知道这个信号（发生错误了）（如果发生错误的话，错误实体和发生错误的接收器作为一个元组对一起返回给那个列表

## 断开信号 ##

Signal.disconnect(\[receiver=None,sender=None,weak=True,dispatch\_uid=None）

和监听信号类似

receiver参数用来指明那个接收器被断开，如果使用了dispatch\_uid的话，receiver可以为None

**总结，你可以使用django自带的信号，也可以自定义自己的信号，信号可以connect，可以send也可以disconnect等等**

转载于:https://www.cnblogs.com/qwj-sysu/p/4224805.html