Django信号

一 信号简介

Django提供一种信号机制。其实就是观察者模式，又叫发布-订阅(Publish/Subscribe) 。当发生一些动作的时候，发出信号，然后监听了这个信号的函数就会执行。

通俗来讲，就是一些动作发生的时候，信号允许特定的发送者去提醒一些接受者。用于在框架执行操作时解耦。

二 Django内置信号

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 请求时发送。

三 内置信号的使用

对于Django内置的信号，仅需注册指定信号，当程序执行相应操作时，自动触发注册函数：

方式1:

    from django.core.signals import request_finished
    from django.core.signals import request_started
    from django.core.signals import got_request_exception
    from django.db.models.signals import class_prepared
    from django.db.models.signals import pre_init, post_init
    from django.db.models.signals import pre_save, post_save
    from django.db.models.signals import pre_delete, post_delete
    from django.db.models.signals import m2m_changed
    from django.db.models.signals import pre_migrate, post_migrate
    from django.test.signals import setting_changed
    from django.test.signals import template_rendered
    from django.db.backends.signals import connection_created

方式一：

#放到__init__里
from django.db.models.signals import pre_save
import logging
def callBack(sender, **kwargs):
    print(sender)
    print(kwargs)
    # 创建对象写日志
    logging.basicConfig(level=logging.DEBUG)
    # logging.error('%s创建了一个%s对象'%(sender._meta.db_table,kwargs.get('instance').title))
    logging.debug('%s创建了一个%s对象'%(sender._meta.model_name,kwargs.get('instance').title))

pre_save.connect(callBack)

方式二：

from django.db.models.signals import pre_save
from django.dispatch import receiver
@receiver(pre_save)
def my_callback(sender, **kwargs):
    print("对象创建成功")
    print(sender)
    print(kwargs)

四 自定义信号

a. 定义信号（一般创建一个py文件）（toppings，size 是接受的参数）

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

b. 注册信号

def callback(sender, **kwargs):
    print("callback")
    print(sender,kwargs)
  
pizza_done.connect(callback)

c. 触发信号

from 路径 import pizza_done
  
pizza_done.send(sender='seven',toppings=123, size=456)

由于内置信号的触发者已经集成到Django中，所以其会自动调用，而对于自定义信号则需要开发者在任意位置触发。 

Django信号

Django中提供了“信号调度”，用于在框架执行操作时解耦。通俗来讲，就是一些动作发生的时候，信号允许特定的发送者去提醒一些接受者。

一、Django内置信号

Model signals
    pre_init                    # django的model执行其构造方法前，自动触发
    post_init                   # django的model执行其构造方法后，自动触发
    pre_save                    # django的model对象保存前，自动触发
    post_save                   # django的model对象保存后，自动触发
    pre_delete                  # django的model对象删除前，自动触发
    post_delete                 # django的model对象删除后，自动触发
    m2m_changed                 # django的model中使用m2m字段操作第三张表（add,remove,clear）前后，自动触发
    class_prepared              # 程序启动时，检测已注册的app中modal类，对于每一个类，自动触发
Management signals
    pre_migrate                 # 执行migrate命令前，自动触发
    post_migrate                # 执行migrate命令后，自动触发
Request/response signals
    request_started             # 请求到来前，自动触发
    request_finished            # 请求结束后，自动触发
    got_request_exception       # 请求异常后，自动触发
Test signals
    setting_changed             # 使用test测试修改配置文件时，自动触发
    template_rendered           # 使用test测试渲染模板时，自动触发
Database Wrappers
    connection_created          # 创建数据库连接时，自动触发

对于Django内置的信号，仅需注册指定信号，当程序执行相应操作时，自动触发注册函数：

注册信号，写入与project同名的文件夹下的_init_.py文件中，也是换数据库引擎的地方。

#与project同名的文件夹下的_init_.py文件中，也是换数据库引擎的地方。

from django.core.signals import request_finished
from django.core.signals import request_started
from django.core.signals import got_request_exception

