SinyalLink to this heading
Sebuah daftar dari semua sinyal yang Django kirim. Semua sinyal siap-pakai dikirim menggunakan metode send().
Sinyal modelLink to this heading
Modul django.db.models.signals menentukan sekumpulan sinyal dikirim oleh sistem model.
pre_initLink to this heading
- django.db.models.signals.pre_initLink to this definition
Whenever you instantiate a Django model, this signal is sent at the beginning
of the model's __init__() method.
Argumen dikirim dengan dinyal ini:
senderKelas model yang baru mempunyai sebuah instance yang dibuat.
argsA list of positional arguments passed to
__init__().kwargsA dictionary of keyword arguments passed to
__init__().
For example, the tutorial has this line:
q = Question(question_text="What's new?", pub_date=timezone.now())
Argumen dikirim ke penangan pre_init akan berupa:
Argument |
Nilai |
|---|---|
|
|
|
|
|
|
post_initLink to this heading
- django.db.models.signals.post_initLink to this definition
Seperti pre_init, tetapi satu ini dikirim ketika metode __init__() selesai.
Argumen dikirim dengan dinyal ini:
senderSeperti diatas, kelas model yang baru mempunyai sebuah instance dibuat.
instanceInstance sebenarnya dari model yang baru saja dibuat.
pre_saveLink to this heading
- django.db.models.signals.pre_saveLink to this definition
Ini dikirim pada awal dari metode save() model.
Argumen dikirim dengan dinyal ini:
senderKelas model.
instanceInstance sebenarnya sedang disimpan.
rawA boolean;
Trueif the model is saved exactly as presented (i.e. when loading a fixture). One should not query/modify other records in the database as the database might not be in a consistent state yet.menggunakanNama lain basisdata sedang digunakan.
update_fieldsKumpulan dari bidang untuk memperbaharui seperti dilewatkan ke
Model.save(), atauNonejikaupdate_fieldstidak dilewatkan kesave().
post_saveLink to this heading
- django.db.models.signals.post_saveLink to this definition
Seperti pre_save, tetapi dikirim pada akhir dari metode save().
Argumen dikirim dengan dinyal ini:
senderKelas model.
instanceInstance sebenarnya sedang disimpan.
createdBoolean;
Truejika sebuah rekaman baru telah dibuat.rawA boolean;
Trueif the model is saved exactly as presented (i.e. when loading a fixture). One should not query/modify other records in the database as the database might not be in a consistent state yet.menggunakanNama lain basisdata sedang digunakan.
update_fieldsKumpulan dari bidang untuk memperbaharui seperti dilewatkan ke
Model.save(), atauNonejikaupdate_fieldstidak dilewatkan kesave().
pre_deleteLink to this heading
- django.db.models.signals.pre_deleteLink to this definition
Dikirim pada awal dari metode delete() model dan metode delete() queryset.
Argumen dikirim dengan dinyal ini:
senderKelas model.
instanceInstance sebenarnya sedang dihapus.
menggunakanNama lain basisdata sedang digunakan.
origin
The origin of the deletion being the instance of a
ModelorQuerySetclass.
post_deleteLink to this heading
- django.db.models.signals.post_deleteLink to this definition
Like pre_delete, but sent at the end of a model's
delete() method and a queryset's
delete() method.
Argumen dikirim dengan dinyal ini:
senderKelas model.
instanceInstance sebenarnya sedang dihapus.
Catat bahwa obyek tidak akan lagi berada dalam basisdata, jadi waspadalah apa yang anda lakukan dengan contoh ini.
menggunakanNama lain basisdata sedang digunakan.
origin
The origin of the deletion being the instance of a
ModelorQuerySetclass.
m2m_changedLink to this heading
- django.db.models.signals.m2m_changedLink to this definition
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:
senderThe intermediate model class describing the
ManyToManyField. This class is automatically created when a many-to-many field is defined; you can access it using thethroughattribute on the many-to-many field.instanceThe instance whose many-to-many relation is updated. This can be an instance of the
sender, or of the class theManyToManyFieldis related to.actionSebuah string menunjukkan jenis dari pembaharuan yang selesai pada hubungan. Ini dapat berupa satu dari berikut:
"pre_add"Dikirim sebelum satu atau lebih obyek ditambahkan ke hubungan.
"post_add"Dikirim setelah satu atau lebih obyek ditambahkan pada hubungan.
"pre_remove"Dikirim sebelum satu atau lebih obyek dipindahkan dari hubungan.
"post_remove"Dikirim setelah satu atau lebih obyek dipindahkan dari hubungan.
"pre_clear"Dikirim sebelum hubungan dibersihkan.
"post_clear"Dikirim*setelah* hubungan dibersihkan.
reverseIndicates which side of the relation is updated (i.e., if it is the forward or reverse relation that is being modified).
modelKelas dari obyek-byek yang ditambahkan juga, dipindahkan dari atau dibersihkan dari hubungan.
pk_setFor the
pre_addandpost_addactions, this is a set of primary key values that will be, or have been, added to the relation. This may be a subset of the values submitted to be added, since inserts must filter existing values in order to avoid a databaseIntegrityError.For the
pre_removeandpost_removeactions, this is a set of primary key values that was submitted to be removed from the relation. This is not dependent on whether the values actually will be, or have been, removed. In particular, non-existent values may be submitted, and will appear inpk_set, even though they have no effect on the database.Untuk tindakan
pre_cleardanpost_clear, ini adalahNone.menggunakanNama lain basisdata sedang digunakan.
Sebagai contoh, jika sebuah Pizza dapat memiliki banyak obyek Topping, dimodelkan seperti ini:
class Topping(models.Model):
# ...
pass
class Pizza(models.Model):
# ...
toppings = models.ManyToManyField(Topping)
Jika kami menghubungkan penangan seperti ini:
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)
and then did something like this:
>>> p = Pizza.objects.create(...)
>>> t = Topping.objects.create(...)
>>> p.toppings.add(t)
argumen-argumen dikirim ke penangan m2m_changed (toppings_changed dalam contoh diatas) akan menjadi:
Argument |
Nilai |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
And if we would then do something like this:
>>> t.pizza_set.remove(p)
argumen dikirim ke penangan m2m_changed akan berupa:
Argument |
Nilai |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class_preparedLink to this heading
- django.db.models.signals.class_preparedLink to this definition
Sent whenever a model class has been "prepared" -- that is, once a model has been defined and registered with Django's model system. Django uses this signal internally; it's not generally used in third-party applications.
Sejak 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:
senderKelas model yang telah dipersiapkan.
Pengelolaan sinyalLink to this heading
Sinyal dikirim oleh django-admin.
pre_migrateLink to this heading
- django.db.models.signals.pre_migrateLink to this definition
Sent by the migrate command before it starts to install an
application. It's not emitted for applications that lack a models module.
Argumen dikirim dengan dinyal ini:
senderSebuah instance
AppConfiguntuk aplikasi tentang untuk dipindahkan/disinkronisasikan.app_configSama seperti
sender.verbosityIndicates how much information
manage.pyis printing on screen. See the--verbosityflag for details.Fungsi-fungsi yang mendengarkan untuk
pre_migrateharus menyesuaikan apa mereka keluarkan ke layar berdasarkan pada nilai dari argumen ini.interactiveIf
interactiveisTrue, it's safe to prompt the user to input things on the command line. IfinteractiveisFalse, functions which listen for this signal should not try to prompt for anything.Sebagai contoh, aplikasi
django.contrib.authhanya menunjuk untuk membuat pengguna super ketikainteractiveadalahTrue.stdoutA stream-like object where verbose output should be redirected.
menggunakanNama lain dari basisdata dimana sebuah perintah akan beroperasi.
planThe migration plan that is going to be used for the migration run. While the plan is not public API, this allows for the rare cases when it is necessary to know the plan. A plan is a list of 2-tuples with the first item being the instance of a migration class and the second item showing if the migration was rolled back (
True) or applied (False).appsSebuah instance dari
Appsmengandung keadaan dari proyek sebelum perpindahan berjalan. Itu harus digunakan sebagai gantinya dari registrarappsglobal untuk mengambil model yang anda ingin lakukan tindakan.
post_migrateLink to this heading
- django.db.models.signals.post_migrateLink to this definition
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
so may cause the flush command to fail if it runs during the
migrate command.
Argumen dikirim dengan dinyal ini:
senderInstance
AppConfiguntuk aplikasi yang telah dipasang.app_configSama seperti
sender.verbosityIndicates how much information
manage.pyis printing on screen. See the--verbosityflag for details.Fungsi-fungsi yang mendengarkan untuk
post_migrateharus menyesuaikan apa mereka keluarkan ke layar berdasarkan pada nilai dari argumen ini.interactiveIf
interactiveisTrue, it's safe to prompt the user to input things on the command line. IfinteractiveisFalse, functions which listen for this signal should not try to prompt for anything.Sebagai contoh, aplikasi
django.contrib.authhanya menunjuk untuk membuat pengguna super ketikainteractiveadalahTrue.stdoutA stream-like object where verbose output should be redirected.
menggunakanNama lain basisdata digunakan untuk sinkronisasi. Awalan pada basisdata
default.planThe migration plan that was used for the migration run. While the plan is not public API, this allows for the rare cases when it is necessary to know the plan. A plan is a list of 2-tuples with the first item being the instance of a migration class and the second item showing if the migration was rolled back (
True) or applied (False).appsSebuah instance dari
Appsmengandung keadaan dari proyek setelah perpindahan berjalan. Itu harus digunakan sebagai gantinya dari registrarappsglobal 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
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)
Sinyal permintaan/tanggapanLink to this heading
Sinyal dikirim oleh kerangka kerja inti ketika mengolah sebuah permintaan.
request_startedLink to this heading
- django.core.signals.request_startedLink to this definition
Dikirim ketika Django mulai mengolah sebuah permintaan HTTP.
Argumen dikirim dengan dinyal ini:
senderKelas penangan -- misalnya
django.core.handlers.wsgi.WsgiHandler-- yang menangani permintaan.environDictionary
environdisediakan pada permintaan.
request_finishedLink to this heading
- django.core.signals.request_finishedLink to this definition
Dikirim ketika Django selesai mengirimkan sebuah tanggapan HTTP ke klien.
Argumen dikirim dengan dinyal ini:
senderKelas penangan, seperti diatas.
got_request_exceptionLink to this heading
- django.core.signals.got_request_exceptionLink to this definition
Sinyal ini dikirim ketika Django menghadapi sebuah pengecualian selagi mengolah sebuah permintaan HTTP yang datang.
Argumen dikirim dengan dinyal ini:
senderTidak digunakan (selalu
None).requestObyek
HttpRequest
Sinyal percobaanLink to this heading
Sinyal hanya dikirim ketika running tests.
setting_changedLink to this heading
- django.test.signals.setting_changedLink to this definition
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
original value is restored ("teardown"). Use the enter argument to
distinguish 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:
senderPenangan percobaan.
settingNama dari pengaturan.
valueNilai dari pengaturan setelah berubah. Untuk pengaturan yang awalnya tidak ada, dalam fase "teardown",
valueadalahNone.enterBoolean;
Truejika pengaturan diberlakukan,Falsejika disimpan kembali.
template_renderedLink to this heading
- django.test.signals.template_renderedLink to this definition
Dikirim ketika sistem percobaan membangun sebuah cetakan. Siyal ini tidak dikeluarkan selama tindakan biasa dari peladen Django -- itu hanya tersedia selama percobaan.
Argumen dikirim dengan dinyal ini:
Pembungkus BasisdataLink to this heading
Sinyal dikirim oleh pembungkus basisdata ketika hubungan basisdata dimulai.
connection_createdLink to this heading
- django.db.backends.signals.connection_createdLink to this definition
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.
Argumen dikirim dengan dinyal ini:
senderKelas pembungkus basisdata -- yaitu.
django.db.backends.postgresql.DatabaseWrapperataudjango.db.backends.mysql.DatabaseWrapper, dll.connectionThe database connection that was opened. This can be used in a multiple-database configuration to differentiate connection signals from different databases.