ComharthaíLink to this heading#

Pre_initLink to this heading#

django.db.models.signals.pre_initLink to this definition#

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> `:

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í:

post_initLink to this heading#

django.db.models.signals.post_initLink to this definition#

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_saveLink to this heading#

django.db.models.signals.pre_saveLink to this definition#

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_saveLink to this heading#

django.db.models.signals.post_saveLink to this definition#

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_scriosLink to this heading#

django.db.models.signals.pre_deleteLink to this definition#

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_deleteLink to this heading#

django.db.models.signals.post_deleteLink to this definition#

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_athraitheLink to this heading#

django.db.models.signals.m2m_changedLink to this definition#

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.

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

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


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

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

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:

>>> 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):

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

>>> t.pizza_set.remove(p)

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

rang_ullmhaitheLink to this heading#

django.db.models.signals.class_preparedLink to this definition#

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.

réamh-imirceLink to this heading#

django.db.models.signals.pre_migrateLink to this definition#

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_migrateLink to this heading#

django.db.models.signals.post_migrateLink to this definition#

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:

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)

iarraidh_tosaithLink to this heading#

django.core.signals.request_startedLink to this definition#

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íochnaitheLink to this heading#

django.core.signals.request_finishedLink to this definition#

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_eisceachtLink to this heading#

django.core.signals.got_request_exceptionLink to this definition#

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.

setting_athraitheLink to this heading#

django.test.signals.setting_changedLink to this definition#

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 ``Link to this heading#

django.test.signals.template_renderedLink to this definition#

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.

nasc_cruthaitheadLink to this heading#

django.db.backends.signals.connection_createdLink to this definition#

Seoltar nuair a dhéanann fillteoir an bunachar sonraí an nasc tosaigh leis an mbunachar sonraí. Tá sé seo úsáideach go háirithe más mian leat aon orduithe nasc poist a sheoladh chuig an gcúltaca SQL.

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