from django.db.models.signals import class_prepared
from django.db.models.signals import pre_init, post_init
from django.db.models.signals import pre_save, post_save
from django.db.models.signals import pre_delete, post_delete
from django.db.models.signals import m2m_changed
from django.db.models.signals import pre_migrate, post_migrate

from django.test.signals import setting_changed
from django.test.signals import template_rendered

from django.db.backends.signals import connection_created


def callback(sender, **kwargs):
    print("xxxx_callback")
    print(sender, kwargs)


xxxx.connect(callback)
# xxxx指上述导入的内容

# post_save   django的model对象保存后，自动触发
# post_save.connect(callback) 也就是说django的model对象保存后，自动触发callback

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

# 方法一：
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!")

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

二、自定义信号

1. 定义信号

在某py文件(此处为mysignal.py)中定义信号，一般就项目根目录。

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

2. 注册信号

注册信号，写入与project同名的文件夹下的_init_.py文件中注册信号，也是换数据库引擎的地方。

def callback(sender, **kwargs):
    print("callback")
    print(sender, kwargs)

def callback2(sender, **kwargs):
    print("callback")
    print(sender, kwargs)

from mysignal import pizza_done

pizza_done.connect(callback)
#pizza_done.connect(callback2) # 可以指定多个

3. 触发信号(视图函数中)

#views.py
from mysignal import pizza_done   ###导入
pizza_done.send(sender='seven', toppings=123, size=456)

def index(request):
    article_list = models.Article.objects.all()
    #pizza_done.send(sender='seven', toppings=123, size=456)    ###使用
    return render(request, "index.html", {"article_list": article_list})

由于内置信号的触发者已经集成到Django中，所以其会自动调用，而对于自定义信号则需要开发者在任意位置触发。

更多：猛击这里

序列化

关于Django中的序列化主要应用在将数据库中检索的数据返回给客户端用户，特别的Ajax请求一般返回的为Json格式。

1、serializers

from django.core import serializers
ret = models.BookType.objects.all()
data = serializers.serialize("json", ret)

2、json.dumps

import json
 
#ret = models.BookType.objects.all().values('caption')
ret = models.BookType.objects.all().values_list('caption')
 
ret=list(ret)
result = json.dumps(ret)

由于json.dumps时无法处理datetime日期，所以可以通过自定义处理器来做扩展，如：

import json 
from datetime import date 
from datetime import datetime 
   
class JsonCustomEncoder(json.JSONEncoder): 
    
    def default(self, field): 
     
        if isinstance(field, datetime): 
            return o.strftime('%Y-%m-%d %H:%M:%S') 
        elif isinstance(field, date): 
            return o.strftime('%Y-%m-%d') 
        else: 
            return json.JSONEncoder.default(self, field) 
   
   
# ds = json.dumps(d, cls=JsonCustomEncoder) 

信号补充

Django 提供一个“信号分发器”，允许解耦的应用在框架的其它地方发生操作时会被通知到。 简单来说，信号允许特定的sender通知一组receiver某些操作已经发生。 这在多处代码和同一事件有关联的情况下很有用。

内置信号

模型信号

django.db.models.signals模块定义了模型系统发送的一组信号。

pre_init

django.db.models.signals.pre_init
每当您实例化Django模型时，该信号都会在模型的__init__()方法的开头发送。

带有此信号的参数：

sender
刚创建了一个实例的模型类。
ARGS
传递给__init__()的位置参数列表：
kwargs
传递给__init__()的关键字参数的字典：

例如：

from app01 import models

p = models.Publisher(name='沙河出版社')

发送到pre_init处理程序的参数将是：

参数	值
sender	Publisher（类本身）
ARGS	[]（一个空列表，因为没有位置参数传递给__init__()。）
kwargs	{'name'： “沙河出版社”}

pre_save

django.db.models.signals.pre_save
这是在模型的save()方法的开头发送的。

带有此信号的参数：

