正確的理解和使用Django信號(Signals)

Django 提供一個瞭“信號分發器”機制,允許解耦的應用在框架的其它地方發生操作時會被通知到。 通俗而講Django信號的工作原理就是當某個事件發生的時候會發出一個信號(signals), 而監聽這個信號的函數(receivers)就會立即執行。Django信號的應用場景很多,尤其是用於不同模型或程序間的聯動。常見例子包括創建User對象實例時創建一對一關系的UserProfile對象實例,或者每當用戶下訂單時觸發給管理員發郵件的動作。今天小編我就分享下如何正確使用Django的信號(signals)。

Django信號的一個簡單例子

假設我們有一個如下User模型,我們希望每次有User對象新創建時都打印出有新用戶註冊的提示信息,我們可以使用Django信號(signals)輕松實現。我們的信號發送者sender是User模型,每當User模型執行post_save動作時就會發出信號。此時我們自定義的create_user函數一旦監聽到User發出的post_save信號就會執行,先通過if created判斷對象是新創建的還是被更新的;如果對象是新創建的,就會打印出提示信息。

# models.py

from django.db import models

from django.db.models import signals
from django.dispatch import receiver

class User(models.Model):
    name = models.CharField(max_length=16)
    gender = models.CharField(max_length=32, blank=True)

def create_user(sender, instance, created, **kwargs):

    if created:

        print("New user created!")

post_save.connect(create_user, sender=User)

在上例中我們使用瞭信號(post_save)自帶的connect的方法將自定義的函數與信號發出者(sender)User模型進行瞭連接。在實際應用中一個更常用的方式是使用@receiver裝飾器實現發送者與監聽函數的連接,如下所示。@receiver(post_save, sender=User)讀起來的意思就是監聽User模型發出的post_save信號。

from django.db import models

from django.db.models.signals import post_save
from django.dispatch import receiver

class User(models.Model):
    name = models.CharField(max_length=16)
    gender = models.CharField(max_length=32, blank=True)

@receiver(post_save, sender=User)
def create_user(sender, instance, created, **kwargs):

    if created:

        print("New user created!")

利用Django信號實現不同模型的聯動更新

我們再來看一個復雜一點的例子。我們有一個Profile模型,與User模型是一對一的關系。我們希望創建User對象實例時也創建Profile對象實例,而使用post_save更新User對象時不創建新的Profile對象。這時我們就可以自定義create_user_profile和save_user_profile兩個監聽函數,同時監聽sender(User模型)發出的post_save信號。由於post_save可同時用於模型的創建和更新,我們用if created這個判斷來加以區別。

from django.db import models
from django.db.models.signals import post_save
from django.dispatch import receiver

class Profile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)
    birth_date = models.DateField(null=True, blank=True)

@receiver(post_save, sender=User)
def create_user_profile(sender, instance, created, **kwargs):
   if created:
       Profile.objects.create(user=instance)

@receiver(post_save, sender=User)
def save_user_profile(sender, instance, **kwargs):
    instance.profile.save()

Django常用內置信號

之前的例子中我們使用的都是post_save信號,即在模型調用save()方法後才發送信號。Django其它常用內置信號還包括:

  • django.db.models.signals.pre_save & post_save在模型調用 save()方法之前或之後發送。
  • django.db.models.signals.pre_init& post_init在模型調用_init_方法之前或之後發送。
  • django.db.models.signals.pre_delete & post_delete在模型調用delete()方法或查詢集調用delete() 方法之前或之後發送。
  • django.db.models.signals.m2m_changed在模型多對多關系改變後發送。
  • django.core.signals.request_started & request_finished Django建立或關閉HTTP 請求時發送。

如何正確放置Django信號的監聽函數代碼

在之前案例中,我們將Django信號的監聽函數寫在瞭models.py文件裡。當一個app的與信號相關的自定義監聽函數很多時,此時models.py代碼將變得非常臃腫。一個更好的方式把所以自定義的信號監聽函數集中放在app對應文件夾下的signals.py文件裡,便於後期集中維護。

假如我們有個account的app,包含瞭User和Pofile模型,我們不僅需要在account文件夾下新建signals.py,還需要修改account文件下apps.py和__init__.py,以導入創建的信號監聽函數。

# account/signals.py

from django.db.models.signals import post_save
from django.dispatch import receiver
from .models import User, Profile



@receiver(post_save, sender=User)

def create_user_profile(sender, instance, created, **kwargs):

  if created:

      Profile.objects.create(user=instance)



@receiver(post_save, sender=User)

def save_user_profile(sender, instance, **kwargs):

    instance.profile.save()

# account/apps.py

from django.apps import AppConfig

class AccountConfig(AppConfig):
    name = 'account'

    def ready(self):
        import account.signals

# account/__init__.py

default_app_config = 'account.apps.AccountConfig'

小結

在本文裡我們總結瞭Django信號(signals)的工作原理,介紹瞭如何使用Django信號實現模型或程序的聯動。最後我們還總結瞭Django常用內置信號以及如何正確放置自定義的信號監聽函數。歡迎關註我們更多Python Web開發和Django原創文章。

以上就是正確的理解和使用Django信號(Signals)的詳細內容,更多關於Django信號(Signals)的資料請關註WalkonNet其它相關文章!

推薦閱讀:

    None Found