Sebuah daftar dari semua sinyal yang Django kirim. Semua sinyal siap-pakai dikirim menggunakan metode send().
Modul django.db.models.signals menentukan sekumpulan sinyal dikirim oleh sistem model.
pre_initLink to this heading#Whenever you instantiate a Django model, this signal is sent at the beginning\nof the model's __init__() method.
Argumen dikirim dengan dinyal ini:
\nsenderKelas model yang baru mempunyai sebuah instance yang dibuat.
\nargsA list of positional arguments passed to __init__().
kwargsA dictionary of keyword arguments passed to __init__().
For example, the tutorial has this line:
\nq = Question(question_text="What's new?", pub_date=timezone.now())\nArgumen dikirim ke penangan pre_init akan berupa:
Argument | \nNilai | \n
|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
post_initLink to this heading#Seperti pre_init, tetapi satu ini dikirim ketika metode __init__() selesai.
Argumen dikirim dengan dinyal ini:
\nsenderSeperti diatas, kelas model yang baru mempunyai sebuah instance dibuat.
\ninstanceInstance sebenarnya dari model yang baru saja dibuat.
\n\npre_saveLink to this heading#Ini dikirim pada awal dari metode save() model.
Argumen dikirim dengan dinyal ini:
\nsenderKelas model.
\ninstanceInstance sebenarnya sedang disimpan.
\nrawA boolean; True if the model is saved exactly as presented\n(i.e. when loading a fixture). One should not\nquery/modify other records in the database as the database might not be in\na consistent state yet.
menggunakanNama lain basisdata sedang digunakan.
\nupdate_fieldsKumpulan dari bidang untuk memperbaharui seperti dilewatkan ke Model.save(), atau None jika update_fields tidak dilewatkan ke save().
post_saveLink to this heading#Seperti pre_save, tetapi dikirim pada akhir dari metode save().
Argumen dikirim dengan dinyal ini:
\nsenderKelas model.
\ninstanceInstance sebenarnya sedang disimpan.
\ncreatedBoolean; True jika sebuah rekaman baru telah dibuat.
rawA boolean; True if the model is saved exactly as presented\n(i.e. when loading a fixture). One should not\nquery/modify other records in the database as the database might not be in\na consistent state yet.
menggunakanNama lain basisdata sedang digunakan.
\nupdate_fieldsKumpulan dari bidang untuk memperbaharui seperti dilewatkan ke Model.save(), atau None jika update_fields tidak dilewatkan ke save().
pre_deleteLink to this heading#Dikirim pada awal dari metode delete() model dan metode delete() queryset.
Argumen dikirim dengan dinyal ini:
\nsenderKelas model.
\ninstanceInstance sebenarnya sedang dihapus.
\nmenggunakanNama lain basisdata sedang digunakan.
\noriginThe Model or QuerySet instance from which the deletion originated,\nthat is, the instance whose delete() method was invoked.
post_deleteLink to this heading#Like pre_delete, but sent at the end of a model's\ndelete() method and a queryset's\ndelete() method.
Argumen dikirim dengan dinyal ini:
\nsenderKelas model.
\ninstanceInstance sebenarnya sedang dihapus.
\nCatat bahwa obyek tidak akan lagi berada dalam basisdata, jadi waspadalah apa yang anda lakukan dengan contoh ini.
\nmenggunakanNama lain basisdata sedang digunakan.
\noriginThe Model or QuerySet instance from which the deletion originated,\nthat is, the instance whose delete() method was invoked.
m2m_changedLink to this heading#Dikirim ketika a ManyToManyField dirubah pada instance model. Berbicara dengan ketat, ini bukan sebuah sinyal model karena itu dikirim oleh ManyToManyField, tetapi sejak itu melengkapi pre_save/post_save dan pre_delete/post_delete ketika itu datang untuk melacak perubahan pada model, itu disertakan disini.
Argumen dikirim dengan dinyal ini:
\nsenderThe intermediate model class describing the\nManyToManyField. This class is automatically\ncreated when a many-to-many field is defined; you can access it using the\nthrough attribute on the many-to-many field.
instanceThe instance whose many-to-many relation is updated. This can be an\ninstance of the sender, or of the class the\nManyToManyField is related to.
actionSebuah string menunjukkan jenis dari pembaharuan yang selesai pada hubungan. Ini dapat berupa satu dari berikut:
\n"pre_add"Dikirim sebelum satu atau lebih obyek ditambahkan ke hubungan.
\n"post_add"Dikirim setelah satu atau lebih obyek ditambahkan pada hubungan.
\n"pre_remove"Dikirim sebelum satu atau lebih obyek dipindahkan dari hubungan.
\n"post_remove"Dikirim setelah satu atau lebih obyek dipindahkan dari hubungan.
\n"pre_clear"Dikirim sebelum hubungan dibersihkan.
\n"post_clear"Dikirim*setelah* hubungan dibersihkan.
\nreverseIndicates which side of the relation is updated (i.e., if it is the\nforward or reverse relation that is being modified).
\nmodelKelas dari obyek-byek yang ditambahkan juga, dipindahkan dari atau dibersihkan dari hubungan.
\npk_setFor the pre_add and post_add actions, this is a set of primary key\nvalues that will be, or have been, added to the relation. This may be a\nsubset of the values submitted to be added, since inserts must filter\nexisting values in order to avoid a database IntegrityError.
For the pre_remove and post_remove actions, this is a set of\nprimary key values that was submitted to be removed from the relation. This\nis not dependent on whether the values actually will be, or have been,\nremoved. In particular, non-existent values may be submitted, and will\nappear in pk_set, even though they have no effect on the database.
Untuk tindakan pre_clear dan post_clear, ini adalah None.
menggunakanNama lain basisdata sedang digunakan.
\nSebagai contoh, jika sebuah Pizza dapat memiliki banyak obyek Topping, dimodelkan seperti ini:
class Topping(models.Model):\n # ...\n pass\n\n\nclass Pizza(models.Model):\n # ...\n toppings = models.ManyToManyField(Topping)\nJika kami menghubungkan penangan seperti ini:
\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)\nand then did something like this:
\n>>> p = Pizza.objects.create(...)\n>>> t = Topping.objects.create(...)\n>>> p.toppings.add(t)\nargumen-argumen dikirim ke penangan m2m_changed (toppings_changed dalam contoh diatas) akan menjadi:
Argument | \nNilai | \n
|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
And if we would then do something like this:
\n>>> t.pizza_set.remove(p)\nargumen dikirim ke penangan m2m_changed akan berupa:
Argument | \nNilai | \n
|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
class_preparedLink to this heading#Sent whenever a model class has been "prepared" -- that is, once a model has\nbeen defined and registered with Django's model system. Django uses this\nsignal internally; it's not generally used in third-party applications.
\nSejak sinyal ini dikirim selama pengolahan pengumpulan registrar aplikasi, dan AppConfig.ready() berjalan setelah registrar sepenuhnya dikumpulkan, penerima tidak dapat dihubungkan di metode itu. Satu kemungkinan adalah menghubungkan mereka AppConfig.__init__() sebagai gantinya, merawat tidak untuk mengimpor model atau panggilan pemicu pada registrar aplikasi.
Argumen-argumen yang dikirim dengan sinyal ini:
\nsenderKelas model yang telah dipersiapkan.
\nSinyal dikirim oleh django-admin.
\npre_migrateLink to this heading#Sent by the migrate command before it starts to install an\napplication. It's not emitted for applications that lack a models module.
Argumen dikirim dengan dinyal ini:
\nsenderSebuah instance AppConfig untuk aplikasi tentang untuk dipindahkan/disinkronisasikan.
app_configSama seperti sender.
verbosityIndicates how much information manage.py is printing on screen. See\nthe --verbosity flag for details.
Fungsi-fungsi yang mendengarkan untuk pre_migrate harus menyesuaikan apa mereka keluarkan ke layar berdasarkan pada nilai dari argumen ini.
interactiveIf interactive is True, it's safe to prompt the user to input\nthings on the command line. If interactive is False, functions\nwhich listen for this signal should not try to prompt for anything.
Sebagai contoh, aplikasi django.contrib.auth hanya menunjuk untuk membuat pengguna super ketika interactive adalah True.
stdoutA stream-like object where verbose output should be redirected.
\nmenggunakanNama lain dari basisdata dimana sebuah perintah akan beroperasi.
\nplanThe migration plan that is going to be used for the migration run. While\nthe plan is not public API, this allows for the rare cases when it is\nnecessary to know the plan. A plan is a list of 2-tuples with the first\nitem being the instance of a migration class and the second item showing\nif the migration was rolled back (True) or applied (False).
appsSebuah instance dari Apps mengandung keadaan dari proyek sebelum perpindahan berjalan. Itu harus digunakan sebagai gantinya dari registrar apps global untuk mengambil model yang anda ingin lakukan tindakan.
post_migrateLink to this heading#Dikirim pada akhir dari migrate (bahkan jika tidak ada perpindahan dijalankan) dan perintah flush. Itu tidak dikeluarkan untuk aplikasi yang kekurangan modeul models.
Handlers of this signal must not perform database schema alterations as doing\nso may cause the flush command to fail if it runs during the\nmigrate command.
Argumen dikirim dengan dinyal ini:
\nsenderInstance AppConfig untuk aplikasi yang telah dipasang.
app_configSama seperti sender.
verbosityIndicates how much information manage.py is printing on screen. See\nthe --verbosity flag for details.
Fungsi-fungsi yang mendengarkan untuk post_migrate harus menyesuaikan apa mereka keluarkan ke layar berdasarkan pada nilai dari argumen ini.
interactiveIf interactive is True, it's safe to prompt the user to input\nthings on the command line. If interactive is False, functions\nwhich listen for this signal should not try to prompt for anything.
Sebagai contoh, aplikasi django.contrib.auth hanya menunjuk untuk membuat pengguna super ketika interactive adalah True.
stdoutA stream-like object where verbose output should be redirected.
\nmenggunakanNama lain basisdata digunakan untuk sinkronisasi. Awalan pada basisdata default.
planThe migration plan that was used for the migration run. While the plan is\nnot public API, this allows for the rare cases when it is necessary to\nknow the plan. A plan is a list of 2-tuples with the first item being\nthe instance of a migration class and the second item showing if the\nmigration was rolled back (True) or applied (False).
appsSebuah instance dari Apps mengandung keadaan dari proyek setelah perpindahan berjalan. Itu harus digunakan sebagai gantinya dari registrar apps global untuk mengambil model yang anda ingin lakukan tindakan.
Sebagai contoh, anda dapat mendaftarkan sebuah callback dalam sebuah AppConfig seperti ini:
from 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)\nSinyal dikirim oleh kerangka kerja inti ketika mengolah sebuah permintaan.
\n\nrequest_startedLink to this heading#Dikirim ketika Django mulai mengolah sebuah permintaan HTTP.
\nArgumen dikirim dengan dinyal ini:
\nsenderKelas penangan -- misalnya django.core.handlers.wsgi.WsgiHandler -- yang menangani permintaan.
environDictionary environ disediakan pada permintaan.
request_finishedLink to this heading#Dikirim ketika Django selesai mengirimkan sebuah tanggapan HTTP ke klien.
\nArgumen dikirim dengan dinyal ini:
\nsenderKelas penangan, seperti diatas.
\ngot_request_exceptionLink to this heading#Sinyal ini dikirim ketika Django menghadapi sebuah pengecualian selagi mengolah sebuah permintaan HTTP yang datang.
\nArgumen dikirim dengan dinyal ini:
\nsenderTidak digunakan (selalu None).
requestObyek HttpRequest
Sinyal hanya dikirim ketika running tests.
\nsetting_changedLink to this heading#Sinyal dikirim ketika nilai dari pengaturan berubah melalui pengelola konteks django.test.TestCase.settings() atau pengelola penghias/konteks django.test.override_settings().
It's actually sent twice: when the new value is applied ("setup") and when the\noriginal value is restored ("teardown"). Use the enter argument to\ndistinguish between the two.
Anda dapat juga mengimpor sinyal dari django.core.signals untuk menghindari impor dari django.test dalam keadaan bukan-percobaan.
Argumen dikirim dengan dinyal ini:
\nsenderPenangan percobaan.
\nsettingNama dari pengaturan.
\nvalueNilai dari pengaturan setelah berubah. Untuk pengaturan yang awalnya tidak ada, dalam fase "teardown", value adalah None.
enterBoolean; True jika pengaturan diberlakukan, False jika disimpan kembali.
template_renderedLink to this heading#Dikirim ketika sistem percobaan membangun sebuah cetakan. Siyal ini tidak dikeluarkan selama tindakan biasa dari peladen Django -- itu hanya tersedia selama percobaan.
\nArgumen dikirim dengan dinyal ini:
\n\nSinyal dikirim oleh pembungkus basisdata ketika hubungan basisdata dimulai.
\nconnection_createdLink 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.
\nArgumen dikirim dengan dinyal ini:
\nsenderKelas pembungkus basisdata -- yaitu. django.db.backends.postgresql.DatabaseWrapper atau django.db.backends.mysql.DatabaseWrapper, dll.
connectionThe database connection that was opened. This can be used in a\nmultiple-database configuration to differentiate connection signals\nfrom different databases.
\nSignals sent by the tasks framework.
\ntask_enqueuedLink to this heading#Sent once a Task has been enqueued.
\nArgumen dikirim dengan dinyal ini:
\nsenderThe 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.
\nArgumen dikirim dengan dinyal ini:
\nsenderThe 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.
\nArgumen dikirim dengan dinyal ini:
\nsenderThe backend class which the Task was enqueued on to.
\ntask_resultThe finished TaskResult.