Что такое сигналы?

Сигналы в контексте Django — это механизм уведомления о наступлении определенных событий в приложении. Они позволяют "повесить" обработчики на эти события.

Основные типы сигналов в Django:

• built-in signals: predefined signals for common events (e.g., pre_save, post_save, pre_delete, post_delete for model actions, request_started, request_finished for HTTP requests).
• custom signals: defined by the developer for specific application needs.

Применение сигналов:

• Декоуплинг (отделение) логики. Вместо непосредственного вызова функций из других частей приложения, компоненты могут отправлять сигналы, и другие компоненты, которые заинтересованы в этих событиях, могут их обрабатывать.
• Расширение функциональности без изменения исходного кода.

Как работают сигналы:

• Sender: объект, который отправляет сигнал.
• Signal: экземпляр специального класса (например, django.dispatch.Signal).
• Receiver (handler): функция, которая вызывается при получении сигнала.

Пример регистрации обработчика для встроенного сигнала post_save:

# myapp/signals.py

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

@receiver(post_save, sender=MyModel)
def my_model_post_save_handler(sender, instance, created, **kwargs):
    # Логика обработки после сохранения объекта MyModel
    if created:
        print(f"Объект {instance} создан.")
    else:
        print(f"Объект {instance} обновлен.")

Необходимо убедиться, что файл signals.py импортируется Django. Обычно это делается в файле apps.py приложения:

# myapp/apps.py

from django.apps import AppConfig

class MyappConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'myapp'

    def ready(self):
        # Импортируем сигналы при запуске приложения
        import myapp.signals

Создание и отправка пользовательского сигнала:

# myapp/signals.py

from django.dispatch import Signal

# Определение пользовательского сигнала
my_custom_signal = Signal()

# Где-то в коде, где происходит событие
def trigger_my_custom_event(data):
    # Отправка сигнала с данными
    my_custom_signal.send(sender='my_component', data=data)

Регистрация обработчика для пользовательского сигнала:

# myapp/handlers.py

from django.dispatch import receiver
from .signals import my_custom_signal

@receiver(my_custom_signal)
def my_custom_signal_handler(sender, data, **kwargs):
    print(f"Получен пользовательский сигнал от {sender} с данными: {data}")

Сигналы в Django предоставляют мощный и гибкий способ реагировать на события, повышая модульность и расширяемость приложения.