Untuk membantu anda memahami dan mengendalikan permintaan dengan kode anda, Django menyediakan sebuah kaitan untuk memasang fungsi pembungkus disekitar penjalanan dari permintaan basisdata. Sebagai contoh, pembungkus dapat menghitung permintaan, mengukur lama permintaan, mencatat permintaan, atau bahkan mencegah penjalanan permintaan (sebagai contoh memastikan bahwa tidak ada permintaan diterbitkan selagi membangun cetakan dengan data pra pengambilan).
\nPembungkus-pembungkus dimodelkan setelah middleware 1 -- mereka adalah callable yang mengambil callable lain sebagai argumen mereka. Mereka memanggil bahwa callable untuk meminta (kemungkinan dibungkus) permintaan basisdata, dan mereka dapat melakukan apa mereka ingin disekitaran panggilan itu. Mereka adalah, bagaimanapun, dibuat dan dipasang oleh kode pengguna, dan jadi tidak butuh memisahkan factory seperti middleware lakukan.
\nMemasang sebuah pembungkus selesai dalam sebuah pengelola konteks -- jadi pembungkus adalah sementara dan tertentu pada beberapa alur di kode anda.
\nSeperti disebutkan diatas, sebuah contoh dari sebuah pembungkus adalah penghadang penjalanan permintaan. Itu dapat terlihat seperti ini:
\ndef blocker(*args):\n raise Exception('No database access allowed here.')\nDan itu akan digunakan dalam sebuah tampilan untuk menghadang permintaan dari cetakan seperti berikut:
\nfrom django.db import connection\nfrom django.shortcuts import render\n\ndef my_view(request):\n context = {...} # Code to generate context with all data.\n template_name = ...\n with connection.execute_wrapper(blocker):\n return render(request, template_name, context)\nParameter dikirim ke pembungkus adalah:
\nmiddleware 1 -- sebuah callable, yang harus diminta dengan sisa dari parameter untuk menjalankan permintaan.
sql -- sebuah str, permintaan SQL dikirim ke basisdata.
params -- sebuah list/tuple dari nilai-nilai parameter untuk perintah SQL, atau list/tuple dari list/tuple jika panggilan dibungkus adalah executemany().
many -- sebuah bool menunjukkan akhirnya panggilan dipangil adalah execute() atau executemany() (dan apakah params diharapkan menjadi berurut dari nilai-nilai, atau urutan dari urutan-urutan dari nilai-nilai).
context -- sebuah dictionary dengan data lebih lanjut tentang konteks dari permohonan. Ini menyertakan hubungan dan kursor.
Menggunakan parameter, versi sedikit lebih rumit dari penghadang dapat menyertakan nama hubungan dalam pesan kesalahan:
\ndef blocker(execute, sql, params, many, context):\n alias = context['connection'].alias\n raise Exception("Access to database '{}' blocked here".format(alias))\nUntuk contoh lebih lengkap, sebuah pencatat permintaan dapat terlihat seperti ini:
\nimport time\n\nclass QueryLogger:\n\n def __init__(self):\n self.queries = []\n\n def __call__(self, execute, sql, params, many, context):\n current_query = {'sql': sql, 'params': params, 'many': many}\n start = time.time()\n try:\n result = execute(sql, params, many, context)\n except Exception as e:\n current_query['status'] = 'error'\n current_query['exception'] = e\n raise\n else:\n current_query['status'] = 'ok'\n return result\n finally:\n duration = time.time() - start\n current_query['duration'] = duration\n self.queries.append(current_query)\nUntuk menggunakan ini, anda dapat membuat sebuah obyek pencatat dan memasang itu sebagai pembungkus:
\nfrom django.db import connection\n\nql = QueryLogger()\nwith connection.execute_wrapper(ql):\n do_queries()\n# Now we can print the log.\nprint(ql.queries)\nconnection.execute_wrapper()Link to this heading#Mengembalikan pengeola konteks yang, ketika dimasukkan, memasang sebuah pembungkus disekitar penjalanan permintaan basisdata, dan ketika keluar, memindahkan pembungkus. Pembungkus dipasang pada obyek hubungan lokal-thread.
\nwrapper adalah sebuah callable mengambil lima argumen. Itu dipanggil untuk setiap penjalanan permintaan dalam cakupan dari pengelola konteks, dengan argumen execute, sql, params, many, dan context sebagai digambarkan diatas. Itu diharapkan memanggil execute(sql, params, many, context) dan mengembalikan nilai balikan dari panggilan itu.