djangodocs

Django 6.1
Gaeilge
Documentation contents

Comharthaí

Liosta de na comharthaí go léir a sheolann Django. Seoltar na comharthaí ionsuite go léir ag baint úsáide as an modh: meth: ~django.dispch.signal.send.

Comharthaí múnla

Sainmhíníonn an modúl:MOD: django.db.models.signals sraith comharthaí a sheolann an córas samhail.

Pre_init

django.db.models.signals.pre_init

Aon uair a chuireann tú samhail Django, seoltar an comhartha seo ag tús modh ``__init__ () ``an tsamhail.

Argóintí a sheoltar leis an comhartha seo:

``Seoltóir ``

Cruthaíodh an rang samhail nach raibh ach sampla ann.

args

Liosta de na hargóintí seasaimh a chuirtear chuig ``__init__ () ``.

`Kwargs

Cuireadh foclóir argóintí eochairfhocal chuig ``__init__ () ``.

Mar shampla, tá an líne seo ag an:doc: `teagorial</intro/tutorial02> `:

Code
q = Question(question_text="What's new?", pub_date=timezone.now())

Is iad seo a leanas na hargóintí a sheoladh chuig a:data: pre_init láimhseálaí:

Argóint

Luach

``Seoltóir ``

``Ceist ``(an rang féin)

args

[] (liosta folamh toisc nach raibh aon argóintí seasaimh ann chuig ``__init__ () ``)

`Kwargs

{'question_text': "What's new?", 'pub_date': datetime.datetime(2012, 2, 26, 13, 0, 0, 775217, tzinfo=datetime.UTC)}

post_init

django.db.models.signals.post_init

Cosúil le pre_init, ach seoltar an ceann seo nuair a chríochnaíonn an modh ``__init__ () ``.

Argóintí a sheoltar leis an comhartha seo:

``Seoltóir ``

Mar atá thuas: an rang samhail nach raibh ach sampla cruthaithe aige.

Instance

An sampla iarbhír den tsamhail atá díreach cruthaithe.

Pre_save

django.db.models.signals.pre_save

Seoltar é seo ag tús modh samhail 's:meth: ~django.db.models.model.save.

Argóintí a sheoltar leis an comhartha seo:

``Seoltóir ``

An rang samhail.

Instance

An cás iarbhír á shábháil.

`raw

<fixtures-explanation>Boolean; True má shábháiltear an tsamhail go díreach mar a chuirtear i láthair (ie agus a: ref: `daingneán `á luchtú). Níor chóir taifid eile sa bhunachar sonraí a fhiosrú/a mhodhnú mar b'fhéidir nach mbeadh an bunachar sonraí i riocht comhsheasmhach fós.

`Úsáid

An ailias bunachar sonraí atá á n-úsáid.

réimsí nuashonraithe

An tacar réimsí le nuashonrú mar a chuirtear chuig: meth: .model.save, nó None mura ritheadh update_fields chuig save () `.

post_save

django.db.models.signals.post_save

Cosúil le: data: pre_save, ach seoltar ag deireadh an modh:meth: ~django.db.models.model.save.

Argóintí a sheoltar leis an comhartha seo:

``Seoltóir ``

An rang samhail.

Instance

An cás iarbhír á shábháil.

cruthaithe

A boolean; True má cruthaíodh taifead nua.

`raw

<fixtures-explanation>Boolean; True má shábháiltear an tsamhail go díreach mar a chuirtear i láthair (ie agus a: ref: `daingneán `á luchtú). Níor chóir taifid eile sa bhunachar sonraí a fhiosrú/a mhodhnú mar b'fhéidir nach mbeadh an bunachar sonraí i riocht comhsheasmhach fós.

`Úsáid

An ailias bunachar sonraí atá á n-úsáid.

réimsí nuashonraithe

An tacar réimsí le nuashonrú mar a chuirtear chuig: meth: .model.save, nó None mura ritheadh update_fields chuig save () `.

pre_scrios

django.db.models.signals.pre_delete

Seoladh ag tús modh samhail's:meth: ~django.db.models.model.delete agus modh ceisteanna 's:meth: ~django.db.models.query.queryset.delete.

Argóintí a sheoltar leis an comhartha seo:

``Seoltóir ``

An rang samhail.

Instance

An cás iarbhír á scriosadh.

`Úsáid

An ailias bunachar sonraí atá á n-úsáid.

`bunaidh

The Model or QuerySet instance from which the deletion originated, that is, the instance whose delete() method was invoked.

post_delete

django.db.models.signals.post_delete

