För att hjälpa dig att förstå och kontrollera de frågor som utfärdas av din kod tillhandahåller Django en hook för att installera omslagsfunktioner runt exekveringen av databasfrågor. Till exempel kan wrappers räkna frågor, mäta frågans varaktighet, logga frågor eller till och med förhindra frågeexekvering (t.ex. för att se till att inga frågor utfärdas när du renderar en mall med förhämtade data).
\nOmslagen är modellerade efter middleware – de är anropsbara som tar en annan anropsbar som ett av sina argument. De anropar den anropsbara för att anropa databasfrågan (eventuellt inkapslad), och de kan göra vad de vill runt det anropet. De skapas och installeras dock av användarkoden och behöver därför inte en separat fabrik som middleware gör.
\nInstallationen av en wrapper görs i en kontexthanterare - så wrappers är tillfälliga och specifika för ett visst flöde i din kod.
\nSom nämnts ovan är ett exempel på en wrapper en query execution blocker. Det skulle kunna se ut så här:
\ndef blocker(*args):\n raise Exception("No database access allowed here.")\nOch det skulle användas i en vy för att blockera frågor från mallen så här:
\nfrom django.db import connection\nfrom django.shortcuts import render\n\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)\nDe parametrar som skickas till wrappers är:
\nexecute – en anropsbar, som ska anropas med resten av parametrarna för att utföra frågan.
sql – en str, SQL-frågan som ska skickas till databasen.
params – en lista/tupel av parametervärden för SQL-kommandot, eller en lista/tupel av listor/tuplar om det omslutna anropet är executemany().
many – en bool som anger om det sista anropet är execute() eller executemany() (och om params förväntas vara en sekvens av värden, eller en sekvens av sekvenser av värden).
context – en ordbok med ytterligare data om kontexten för anropet. Detta inkluderar anslutningen och markören.
Med hjälp av parametrarna kan en något mer komplex version av blockeraren inkludera anslutningsnamnet i felmeddelandet:
\ndef blocker(execute, sql, params, many, context):\n alias = context["connection"].alias\n raise Exception("Access to database '{}' blocked here".format(alias))\nFör ett mer komplett exempel kan en frågeloggare se ut så här:
\nimport time\n\n\nclass QueryLogger:\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.monotonic()\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.monotonic() - start\n current_query["duration"] = duration\n self.queries.append(current_query)\nFör att använda detta skapar du ett logger-objekt och installerar det som en wrapper:
\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)\nanslutning.execute_wrapper()Link to this heading#Returnerar en kontexthanterare som, när den anges, installerar en omslagsdel runt exekveringar av databasfrågor, och när den avslutas, tar bort omslagsdelen. Omslaget installeras på det trådlokala anslutningsobjektet.
\nwrapper är en anropbar funktion som tar fem argument. Den anropas för varje frågeexekvering i kontexthanterarens omfattning, med argumenten execute, ql, params, many och context enligt beskrivningen ovan. Den förväntas anropa execute(sql, params, many, context) och returnera returvärdet av det anropet.