sender
模型类。
instance
正在保存的实际实例。
raw
一个布尔值True如果模型按照显示的方式保存（即当加载固定装置时）。 不应该查询/修改数据库中的其他记录，因为数据库可能尚未处于一致状态。
using
正在使用的数据库别名。
update_fields
如果有字段被传递给Model.save()方法那么就是所传递的字段集，否则就是None。

post_save

django.db.models.signals.post_save
像pre_save一样，但是在save()方法的末尾发送。

带有此信号的参数：

sender
模型类。
instance
正在保存的实际实例。
created
一个布尔值True如果创建了新记录。
raw
一个布尔值True如果模型按照显示的方式保存（即当加载固定装置时）。 不应该查询/修改数据库中的其他记录，因为数据库可能尚未处于一致状态。
using
正在使用的数据库别名。
update_fields
如果有字段被传递给Model.save()方法那么就是所传递的字段集，否则就是None。

pre_delete

django.db.models.signals.pre_delete
在模型的delete()方法和queryset的delete()方法的开头发送。

带有此信号的参数：

sender
模型类。
instance
正在删除的实际实例。
using
正在使用的数据库别名。

post_delete

django.db.models.signals.post_delete
像pre_delete一样，但是在模型的delete()方法和queryset的delete()方法的末尾发送。

带有此信号的参数：

sender
模型类。
instance
正在删除的实际实例。

请注意，该对象将不再位于数据库中，所以要非常小心使用此实例。

using
正在使用的数据库别名。

m2m_changed

django.db.models.signals.m2m_changed
在模型实例上更改了ManyToManyField时发送。 严格来说，这不是一个模型信号，因为它是由ManyToManyField发送的，但由于它补充了pre_save / post_save和pre_delete / post_delete当跟踪模型的更改时，它包括在这里。

带有此信号的参数：

sender
描述ManyToManyField的中间模型类。 当定义多对多字段时，此类自动创建；您可以使用多对多字段上的through属性访问它。
instance
多对多关系更新的实例。 这可以是sender或ManyToManyField相关的类的一个实例。
action
指示在关系上完成的更新类型的字符串。 这可以是以下之一：

“pre_add”
在之前发送一个或多个对象被添加到关系中。
“post_add”
在之后发送一个或多个对象被添加到关系中。
“pre_remove”
在之前发送一个或多个对象从关系中删除。
“post_remove”
在之后发送一个或多个对象从关系中删除。
“pre_clear”
在之前发送关系被清除。
“post_clear”
之后发送关系被清除。
reverse
指示关系的哪一侧被更新（即，如果它是正在被修改的正向或反向关系）。
model
添加到，从关系中删除或从关系中清除的对象的类。
pk_set
对于pre_add，post_add，pre_remove和post_remove操作，这是一组主键值加入或从关系中删除。

对于pre_clear和post_clear操作，这是None。

using
正在使用的数据库别名。

class_prepared

django.db.models.signals.class_prepared
每当模型类“准备”时发送 - 即，一旦模型已经被定义并在Django的模型系统中注册。 Django内部使用这个信号；它通常不会用于第三方应用程序。

由于此信号是在应用程序注册表群集进程期间发送的，并且在应用注册表完全填充后运行AppConfig.ready()，因此无法使用该方法连接接收器。 一种可能性是连接他们AppConfig.__init__()，注意不要导入模型或触发对应用程序注册表的调用。

使用此信号发送的参数：

sender
ready的model类。

管理信号

pre_migrate

django.db.models.signals.pre_migrate
在开始安装应用程序之前，由migrate命令发送。 对于缺少models模块的应用，不会发送。

带有此信号的参数：

sender
应用程序即将迁移/同步的AppConfig实例。
APP_CONFIG
与sender相同。
verbosity
指示manage.py在屏幕上打印多少信息。 有关详细信息，请参阅--verbosity标志。

监听pre_migrate的函数应根据该参数的值调整输出到屏幕的内容。

interactive
如果interactive是True，则可以安全地提示用户在命令行中输入内容。 如果interactive为False，则侦听此信号的功能不应尝试提示任何内容。