Cosúil le: data: pre_delete, ach seoltar ag deireadh samhail's:meth: ~django.db.models.model.delete modh agus modh queryset's:meth: ~django.db.models.queryset.delete.

Argóintí a sheoltar leis an comhartha seo:

``Seoltóir ``

An rang samhail.

Instance

An cás iarbhír á scriosadh.

Tabhair faoi deara nach mbeidh an réad sa bhunachar sonraí a thuilleadh, mar sin bí an-chúramach cad a dhéanann tú leis an gcás seo.

`Úsáid

An ailias bunachar sonraí atá á n-úsáid.

`bunaidh

The Model or QuerySet instance from which the deletion originated, that is, the instance whose delete() method was invoked.

m2m_athraithe

django.db.models.signals.m2m_changed

Seoltar nuair a athraítear a:class: ~django.db.models.manyToManyField ar shampla samhail. Go docht, ní comhartha samhail é seo ós rud é go seolann an: class: ~django.db.models.manyToManyField é, ach ós rud é go gcomhlíonann sé an:data: pre_save/:data: post_save agus:data: pre_delete/:data: post_delete maidir le hathruithe ar mhúnlaí a rianú, tá sé san áireamh anseo.

Argóintí a sheoltar leis an comhartha seo:

``Seoltóir ``

An rang samhail idirmheánach ag cur síos ar:class: ~django.db.models.manyToManyField. Cruthaítear an rang seo go huathoibríoch nuair a shainmhínítear réimse go leor; is féidir leat rochtain a fháil air ag baint úsáide as an tréith ``trí ``ar an réimse go leor.

Instance

An cás a nuashonraítear a gcaidreamh go leor le go leor. Is féidir seo a bheith ina shampla den ``seoltóir`, nó den rang a bhaineann le:class: ~django.db.models.manyToManyField.

Gníomha

Sreang a léiríonn an cineál nuashonraithe a dhéantar ar an ngaol. Is féidir seo a bheith ar cheann de na nithe seo a leanas:

"pre_add “

Seoltaí* roimh* cuirtear réad amháin nó níos mó leis an ngaol.

"post_add “

Seoltaí* tar éis * cuirtear réad amháin nó níos mó leis an ngaol.

``"réamh_bhaint” ``

Seoltaí* roimh* baintear réad amháin nó níos mó ón gcaidreamh.

"post_remove"

Seoltaí* tar éis * baintear réad amháin nó níos mó ón gcaidreamh.

"réamh-ghlanaire"

Seoltaí* roimh* glanfar an gaol.

"post_clear"

Seoltaí* ina dhiaithe* glantar an gaol.

`aisiom

Léiríonn sé cén taobh den chaidreamh a nuashonraítear (ie, más é an gaol tosaigh nó droim atá á mhodhnú).

``Samhail ``

Aicme na rudaí a chuirtear leis an gcaidreamh, a bhaintear uaidh nó a ghlantar uaidh.

pk_set

Maidir leis na gníomhartha pre_add agus post_add, is sraith príomhluachanna é seo a chuirfear leis an ngaol nó a chuirfear leis an ngaol. D'fhéadfadh sé seo a bheith ina fho-thacar de na luachanna a chuirtear isteach le cur leis, ós rud é go gcaithfidh iontráil luachanna atá ann cheana a scagadh d'fhonn bunachar sonraí IntegrityError a sheachaint.

Maidir leis na gníomhartha pre_remove agus post_remove, is sraith de phríomhluachanna é seo a cuireadh isteach le fáil a bhaint as an ngaol. Ní bhíonn sé seo ag brath ar cibé an mbainfear na luachanna i ndáiríre, nó an ndearnadh na luachanna bainte. Go háirithe, féadfar luachanna nach bhfuil ann a chur isteach, agus beidh siad le feiceáil in pk_set`, cé nach bhfuil aon éifeacht acu ar an mbunachar sonraí.

Maidir leis na gníomhartha pre_clear agus post_clear, is é seo None.

`Úsáid

An ailias bunachar sonraí atá á n-úsáid.

