正文

在平時(shí)的開發(fā)過程中，我們會遇到一些特殊的應(yīng)用場景，如果你想要在執(zhí)行某種操作之前或者之后你能夠得到通知，并對其進(jìn)行一些你想要的操作時(shí)，你就可以用Django中的信號（signals）。Django 提供一個(gè)“信號分發(fā)器”，允許解耦的應(yīng)用在框架的其它地方發(fā)生操作時(shí)會被通知到，也就是說在特定事件發(fā)生時(shí)，可以發(fā)送一個(gè)信號去通知所有注冊了這個(gè)信號的回調(diào)，在回調(diào)里進(jìn)行想要的操作處理。

一.Django內(nèi)置信號

Django內(nèi)置了對數(shù)據(jù)表，migrate命令，url請求相關(guān)（request/response），使用test測試，連接數(shù)據(jù)庫五大類信號。

Model signals
 pre_init   # model執(zhí)行構(gòu)造方法前，觸發(fā)
 post_init   # model執(zhí)行構(gòu)造方法后，觸發(fā)
 pre_save   # model執(zhí)行save對象保存前，觸發(fā)
 post_save   # model執(zhí)行save對象保存前，觸發(fā)
 pre_delete   # model執(zhí)行delete對象刪除前，觸發(fā)
 post_delete   # model執(zhí)行delete對象刪除前，觸發(fā)
 m2m_changed   # model使用多對多字段操作第三張表前后，觸發(fā)
 class_prepared  # 程序啟動時(shí)，檢測已注冊的model類，對每個(gè)類，觸發(fā)

Management signals
 pre_migrate   # 執(zhí)行migrate前，觸發(fā)
 post_migrate   # 執(zhí)行migrate后，觸發(fā)

Request/response signals
 request_started  # 請求到來前，觸發(fā)
 request_finished  # 請求結(jié)束后，觸發(fā)
 got_request_exception # 請求異常后，觸發(fā)

Test signals
 setting_changed  # 使用test測試修改配置文件，觸發(fā)
 template_rendered  # 使用test測試渲染模板時(shí)，觸發(fā)

Database Wrappers
 connection_created  # 創(chuàng)建數(shù)據(jù)庫連接時(shí)，觸發(fā)

1.常用內(nèi)置信號參數(shù)介紹

(1)django.db.models.signals.pre_save

pre_save處理程序的參數(shù)介紹

參數(shù)名 參數(shù)介紹
sender 模型類
instance 保存的實(shí)際實(shí)例（保存后的model數(shù)據(jù)對象）
raw 布爾值; True如果模型完全按照提供的方式保存。不應(yīng)該查詢/修改數(shù)據(jù)庫中的其他記錄，因?yàn)閿?shù)據(jù)庫可能尚未處于一致狀態(tài)
using 正在使用的數(shù)據(jù)庫別名
update_fields 要傳遞給更新的字段集model.save（），或者None 如果update_fields未傳遞給它save()

(2)django.db.models.signals.post_save

post_save處理程序的參數(shù)介紹

參數(shù)名 參數(shù)介紹
sender 模型類
instance 保存的實(shí)際實(shí)例
created 布爾值; True如果創(chuàng)建了新記錄（True表示數(shù)據(jù)創(chuàng)建）
raw 布爾值; True如果模型完全按照提供的方式保存。不應(yīng)該查詢/修改數(shù)據(jù)庫中的其他記錄，因?yàn)閿?shù)據(jù)庫可能尚未處于一致狀態(tài)
using 正在使用的數(shù)據(jù)庫別名
update_fields 要傳遞給更新的字段集model.save（），或者None 如果update_fields未傳遞給它save()

(3)django.db.models.signals.pre_delete

pre_delete處理程序的參數(shù)介紹

參數(shù)名 參數(shù)介紹
sender 模型類
instance 要?jiǎng)h除的實(shí)際實(shí)例
using 正在使用的數(shù)據(jù)庫別名