例如，当interactive为True时，django.contrib.auth应用程序仅提示创建超级用户。

using
命令将在其上运行的数据库的别名。
plan
Django中的新功能1.10。
迁移计划将用于迁移运行。 虽然该计划不是公共API，但这在允许罕见的情况下需要知道计划。 一个计划是两个元组的列表，第一个项目是迁移类的实例，第二个项目显示迁移是否回滚（True）或应用（False

apps
Django中的新功能1.10。
包含迁移运行前的项目状态的Apps的实例。 应该使用它来代替全局apps注册表来检索要执行操作的模型。

post_migrate

django.db.models.signals.post_migrate
在migrate（即使不进行迁移）和flush命令的末尾发送。 对于缺少models模块的应用，不会发送。

此信号的处理程序不得执行数据库模式更改，因为如果在migrate命令期间运行，则可能会导致flush命令失败。

带有此信号的参数：

sender
刚刚安装的应用程序的AppConfig实例。
APP_CONFIG
与sender相同。
verbosity
指示manage.py在屏幕上打印多少信息。 有关详细信息，请参阅--verbosity标志。

监听post_migrate的函数应根据此参数的值调整输出到屏幕的内容。

interactive
如果interactive是True，则可以安全地提示用户在命令行中输入内容。 如果interactive为False，则侦听此信号的功能不应尝试提示任何内容。

例如，当interactive为True时，django.contrib.auth应用程序仅提示创建超级用户。

using
用于同步的数据库别名。 默认为default数据库。
plan
Django中的新功能1.10。
用于迁移运行的迁移计划。 虽然该计划不是公共API，但这在允许罕见的情况下需要知道计划。 一个计划是两个元组的列表，第一个项目是迁移类的实例，第二个项目显示迁移是否回滚（True）或应用（False

apps
Django中的新功能1.10。
包含迁移运行后项目状态的Apps的实例。 应该使用它来代替全局apps注册表来检索要执行操作的模型。

请求/响应信号

处理请求时由核心框架发送的信号。

request_started

django.core.signals. request_started
当Django开始处理HTTP请求时发送。

带有此信号的参数：

sender
处理程序类 - 例如django.core.handlers.wsgi.WsgiHandler - 处理该请求。
ENVIRON
environ字典提供给请求。

request_finished

django.core.signals.request_finished
当Django完成向客户端传递HTTP响应时发送。

带有此信号的参数：

sender
处理程序类，如上。

got_request_exception

django.core.signals. got_request_exception
当Django在处理传入的HTTP请求时遇到异常时，会发送此信号。

带有此信号的参数：

sender
处理程序类，如上。
request
HttpRequest对象。

测试信号

信号只在running tests时发送。

setting_changed

django.test.signals.setting_changed
当通过django.test.TestCase.settings()上下文管理器或django.test.override_settings()装饰器/上下文管理器

实际发送两次：应用新值（“setup”）和恢复原始值（“拆除”）时。 使用enter参数来区分两者。

您还可以从django.core.signals导入此信号，以避免在非测试情况下从django.test导入。

带有此信号的参数：

sender
设置处理程序。
setting
设置的名称。
value
更改后的设置值。 对于最初不存在的设置，在“拆卸”阶段，value为None。
enter
一个布尔值True如果应用设置，False如果还原。

template_rendered

django.test.signals.template_rendered
测试系统呈现模板时发送。 在Django服务器的正常操作期间不发出此信号 - 它仅在测试期间可用。

带有此信号的参数：

sender
被渲染的Template对象。
template
与发信人相同
context
模板呈现的Context。

数据库包装器

当数据库连接启动时，由数据库包装器发送的信号。

connection_created

django.db.backends.signals.connection_created
当数据库包装器与数据库进行初始连接时发送。 如果您想将任何后续连接命令发送到SQL后端，这一点尤其有用。

带有此信号的参数：

