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.
\n\nSainmhíníonn an modúl:MOD: django.db.models.signals sraith comharthaí a sheolann an córas samhail.
\n\n\n\nPre_initLink to this heading#Aon uair a chuireann tú samhail Django, seoltar an comhartha seo ag tús modh ``__init__ () ``an tsamhail.
\nArgóintí a sheoltar leis an comhartha seo:
\nCruthaíodh an rang samhail nach raibh ach sampla ann.
\nargsLiosta de na hargóintí seasaimh a chuirtear chuig ``__init__ () ``.
\n`KwargsCuireadh foclóir argóintí eochairfhocal chuig ``__init__ () ``.
\nMar shampla, tá an líne seo ag an:doc: `teagorial</intro/tutorial02> `:
\nq = Question(question_text="What's new?", pub_date=timezone.now())\nIs iad seo a leanas na hargóintí a sheoladh chuig a:data: pre_init láimhseálaí:
\n\npost_initLink to this heading#Cosúil le pre_init, ach seoltar an ceann seo nuair a chríochnaíonn an modh ``__init__ () ``.
\nArgóintí a sheoltar leis an comhartha seo:
\nMar atá thuas: an rang samhail nach raibh ach sampla cruthaithe aige.
\nInstanceAn sampla iarbhír den tsamhail atá díreach cruthaithe.
\n\nPre_saveLink to this heading#Seoltar é seo ag tús modh samhail 's:meth: ~django.db.models.model.save.
\nArgóintí a sheoltar leis an comhartha seo:
\nAn rang samhail.
\nInstanceAn cás iarbhír á shábháil.
\n`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áidAn ailias bunachar sonraí atá á n-úsáid.
\nréimsí nuashonraitheAn 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#Cosúil le: data: pre_save, ach seoltar ag deireadh an modh:meth: ~django.db.models.model.save.
\nArgóintí a sheoltar leis an comhartha seo:
\nAn rang samhail.
\nInstanceAn cás iarbhír á shábháil.
\ncruthaitheA 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áidAn ailias bunachar sonraí atá á n-úsáid.
\nréimsí nuashonraitheAn 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#Seoladh ag tús modh samhail's:meth: ~django.db.models.model.delete agus modh ceisteanna 's:meth: ~django.db.models.query.queryset.delete.
\nArgóintí a sheoltar leis an comhartha seo:
\nAn rang samhail.
\nInstanceAn cás iarbhír á scriosadh.
\n`ÚsáidAn ailias bunachar sonraí atá á n-úsáid.
\n`bunaidhThe Model or QuerySet instance from which the deletion originated,\nthat is, the instance whose delete() method was invoked.
post_deleteLink to this heading#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.
\nArgóintí a sheoltar leis an comhartha seo:
\nAn rang samhail.
\nInstanceAn cás iarbhír á scriosadh.
\nTabhair 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.
\n`ÚsáidAn ailias bunachar sonraí atá á n-úsáid.
\n`bunaidhThe Model or QuerySet instance from which the deletion originated,\nthat is, the instance whose delete() method was invoked.
m2m_athraitheLink to this heading#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.
\nArgóintí a sheoltar leis an comhartha seo:
\nAn 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.
\nInstanceAn 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.
\nGníomhaSreang 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:
\n"pre_add “Seoltaí* roimh* cuirtear réad amháin nó níos mó leis an ngaol.
\n"post_add “Seoltaí* tar éis * cuirtear réad amháin nó níos mó leis an ngaol.
\nSeoltaí* roimh* baintear réad amháin nó níos mó ón gcaidreamh.
\n"post_remove"Seoltaí* tar éis * baintear réad amháin nó níos mó ón gcaidreamh.
\n"réamh-ghlanaire"Seoltaí* roimh* glanfar an gaol.
\n"post_clear"Seoltaí* ina dhiaithe* glantar an gaol.
\n`aisiomLéiríonn sé cén taobh den chaidreamh a nuashonraítear (ie, más é an gaol tosaigh nó droim atá á mhodhnú).
\nAicme na rudaí a chuirtear leis an gcaidreamh, a bhaintear uaidh nó a ghlantar uaidh.
\npk_setMaidir 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áidAn ailias bunachar sonraí atá á n-úsáid.
\nMar shampla, más féidir le Pizza rudaí iolracha ``Topping ``a bheith aige, samhaltaithe mar seo:
class Topping(models.Model):\n # ...\n pass\n\n\nclass Pizza(models.Model):\n # ...\n toppings = models.ManyToManyField(Topping)\nMá cheangail muid láimhseálaí mar seo:
\nfrom django.db.models.signals import m2m_changed\n\n\ndef toppings_changed(sender, **kwargs):\n # Do something\n pass\n\n\nm2m_changed.connect(toppings_changed, sender=Pizza.toppings.through)\nagus ansin rinne rud éigin mar seo:
\n>>> p = Pizza.objects.create(...)\n>>> t = Topping.objects.create(...)\n>>> p.toppings.add(t)\nis iad na hargóintí a sheoltar chuig a:data: m2m_changed handler (toppings_changed sa sampla thuas):
Argóint | \nLuach | \n
|---|---|
``Seoltóir `` | \n\n |
| \n
| \n
| \n
| \n
| \n
| \n
``Samhail `` | \n
| \n
| \n
| \n
| \n
| \n
Agus dá ndéanfaimis rud éigin mar seo ansin:
\n>>> t.pizza_set.remove(p)\nis iad na hargóintí a sheoltar chuig a:data: m2m_changed láimhseálaí:
\nArgóint | \nLuach | \n
|---|---|
``Seoltóir `` | \n\n |
| \n
| \n
| \n
| \n
| \n
| \n
``Samhail `` | \n
| \n
| \n
| \n
| \n
| \n
rang_ullmhaitheLink to this heading#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í
\nÓ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.
\nArgóintí a sheoltar leis an gcomhartha seo:
\nAn rang samhail a bhí díreach ullmhaithe.
\nComharthaí a sheoltar ar:doc: django-admin </ref/django-admin>.
\nréamh-imirceLink to this heading#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.
\nArgóintí a sheoltar leis an comhartha seo:
\nAn:class: ~django.apps.appconfig mar shampla don fheidhmchlár atá ar tí a imirce/sioncrónú.
\napp_configMar an gcéanna le ``seoltó`.
\nDearbhachtLé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í.
\nBa 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.
\nidirghníomhachMá 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`.
stdoutRud cosúil le sruth inar chóir aschur fhearbose a atreorú.
\n`ÚsáidAn t-ailias an bhunachar sonraí ar a n-oibreoidh ordú.
\npleanAn 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).
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.
\npost_migrateLink to this heading#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.
\nNí 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.
\nArgóintí a sheoltar leis an comhartha seo:
\nAn:class: ~django.apps.appconfig sampla don fheidhmchlár a bhí díreach suiteáilte.
\napp_configMar an gcéanna le ``seoltó`.
\nDearbhachtLé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í.
\nBa 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.
\nidirghníomhachMá 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`.
stdoutRud cosúil le sruth inar chóir aschur fhearbose a atreorú.
\n`ÚsáidAn alias bunachar sonraí a úsáidtear le haghaidh sioncrónú. Réamhshocraithe chuig an mbunachar sonraí default.
pleanAn 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).
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.
\nMar shampla, d'fhéadfá glaoch ar ais a chlárú in an:class: ~django.apps.appconfig mar seo:
\nfrom django.apps import AppConfig\nfrom django.db.models.signals import post_migrate\n\n\ndef my_callback(sender, **kwargs):\n # Your specific logic here\n pass\n\n\nclass MyAppConfig(AppConfig):\n ...\n\n def ready(self):\n post_migrate.connect(my_callback, sender=self)\nComharthaí a sheolann an croíchreat agus iarratas á phróiseáil.
\n\niarraidh_tosaithLink to this heading#Seoltar nuair a thosaíonn Django ag próiseáil iarratas HTTP.
\nArgóintí a sheoltar leis an comhartha seo:
\n\niarraidh_críochnaitheLink to this heading#Seoltar nuair a chríochnaíonn Django freagra HTTP a sheachadadh don chliant.
\nArgóintí a sheoltar leis an comhartha seo:
\nAn rang láimhseálaithe, mar atá thuas.
\nGot_iarrth_eisceachtLink to this heading#Seoltar an comhartha seo aon uair a thagann Django le heisceacht agus iarratas HTTP ag teacht isteach á phróiseáil.
\nArgóintí a sheoltar leis an comhartha seo:
\n\n<running-tests>Ní sheoltar comharthaí ach nuair:ref: `tástálacha reatha `.
\nsetting_athraitheLink to this heading#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.
\nSeoltar é 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.
\nIs 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:
\nAn láimhseálaí socruithe.
\nSocraitheAinm an suímh.
\nluachLuach an shocraithe tar éis an athraithe. Maidir le socruithe nach bhfuil ann i dtosach, sa chéim “teardown”, is é luach None.
Boolean; True má chuirtear an socrú i bhfeidhm, False má athchóiritear é.
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.
\nArgóintí a sheoltar leis an comhartha seo:
\nAn réad: Class: ~Django.Template.Template a rinneadh.
\nTeimpléadMar an gcéanna le seoltóir
\ncomhthéacsAn: class: ~django.template.context ar rinneadh an teimpléad leis.
\nComharthaí a sheolann an fillteoir bunachar sonraí nuair a thioctar nasc bunachar sonraí.
\nnasc_cruthaitheadLink to this heading#Sent when the database wrapper makes the initial connection to the\ndatabase. This is particularly useful if you'd like to send any post\nconnection commands to the SQL backend.
\nArgóintí a sheoltar leis an comhartha seo:
\nAn rang timfhilleadh bunachar sonraí - ie Django.db.backends.postgresql.databaseWrapper nó Django.db.backends.mysql.databaseWrapper, srl.
nascAn 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
\nSignals sent by the tasks framework.
\ntask_enqueuedLink to this heading#Sent once a Task has been enqueued.
\nArgóintí a sheoltar leis an comhartha seo:
\nThe backend class which the Task was enqueued on to.
\ntask_resultThe enqueued TaskResult.
task_startedLink to this heading#Sent when a Task has started executing.
\nArgóintí a sheoltar leis an comhartha seo:
\nThe backend class which the Task was enqueued on to.
\ntask_resultThe started TaskResult.
task_finishedLink to this heading#Sent once a Task has finished executing, successfully or otherwise.
\nArgóintí a sheoltar leis an comhartha seo:
\nThe backend class which the Task was enqueued on to.
\ntask_resultThe finished TaskResult.