`raw

<fixtures-explanation>Boolean; True má shábháiltear an tsamhail go díreach mar a chuirtear i láthair (ie agus a: ref: `daingneán `á luchtú). Níor chóir taifid eile sa bhunachar sonraí a fhiosrú/a mhodhnú mar b'fhéidir nach mbeadh an bunachar sonraí i riocht comhsheasmhach fós.

Mar shampla, más féidir le Pizza rudaí iolracha ``Topping ``a bheith aige, samhaltaithe mar seo:

Code
class Topping(models.Model):
    # ...
    pass


class Pizza(models.Model):
    # ...
    toppings = models.ManyToManyField(Topping)

Má cheangail muid láimhseálaí mar seo:

Code
from django.db.models.signals import m2m_changed


def toppings_changed(sender, **kwargs):
    # Do something
    pass


m2m_changed.connect(toppings_changed, sender=Pizza.toppings.through)

agus ansin rinne rud éigin mar seo:

Python console
>>> p = Pizza.objects.create(...)
>>> t = Topping.objects.create(...)
>>> p.toppings.add(t)

is iad na hargóintí a sheoltar chuig a:data: m2m_changed handler (toppings_changed sa sampla thuas):

Argóint

Luach

``Seoltóir ``

``Pizza.Toppings.Through ``(an rang idirmheánach m2m)

Instance

p (an cás Pizza á mhodhnú)

Gníomha

"pre_add" (ina dhiaidh sin comhartha ar leithligh le "post_add")

`aisiom