sender
数据库包装器类 - 即django.db.backends.postgresql.DatabaseWrapper或django.db.backends.mysql.DatabaseWrapper等
connection
打开的数据库连接。 这可以在多数据库配置中使用，以区分来自不同数据库的连接信号。

使用信号

回到前面的面试图，如何在Django中实现每一次ORM保存到数据库的时候执行指定操作？

Receiver函数

Receiver可以是任何Python函数或者方法：

def my_callback(sender, **kwargs):
    print(sender)
    print(kwargs)
    print("要保存了啊！")
    print('-' * 120)

监听信号

一旦某个指定信号触发，就执行我指定的receiver函数。

我们现在的需求是，模型层一执行保存的动作就做什么事。

所以应该是一旦触发 pre_save 信号就执行 my_callback，对于内置的信号Django框架会自动帮我们触发，我们只需要告诉它信号触发之后做什么事就可以了：

pre_save.connect(my_callback)

接下来，只要涉及到ORMC鞥面的save()操作，都会自动执行我定义的my_callback函数了。

例如：

a3 = Author.objects.create(name='测试信号-作者')
b3 = Book.objects.create(title='测试信号-书')

输出：

<class 'app02.models.Author'>
{'signal': <django.db.models.signals.ModelSignal object at 0x108e0d198>, 'instance': <Author: 测试信号-作者>, 'raw': False, 'using': 'default', 'update_fields': None}
要保存了啊！
------------------------------------------------------------------------------------------------------------------------
(0.001) SELECT @@SQL_AUTO_IS_NULL; args=None
(0.001) INSERT INTO `app02_author` (`name`) VALUES ('测试信号-作者'); args=['测试信号-作者']
<class 'app02.models.Book'>
{'signal': <django.db.models.signals.ModelSignal object at 0x108e0d198>, 'instance': <Book: 测试信号-书>, 'raw': False, 'using': 'default', 'update_fields': None}
要保存了啊！
------------------------------------------------------------------------------------------------------------------------
(0.001) INSERT INTO `app02_book` (`title`) VALUES ('测试信号-书'); args=['测试信号-书']

使用装饰器方式监听信号

# 使用装饰器方式
from django.db.models.signals import pre_save
from django.dispatch import receiver


@receiver(pre_save)
def my_callback(sender, **kwargs):
    print(sender)
    print(kwargs)
    print("要保存了啊！")
    print('-' * 120)

自定义信号

上面列出来的都是Django框架内置的信号，当然我们还可以自定义信号。

定义信号

所有信号都是 django.dispatch.Signal 的实例。 providing_args是一个列表，由信号将提供给监听者的参数名称组成。 理论上是这样，但是实际上并没有任何检查来保证向监听者提供了这些参数。

举个例子：

# 自定义信号
from django.dispatch import Signal

bath_done = Signal(providing_args=['amount', 'temperature'])

这里定义了一个洗澡水烧好了的信号，它接受两个参数：amount表示水量，temperature表示温度。

注册receiver

from django.dispatch import receiver

@receiver(bath_done)
def my_action(sender, **kwargs):
    print(sender)
    print(kwargs)
    print('脱衣服泡个澡吧！')

触发信号

斯嘉丽烧好了一浴缸40度的洗澡水，杜兰特要开喝了。

bath_done.send(sender='斯嘉丽', amount='一浴缸', temperature='40°')

from django.db import models
from django.db.models.signals import pre_save

class Book(models.Model):
    name = models.CharField(max_length=32)

# 方法1
def heiheihei(sender, instance, **kwargs):
    print('-' * 120)
    print(sender)
    if sender == Book:
        print(instance.name)
        print(kwargs)
        print("要保存了啊！")
        print('-' * 120)

pre_save.connect(heiheihei)


# 方法2
from django.dispatch import receiver

@receiver(pre_save)
def heiheihei(sender, instance, **kwargs):
    print('-' * 120)
    print(sender)
    if sender == Book:
        print(instance.name)
        print(kwargs)
        print("要保存了啊！")
        print('-' * 120)