Cad iad comharthaí Django?

Question

Accepted Answer

**Comharthaí** iad cur i bhfeidhm Django ar an patrún breathnóra — tugann siad deis do sheoltóirí áirithe tacar glacadóirí a chur in iúl nuair a tharlaíonn **imeachtaí** sonracha (ar nós líonailt nó scrios a dhéanamh ar shamhail). Cumasú a dhéanann siad ar chód **foluain**: gealadh páirt amháin den aip ar imeachtaí i páirt eile gan ghréim dhíreach.

## Comharthaí ionsuite coitianta

```text
pre_save / post_save      → before / after a model instance is saved
pre_delete / post_delete  → before / after a model instance is deleted
m2m_changed               → a ManyToMany relationship changed
request_started / finished→ request lifecycle
user_logged_in / out      → authentication events
```

## Glacadóir a nascadh le comhartha

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

# automatically create a Profile whenever a User is created
@receiver(post_save, sender=User)
def create_profile(sender, instance, created, **kwargs):
    if created:                          # only on creation, not every save
        Profile.objects.create(user=instance)
```

Nascann an deocóir `@receiver` feidhm le comhartha do sheoltóir ar leith. Nuair a shábháltar `User`, glaofaidh Django an fheidhm seo — anseo, `Profile` gaolmhair a chruthú go huathoibríoch. Soiléiríonn an bhratach `created` cruthú ó nuashonruithe.

## Cás úsáide tipiciúil

```python
@receiver(post_save, sender=Order)
def send_order_confirmation(sender, instance, created, **kwargs):
    if created:
        send_email(instance.customer.email, "Order confirmed")
# the Order-creation code doesn't need to know about emails → decoupled
```

Fanann an cód a bheidh ag cruthú ord dírithe ar ordanna; maireann an loighic ríomhphoist ar leithligh agus gealann sé ar an imeachta — na n-imní a choimeád scartha.

## Cathain atá comharthaí úsáideach

```text
✓ Reacting to model events from a DIFFERENT app/module (decoupling)
✓ Auto-creating related objects (Profile on User creation)
✓ Cache invalidation, search-index updates, audit logging on save/delete
✓ Cross-cutting reactions you don't want to embed in the core logic
```

## An rabhadh tábhachtach: is féidir le comharthaí soiléireacht a dhéanú dochar

```python
# ⚠️ signals create IMPLICIT, "action at a distance" behavior:
# saving an Order triggers an email somewhere else — not obvious from the save call.
# This can make code HARDER to follow and debug.
```

```text
When to PREFER explicit code over signals:
  ✗ If the logic clearly belongs in the same flow → call it directly (more readable)
  ✗ Overusing signals → hidden, hard-to-trace behavior, debugging difficulty
  ✓ A common alternative: override the model's save() method, or use a service function,
    for logic tightly coupled to the operation
Use signals mainly for genuine DECOUPLING (reacting across app boundaries), not as
a default for all post-save logic.
```

## Cén fáth go bhfuil sé ríthábhachtach

Géartha **foluáin** cód — ag ligean do dhifríochtaí den fheidhmchlár gealadh ar imeachtaí (sábháil/scrios samhála, imeachtaí auth) gan spleáchais dhíreach, ar rud luachmhar a bheidh ann do imní trasthrasnach ar nós réada gaolmhara a chruthú go huathoibríoch, neamhní taisce, logáil dhubhaitheachta, agus gealadh ar imeachtaí ar fud theorainneacha feidhmchlár.

Tá sé tábhachtach é a thuigbheáil ar gach dhóigh ar *úsáid* a bhaint astu go cuí agus ar chóir iad a thoghadh i gcódanna atá ann cheana féin (comharthaí iad foinse choitianta "cén fáth ar tharla an rud seo?" mearbhall).

Ach, cad atá a dhéanamh ar chomharthaí ábhar go speisialta tábhachtach is an **bhreithiúnacht dhúbhailte maidir le cathain iad a úsáid**: agus go bhfuil siad ag soiléiriú foluáin adeanta, cruthaíonn siad **iompar intuigthe, "gníomhaíocht-i-achar"** ná féidir cód a dhéanann níos deacra a leanuint agus a fhíorú (tá rud a bhaint go rúnda gealadh éifeachtaí sainmhínithe áit eile).

Tuigann forbróirí aibí Django an troid seo — comharthaí a úsáid ar *bhreá an fholuáin* (gealadh ar fud theorainneacha modúil/feidhmchlár ar imeachtaí nach ba cheart a cheapadh go díchupling ó fhoinse) agus b'fhearr **cód follasach** (loighic a ghlaoch go díreach, `save()` a fhorfhrighilt, nó feidhmeanna seirbhíse a úsáid) nuair atá an loighic go soiléir in oiriúint sa sreabhadh céanna, mar atá cód follasach níos inléite agus inrianaithe.

A bheith ar an eolas conas comharthaí a oibrítear (glacadóirí a nascadh, an bhratach `created`, comharthaí coitianta), a dtaobh úsáide fírinne, agus go criticiúil **cathain NACH úsáid a bhaint as** (iompar rúnda, deacra-a-fhíorú a sheachaint) léiríonn tuiscint phraiticiúil, fhiosraithe a dhéanann idirdhealú idir forbróirí a dhíonn cód inchomhdála Django ó dhaoine a úsáideann comharthaí go fada agus cruthaítear feidhmchláir dhubhaithe, dorúnda.