False (Pizza` tá an: aicme: ~django.db.models.manyToManyField, mar sin athraíonn an glao seo an gaol tosaigh)

``Samhail ``

Topping (aicme na rudaí a chuirtear leis an Pizza)

pk_set

{t.id} (ós rud é nach cuireadh ach Topping t leis an ngaol)

`Úsáid

"réamhshocraithe" (ós rud é go seolann an ródaire réamhshocraithe scríobhann anseo)

`raw

False (since it is not loaded from a fixture)

Agus dá ndéanfaimis rud éigin mar seo ansin:

Python console
>>> t.pizza_set.remove(p)

is iad na hargóintí a sheoltar chuig a:data: m2m_changed láimhseálaí:

Argóint

Luach

``Seoltóir ``

``Pizza.Toppings.Through ``(an rang idirmheánach m2m)

Instance

t (an cás Topping á mhodhnú)

Gníomha

"pre_remove" (ina dhiaidh sin comhartha ar leithligh le "post_remove")

`aisiom

True (Pizza` tá sean:class: ~django.db.models.manyToManyField, mar sin athraíonn an glao seo an gaol droim)

``Samhail ``

Pizza (aicme na rudaí a bhaintear ón Topping)

pk_set

{p.id} (ós rud é nach baineadh ach Pizza p` ón gcaidreamh)

`Úsáid

"réamhshocraithe" (ós rud é go seolann an ródaire réamhshocraithe scríobhann anseo)

`raw

False (since it is not loaded from a fixture)

rang_ullmhaithe

django.db.models.signals.class_prepared

Seoltar aon uair a ullmhaíodh rang samhail - is é sin, nuair a bheidh samhail sainmhínithe agus cláraithe le córas samhail Django. Úsáideann Django an comhartha seo go hinmheánach; ní úsáidtear é i bhfeidhmchláir tríú páirtí

Ós rud é go seoltar an comhartha seo le linn phróisis daonra an chlárlann aipeanna, agus ritheann: meth: `AppConfig.ready () <django.apps.AppConfig.ready>`tar éis do chlárlann an aip a bheith daonra go hiomlán, ní féidir glacadóirí a nascadh sa mhodh sin. Féidearthacht amháin ná iad a nascadh ``AppConfig. __init__ () ``ina ionad sin, ag tabhairt aire gan samhlacha a iompórtáil nó glaonna a spreagadh chuig clárlann an aip.

Argóintí a sheoltar leis an gcomhartha seo:

``Seoltóir ``

An rang samhail a bhí díreach ullmhaithe.

Comharthaí bainistíochta

Comharthaí a sheoltar ar:doc: django-admin </ref/django-admin>.

réamh-imirce

django.db.models.signals.pre_migrate

Seolta ag an ordú:djadmin: migrate sula dtosaíonn sé ag suiteáil feidhmchlár. Ní astaítear é d'iarratais nach bhfuil modúl “samhlacha” nach bhfuil modúl acu.

Argóintí a sheoltar leis an comhartha seo:

``Seoltóir ``

An:class: ~django.apps.appconfig mar shampla don fheidhmchlár atá ar tí a imirce/sioncrónú.

app_config

Mar an gcéanna le ``seoltó`.

Dearbhacht

Léiríonn sé cé mhéad faisnéise atá manage.py` a phriontáil ar an scáileán. Féach an brat:option: --verbosity le haghaidh sonraí.

Ba cheart d'fheidhmeanna a éisteann le:data: pre_migrate an méid a aschuireann siad ar an scáileán a choigeartú bunaithe ar luach an argóint seo.

idirghníomhach

Má tá idirghníomhach` ``True, tá sé sábháilte an t-úsáideoir a spreagadh chun rudaí a ionchur ar an líne ordaithe. Más “False” é idirghníomhach, níor cheart feidhmeanna a éisteann leis an gcomhartha seo iarracht a dhéanamh rud ar bith a spreagadh.

Mar shampla, ní spreagann an aip: mod: django.contrib.auth ach sárúsáideoir a chruthú nuair a bhíonn idirghníomh True`.

stdout

Rud cosúil le sruth inar chóir aschur fhearbose a atreorú.

`Úsáid

An t-ailias an bhunachar sonraí ar a n-oibreoidh ordú.

plean

An plean imirce atá le húsáid don imirce a reáchtáil. Cé nach API poiblí é an plean, ceadaíonn sé seo do na cásanna neamhchoitianta nuair is gá an plean a fháil amach. Is é plean liosta de dhá thúpla agus is é an chéad mhír mar shampla aicme imirce agus an dara mír a léiríonn an t-imirce ar rolladh ar ais (True) nó an cuireadh i bhfeidhm (False).

``aipeanna ``

Sampla de:data: `Apps <django.apps>`ina bhfuil staid an tionscadail sula ritheann an imirce. Ba chóir é a úsáid in ionad an chlárlann domhanda: attr: `apps <django.apps.apps>`chun na samhlacha a theastaíonn uait oibríochtaí a dhéanamh orthu a aisghabháil.

post_migrate

django.db.models.signals.post_migrate

Seoltar ag deireadh na horduithe: djadmin: migrate (fiú mura reáchtáiltear aon imirce) agus:djadmin: flush. Ní astaítear é d'iarratais nach bhfuil modúl “samhlacha” nach bhfuil modúl acu.

Ní mór do láimhseálaithe an chomhartha seo athruithe scéime bunachar sonraí a dhéanamh mar d'fhéadfadh go dteipfeadh ar an ordú:djadmin: flush `má ritheann sé le linn an orduithe: djadmin: `migrate.

Argóintí a sheoltar leis an comhartha seo:

``Seoltóir ``

An:class: ~django.apps.appconfig sampla don fheidhmchlár a bhí díreach suiteáilte.

app_config

Mar an gcéanna le ``seoltó`.

Dearbhacht

Léiríonn sé cé mhéad faisnéise atá manage.py` a phriontáil ar an scáileán. Féach an brat:option: --verbosity le haghaidh sonraí.

Ba cheart d'fheidhmeanna a éisteann le:data: post_migrate an méid a aschuireann siad ar an scáileán a choigeartú bunaithe ar luach an argóint seo.

idirghníomhach

Má tá idirghníomhach` ``True, tá sé sábháilte an t-úsáideoir a spreagadh chun rudaí a ionchur ar an líne ordaithe. Más “False” é idirghníomhach, níor cheart feidhmeanna a éisteann leis an gcomhartha seo iarracht a dhéanamh rud ar bith a spreagadh.

Mar shampla, ní spreagann an aip: mod: django.contrib.auth ach sárúsáideoir a chruthú nuair a bhíonn idirghníomh True`.

stdout

Rud cosúil le sruth inar chóir aschur fhearbose a atreorú.

`Úsáid

An alias bunachar sonraí a úsáidtear le haghaidh sioncrónú. Réamhshocraithe chuig an mbunachar sonraí default.

plean

An plean imirce a úsáideadh don imirce a reáchtáil. Cé nach API poiblí é an plean, ceadaíonn sé seo do na cásanna neamhchoitianta nuair is gá an plean a fháil amach. Is é plean liosta de dhá thúpla agus is é an chéad mhír mar shampla aicme imirce agus an dara mír a léiríonn an t-imirce ar rolladh ar ais (True) nó an cuireadh i bhfeidhm (False).

``aipeanna ``

Sampla de:data: `Apps <django.apps.apps>`ina bhfuil staid an tionscadail tar éis an imirce a reáchtáil. Ba chóir é a úsáid in ionad an chlárlann domhanda: attr: `apps <django.apps.apps>`chun na samhlacha a theastaíonn uait oibríochtaí a dhéanamh orthu a aisghabháil.

Mar shampla, d'fhéadfá glaoch ar ais a chlárú in an:class: ~django.apps.appconfig mar seo:

Code
from django.apps import AppConfig
from django.db.models.signals import post_migrate


def my_callback(sender, **kwargs):
    # Your specific logic here
    pass


class MyAppConfig(AppConfig):
    ...

    def ready(self):
        post_migrate.connect(my_callback, sender=self)

Comharthaí iarrata/freagartha

Comharthaí a sheolann an croíchreat agus iarratas á phróiseáil.

iarraidh_tosaith

django.core.signals.request_started

Seoltar nuair a thosaíonn Django ag próiseáil iarratas HTTP.

Argóintí a sheoltar leis an comhartha seo:

``Seoltóir ``

An rang láimhseálaithe -- m.sh. Django.Core.Handlers.wsgi.wsgiHandler -- a láimhseáil leis an iarraidh.

``Comhshaol`

An foclóir timpeallach a chuirtear ar fáil don iarratas.

iarraidh_críochnaithe

django.core.signals.request_finished

Seoltar nuair a chríochnaíonn Django freagra HTTP a sheachadadh don chliant.

Argóintí a sheoltar leis an comhartha seo:

``Seoltóir ``

An rang láimhseálaithe, mar atá thuas.

Got_iarrth_eisceacht

django.core.signals.got_request_exception

Seoltar an comhartha seo aon uair a thagann Django le heisceacht agus iarratas HTTP ag teacht isteach á phróiseáil.

Argóintí a sheoltar leis an comhartha seo:

``Seoltóir ``

Gan úsáid (i gcónaí ``Non ``).

Iarrata

An réad: aicme: ~django.http.httpRequest.

Comharthaí tástála

<running-tests>Ní sheoltar comharthaí ach nuair:ref: `tástálacha reatha `.

setting_athraithe

django.test.signals.setting_changed

Seoltar an comhartha seo nuair a athraítear luach socrú tríd an mbainisteoir comhthéacs ``django.test.testcase.settings () ``nó an: func: django.test.override_settings maisiúcháin/bainisteoir comhthéacs.

Seoltar é faoi dhó i ndáiríre: nuair a chuirtear an luach nua i bhfeidhm (“socrú”) agus nuair a athshlántar an luach bunaidh (“teardown”). Úsáid an argóint ``enter ``chun idirdhealú a dhéanamh idir an dá cheann.

Is féidir leat an comhartha seo a iompórtáil ó django.core.signals chun allmhairiú ó django.test` a sheachaint i gcásanna neamh-tástála.

Argóintí a sheoltar leis an comhartha seo:

``Seoltóir ``

An láimhseálaí socruithe.

Socraithe

Ainm an suímh.

luach

Luach an shocraithe tar éis an athraithe. Maidir le socruithe nach bhfuil ann i dtosach, sa chéim “teardown”, is é luach None.

``Cuir isteach ``

Boolean; True má chuirtear an socrú i bhfeidhm, False má athchóiritear é.

``teimpléad_rinneadh ``

django.test.signals.template_rendered

Seoltar nuair a dhéanann an córas tástála teimpléad a léiriú. Ní astaítear an comhartha seo le linn gnáthoibriú freastalaí Django - níl sé ar fáil ach le linn tástála.

Argóintí a sheoltar leis an comhartha seo:

``Seoltóir ``

An réad: Class: ~Django.Template.Template a rinneadh.

Teimpléad

Mar an gcéanna le seoltóir

comhthéacs

An: class: ~django.template.context ar rinneadh an teimpléad leis.

Fillteáin Bunachar Sonraí

Comharthaí a sheolann an fillteoir bunachar sonraí nuair a thioctar nasc bunachar sonraí.

nasc_cruthaithead

django.db.backends.signals.connection_created

Sent when the database wrapper makes the initial connection to the database. This is particularly useful if you'd like to send any post connection commands to the SQL backend.

Argóintí a sheoltar leis an comhartha seo:

``Seoltóir ``

An rang timfhilleadh bunachar sonraí - ie Django.db.backends.postgresql.databaseWrapper nó Django.db.backends.mysql.databaseWrapper, srl.

nasc

An nasc bunachar sonraí a osclaíodh. Is féidir é seo a úsáid i gcumraíocht ilbhunachar sonraí chun comharthaí nasc a idirdhealú ó bhunachair sonraí éag

Tasks signals

Signals sent by the tasks framework.

task_enqueued

django.tasks.signals.task_enqueued

Sent once a Task has been enqueued.

Argóintí a sheoltar leis an comhartha seo:

``Seoltóir ``

The backend class which the Task was enqueued on to.

task_result

The enqueued TaskResult.

task_started

django.tasks.signals.task_started

Sent when a Task has started executing.

Argóintí a sheoltar leis an comhartha seo:

``Seoltóir ``

The backend class which the Task was enqueued on to.

task_result

The started TaskResult.

task_finished

django.tasks.signals.task_finished

Sent once a Task has finished executing, successfully or otherwise.

Argóintí a sheoltar leis an comhartha seo:

``Seoltóir ``

The backend class which the Task was enqueued on to.

task_result

The finished TaskResult.

View as Markdown Edit this page on GitHub Official version