(4)django.db.models.signals.post_delete

post_delete處理程序的參數(shù)介紹

參數(shù)名 參數(shù)介紹
sender 模型類
instance 要?jiǎng)h除的實(shí)際實(shí)例（該對象將不再存在于數(shù)據(jù)庫中，因此請謹(jǐn)慎對待此實(shí)例）
using 正在使用的數(shù)據(jù)庫別名

更多信號參數(shù)介紹請參考https://docs.djangoproject.com/zh-hans/2.1/ref/signals/

2.內(nèi)置信號監(jiān)聽方法

對于Django內(nèi)置的信號，僅需注冊指定信號，當(dāng)程序執(zhí)行相應(yīng)操作時(shí)，自動觸發(fā)注冊函數(shù)。當(dāng)你寫好一個(gè)接收器（receiver function）用于接收到信號以后的回調(diào)處理后，就需要將接收器連接到信號，有兩種方法，手動連接，跟使用receiver裝飾器的方式。

手動連接實(shí)現(xiàn)方法：

from django.db.models.signals import post_delete

def my_callback(sender, **kwargs):
 print(sender)
 print("信號已接收")

post_delete.connect(my_callback) # 信號連接接收器，用于收到信號的回調(diào),如果想要指定某個(gè)表對象，直接指定sender

# connect參數(shù)接收
"""
receiver - 將連接到此信號的回調(diào)函數(shù)。回調(diào)函數(shù)名，不帶括號
sender - 指定從中接收信號的特定發(fā)送方。
weak - Django默認(rèn)將信號處理程序存儲為弱引用。因此，如果您的接收器是本地功能，它可能被垃圾收集。為了防止這種情況，請weak=False在調(diào)用信號connect()方法時(shí)通過。
dispatch_uid - 在可能發(fā)送重復(fù)信號的情況下信號接收器的唯一標(biāo)識符。
"""

receiver裝飾器實(shí)現(xiàn)方法：

from django.dispatch import receiver
from django.db.models.signals import post_delete
from app.models import UCenter

@receiver(post_delete, sender=UCenter) # post_delete指定信號觸發(fā)類型，sender指定到具體對象
def delete_u2user(sender, instance, **kwargs): # instance表示被刪除的對象
 print(sender, instance)

更多信號操作相關(guān)問題參考文檔https://docs.djangoproject.com/zh-hans/2.1/topics/signals/

二.自定義信號使用

 1.定義信號

from django.dispatch import Signal

test_signal = Signal(providing_args=["name", "age"]) # 聲明一個(gè)test_signal的信號，提供給接收器name跟age兩個(gè)參數(shù)（可自定義參數(shù)）

2.注冊信號

def my_callback(sender, **kwargs):
 print(sender)
 print("信號已接收")

test_signal.connect（my_callback） # 注冊信號，指定接收器為my_callback

3.觸發(fā)信號

from xxx import test_signal

test_signal.send(sender='test', name='zzq', age='18') # 觸發(fā)信號，發(fā)送name，age參數(shù)信息

當(dāng)然這樣在選擇發(fā)送信號的方式有兩種一種使用Signal.send，還有一種是Signal.send_robut。

send()與send_robust()處理接收器功能引起的異常的方式不同。

send()并不能捕獲由接收器提出的任何異常; 它只是允許錯(cuò)誤傳播。因此，在面對錯(cuò)誤時(shí)，不是所有接收器都可以被通知信號。

send_robust()捕獲從Python Exception類派生的所有錯(cuò)誤，并確保所有接收器都收到信號通知。如果發(fā)生錯(cuò)誤，則會在引發(fā)錯(cuò)誤的接收器的元組對中返回錯(cuò)誤實(shí)例。

總結(jié)

以上就是這篇文章的全部內(nèi)容了，希望本文的內(nèi)容對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，謝謝大家對腳本之家的支持。