[TimLinux] Django 信号

Posted TimLinux

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了[TimLinux] Django 信号相关的知识,希望对你有一定的参考价值。

1. 信号定义

django包含有一个“信号分发器”,在框架内任何时候,在任何地方,有动作方式是,用来帮助解耦应用之间获取通知。简言之,信号允许特定的发送者通知一系列接收者动作已经发生了。特别有用的地方在于:许多代码片段对于同样的事件感兴趣。

2. 内建信号

django提供了许多内建的信号,这样用户代码能够在django自身的一些特定动作发生时得到通知。如下:

  • django.db.models.singals.pre_save、django.db.models.signals.post_save:在模型的save()方法被调用之前、之后发送该信号。
  • django.db.models.signals.pre_delete、django.db.models.signals.post_delete:在模型的delete()方法被调用之前、之后发送该信号。
  • django.db.models.signals.m2m_chagned:当一个ManyToManyField模型发送修改是发送该信号。
  • django.core.signals.request_started、django.core.signals.request_finished:在django开始、完成一个HTTP请求时发送该信息。
  • 等等其他信号。

3. 监听信号

为了接收一个信号,使用Signal.connect()方法来注册一个信号接收函数,当信号被发送的时候接收函数将被调用。函数接口如下:

Signal.connect(receiver, sender=None, weak=True, dispatch_uid=None)

参数说明:
receiver: 回调函数,将被连接到对象的信号上。receiver函数有它的实现要求
sender: 指定一个特定的发送者,明确信号从哪里来的。
weak: django存储信号处理器默认作为弱引用。可以通过设置weak=False来修改这一行为。
dispatch_uid: 信号接收者的唯一标识,以免重复信号被发送。

例如:request_finished就是一个Signal对象,下面这行代码完成了信号的监听
request_finished.connect(my_callback)

下面的函数定义,完成了接收函数的定义
def my_callback(sender, **kwargs):
print("Request finished!")

 3.1. 接收函数

接收函数可以是任意Python函数或方法:接收一个sender位置参数,一个通配的kwargs关键字参数,所有信号处理器必须接收这些参数。所有的信号发生kwargs参数,并且可能在任一时间改变这些关键字参数。根据request_finished信号文档说明,它不会发送任何参数,看似上面的回调函数也可能不传递关键字参数,但是这样的操作是错误的,如果你真的这样做,django会抛出一个错误的。

3.2. 连接接收函数

两种方式可以将一个接收者连接到信号上去。

# 1. 手动连接
from django.core.signals import request_finished

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


# 2. 使用 receiver 装饰器连接
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函数会在每次完成完成一次请求之后被调用。

3.3. 连接信号:指定发送者

指定发送者的目的是缩小事件的监听范围,比如pre_save()信号,多数情况下只是想知道某一个特定的模型上发生的这一信号,而不是所有的模型。这时候就可以指定你所关心的sender,比如sender=User,那么只有当User模型在pre_save信号发送时,才调用receiver函数。不同的信号,能够接收的sender参数是值不同,需要根据信号文档描述进行设置,不能乱猜哦!

from django.core.signals import pre_save
from django.dispatch import receiver
from myapp.models import User

@receiver(pre_save, sender=User)
def my_handler(sender, **kwargs):
    print("pre_save happen in User.")

3.4. 阻止重复信号

 









以上是关于[TimLinux] Django 信号的主要内容,如果未能解决你的问题,请参考以下文章

[TimLinux] Python Django与WSGI的简介

[TimLinux] JavaScript AJAX接收到的数据转换为JSON格式

[TimLinux] Python 装饰器

[TimLinux] Python nonlocal和global的作用

[TimLinux] Python 函数

[TimLinux] JavaScript 代码控制滚动条移动到顶部/底部