Paketet django.shortcuts samlar hjälpfunktioner och klasser som ”spänner över” flera nivåer av MVC. Med andra ord introducerar dessa funktioner/klasser kontrollerad koppling för bekvämlighetens skull.
render()Link to this heading#Kombinerar en given mall med en given kontextordbok och returnerar ett HttpResponse-objekt med den återgivna texten.
Django erbjuder ingen genvägsfunktion som returnerar en TemplateResponse, eftersom konstruktorn för TemplateResponse erbjuder samma bekvämlighet som render().
begäranDet request-objekt som används för att generera detta svar.
\ntemplate_nameDet fullständiga namnet på en mall som ska användas eller en sekvens av mallnamn. Om en sekvens anges kommer den första mallen som finns att användas. Se dokumentation för laddning av mallar för mer information om hur mallar hittas.
\nkontextEn ordlista med värden som ska läggas till i mallkontexten. Som standard är detta en tom ordbok. Om ett värde i ordlistan är anropsbart kommer vyn att anropa det precis innan mallen renderas.
\ninnehållstypDen MIME-typ som ska användas för det resulterande dokumentet. Standardvärdet är 'text/html'.
statusStatuskoden för svaret. Standardvärdet är 200.
använderNAME för en mallmotor som ska användas för att ladda mallen.
I följande exempel återges mallen myapp/index.html med MIME-typen application/xhtml+xml:
from django.shortcuts import render\n\n\ndef my_view(request):\n # View code here...\n return render(\n request,\n "myapp/index.html",\n {\n "foo": "bar",\n },\n content_type="application/xhtml+xml",\n )\nDetta exempel är likvärdigt med:
\nfrom django.http import HttpResponse\nfrom django.template import loader\n\n\ndef my_view(request):\n # View code here...\n t = loader.get_template("myapp/index.html")\n c = {"foo": "bar"}\n return HttpResponse(t.render(c, request), content_type="application/xhtml+xml")\nomdirigera()Link to this heading#Returnerar en HttpResponseRedirect till lämplig URL för de argument som skickas.
Argumenten skulle kunna vara:
\nEn modell: modellens funktion get_absolute_url() anropas.
Ett namn på vyn, eventuellt med argument: reverse() kommer att användas för att lösa upp namnet bakåt.
En absolut eller relativ URL, som kommer att användas som den är för omdirigeringsplatsen.
Som standard utfärdas en tillfällig omdirigering med en 302-statuskod. Om permanent=True utfärdas en permanent omdirigering med en 301-statuskod.
Om preserve_request=True, instruerar svaret användaragenten att bevara metoden och innehållet i den ursprungliga begäran när omdirigeringen utfärdas. I det här fallet används statuskod 307 för tillfälliga omdirigeringar och statuskod 308 för permanenta omdirigeringar. Detta illustreras bättre i följande tabell:
permanent | \nbevara_begäran | \nHTTP-statuskod | \n
|---|---|---|
| \n
| \n301 | \n
| \n
| \n302 | \n
| \n
| \n307 | \n
| \n
| \n308 | \n
Ett valfritt nyckelordsargument max_length kan anges för att åsidosätta den maximalt tillåtna längden på omdirigerings-URL:en. Ange det till None för att inaktivera längdkontrollen.
Du kan använda funktionen redirect() på flera olika sätt.
Genom att skicka något objekt kommer objektets get_absolute_url()-metod att anropas för att räkna ut omdirigeringsadressen:
from django.shortcuts import redirect\n\n\ndef my_view(request):\n ...\n obj = MyModel.objects.get(...)\n return redirect(obj)\nGenom att skicka namnet på en vy och eventuellt några positionella eller nyckelordsargument; URL:en kommer att lösas omvänt med hjälp av reverse()-metoden:
def my_view(request):\n ...\n return redirect("some-view-name", foo="bar")\nGenom att ange en hårdkodad URL att omdirigera till:
\ndef my_view(request):\n ...\n return redirect("/some/url/")\nDetta fungerar även med fullständiga webbadresser:
\ndef my_view(request):\n ...\n return redirect("https://example.com/")\nSom standard returnerar redirect() en tillfällig omdirigering. Alla ovanstående formulär accepterar ett permanent argument; om det sätts till True kommer en permanent omdirigering att returneras:
def my_view(request):\n ...\n obj = MyModel.objects.get(...)\n return redirect(obj, permanent=True)\nDessutom kan argumentet preserve_request användas för att bevara den ursprungliga HTTP-metoden:
def my_view(request):\n # ...\n obj = MyModel.objects.get(...)\n if request.method in ("POST", "PUT"):\n # Redirection preserves the original request method.\n return redirect(obj, preserve_request=True)\n # ...\nresolve_url()Link to this heading#Returnerar en URL-sträng genom att slå upp och normalisera det angivna argumentet to till en konkret URL. Parametern to kan vara:
Ett objekt som implementerar get_absolute_url(), varvid metoden anropas och resultatet returneras.
Ett vynamn, en vyfunktion eller en vyklass, eventuellt med argument som skickas som *args och **kwargs. I så fall används reverse() för att slå upp vyn omvänt.
En URL-sträng som returneras oförändrad.
Den här funktionen används internt av genvägen redirect() för att fastställa mål-URL:en för omdirigeringen.
Slå upp en URL för en modell som definierar get_absolute_url():
modeller.pyfrom django.db import models\nfrom django.urls import reverse\n\n\nclass Article(models.Model):\n title = models.CharField(max_length=100)\n\n def get_absolute_url(self):\n return reverse("article-detail", args=[self.pk])\nVyer.pyfrom django.http import JsonResponse\nfrom django.shortcuts import get_object_or_404, resolve_url\nfrom .models import Article\n\n\ndef article_api_view(request, pk):\n """Return metadata about an article, including its canonical URL."""\n article = get_object_or_404(Article, pk=pk)\n return JsonResponse(\n {\n "id": article.pk,\n "title": article.title,\n "url": resolve_url(article),\n }\n )\nSlå upp en mål-URL för användning utanför en omdirigering, till exempel i ett HTTP-svarshuvud:
\nfrom django.conf import settings\nfrom django.http import HttpResponse\nfrom django.shortcuts import resolve_url\n\n\ndef login_success(request):\n response = HttpResponse("Login successful")\n response["X-Next-URL"] = resolve_url(settings.LOGIN_REDIRECT_URL)\n return response\nget_object_or_404()Link to this heading#Asynkron version: aget_object_or_404()
Anropar get() på en given modellhanterare, men utlöser Http404 i stället för modellens undantag DoesNotExist.
Följande exempel hämtar objektet med primärnyckeln 1 från MyModel:
from django.shortcuts import get_object_or_404\n\n\ndef my_view(request):\n obj = get_object_or_404(MyModel, pk=1)\nDetta exempel är likvärdigt med:
\nfrom django.http import Http404\n\n\ndef my_view(request):\n try:\n obj = MyModel.objects.get(pk=1)\n except MyModel.DoesNotExist:\n raise Http404("No MyModel matches the given query.")\nDet vanligaste användningsfallet är att skicka en Model, som visas ovan. Men du kan också skicka en QuerySet-instans:
queryset = Book.objects.filter(title__startswith="M")\nget_object_or_404(queryset, pk=1)\nExemplet ovan är lite konstruerat eftersom det motsvarar att göra:
\nget_object_or_404(Book, title__startswith="M", pk=1)\nmen det kan vara användbart om du får variabeln queryset från någon annanstans.
Slutligen kan du också använda en Manager. Detta är användbart till exempel om du har en custom manager:
get_object_or_404(Book.dahl_objects, title="Matilda")\nDu kan också använda related managers:
author = Author.objects.get(name="Roald Dahl")\nget_object_or_404(author.book_set, title="Matilda")\nObservera: Precis som med get() kommer ett MultipleObjectsReturned undantag att uppstå om mer än ett objekt hittas.
get_list_or_404()Link to this heading#Asynkron version: aget_list_or_404()
Returnerar resultatet av filter() på en given modellhanterare omvandlat till en lista och utlöser Http404 om den resulterande listan är tom.
Följande exempel hämtar alla publicerade objekt från MyModel:
from django.shortcuts import get_list_or_404\n\n\ndef my_view(request):\n my_objects = get_list_or_404(MyModel, published=True)\nDetta exempel är likvärdigt med:
\nfrom django.http import Http404\n\n\ndef my_view(request):\n my_objects = list(MyModel.objects.filter(published=True))\n if not my_objects:\n raise Http404("No MyModel matches the given query.")\n