Denna tutorial börjar där Tutorial 2 slutade. Vi fortsätter med web-poll applikationen och fokuserar på att skapa det publika gränssnittet – ”views”
\n\nEn vy är en ”typ” av webbsida i din Django-applikation som i allmänhet tjänar en specifik funktion och har en specifik mall. I en bloggapplikation kan du till exempel ha följande vyer:
\nBloggens startsida - visar de senaste inläggen.
Entry ”detail” page – permalänksida för en enskild post.
Årsbaserad arkivsida - visar alla månader med poster under det angivna året.
Månadsbaserad arkivsida - visar alla dagar med poster i den angivna månaden.
Dagbaserad arkivsida - visar alla poster under den aktuella dagen.
Comment action – hanterar kommentarer till en viss post.
I vår poll-applikation kommer vi att ha följande fyra vyer:
\nFråga ”index”-sida - visar de senaste frågorna.
Fråga ”detalj”-sida – visar en frågetext, utan resultat men med ett formulär för att rösta.
Frågans resultatsida - visar resultaten för en viss fråga.
Vote action – hanterar röstning för ett visst val i en viss fråga.
I Django levereras webbsidor och annat innehåll med hjälp av vyer. Varje vy representeras av en Python-funktion (eller metod, i fallet med klassbaserade vyer). Django väljer en vy genom att undersöka den URL som begärs (för att vara exakt, den del av URL:en som kommer efter domännamnet).
\nNu under din tid på webben kanske du har stött på sådana skönheter som ME2/Sites/dirmod.htm?sid=&type=gen&mod=Core+Pages&gid=A6CD4967199A42D9B65B1B. Du kommer att bli glad över att veta att Django tillåter oss mycket mer eleganta URL-mönster än så.
Ett URL-mönster är den allmänna formen av en URL - till exempel: /newsarchive/<year>/<month>/.
För att komma från en URL till en vy använder Django så kallade ”URLconfs”. En URLconf mappar URL-mönster till vyer.
\nDen här handledningen ger grundläggande instruktioner om användningen av URLconfs, och du kan läsa URL-distributör för mer information.
\nLåt oss nu lägga till några fler vyer i polls/views.py. Dessa vyer är lite annorlunda, eftersom de tar ett argument:
polls/views.pydef detail(request, question_id):\n return HttpResponse("You're looking at question %s." % question_id)\n\n\ndef results(request, question_id):\n response = "You're looking at the results of question %s."\n return HttpResponse(response % question_id)\n\n\ndef vote(request, question_id):\n return HttpResponse("You're voting on question %s." % question_id)\nKoppla dessa nya vyer till modulen polls.urls genom att lägga till följande path()-anrop:
polls/urls.pyfrom django.urls import path\n\nfrom . import views\n\nurlpatterns = [\n # ex: /polls/\n path("", views.index, name="index"),\n # ex: /polls/5/\n path("<int:question_id>/", views.detail, name="detail"),\n # ex: /polls/5/results/\n path("<int:question_id>/results/", views.results, name="results"),\n # ex: /polls/5/vote/\n path("<int:question_id>/vote/", views.vote, name="vote"),\n]\nTa en titt i din webbläsare, på ”/polls/34/”. Den kommer att köra funktionen detail() och visa det ID som du anger i URL:en. Prova också ”/polls/34/results/” och ”/polls/34/vote/” - dessa kommer att visa platshållarresultaten och röstningssidorna.
När någon begär en sida från din webbplats - säg, ”/polls/34/”, kommer Django att ladda Python-modulen mysite.urls eftersom den pekas ut av inställningen ROOT_URLCONF. Den hittar variabeln med namnet urlpatterns och går igenom mönstren i ordning. Efter att ha hittat matchningen vid 'polls/', tar den bort den matchande texten ("polls/") och skickar den återstående texten – "34/" – till URLconf ’polls.urls’ för vidare bearbetning. Där matchar den '<int:question_id>/', vilket resulterar i ett anrop till vyn detail() så här:
detail(request=<HttpRequest object>, question_id=34)\nDelen question_id=34 kommer från <int:question_id>. Med hjälp av vinkelparenteser ”fångas” en del av URL:en och skickas som ett nyckelordsargument till view-funktionen. Delen question_id i strängen definierar det namn som ska användas för att identifiera det matchade mönstret, och delen int är en omvandlare som avgör vilka mönster som ska matcha den här delen av URL-sökvägen. Kolonet (:) skiljer omvandlaren och mönsternamnet åt.
Varje vy är ansvarig för att göra en av två saker: returnera ett HttpResponse-objekt som innehåller innehållet för den begärda sidan, eller skapa ett undantag som Http404. Resten är upp till dig.
Din vy kan läsa poster från en databas, eller inte. Den kan använda ett mallsystem som Djangos - eller ett Python-mallsystem från tredje part - eller inte. Den kan generera en PDF-fil, mata ut XML, skapa en ZIP-fil i farten, vad du vill, med hjälp av vilka Python-bibliotek du vill.
\nAllt Django vill ha är den där HttpResponse. Eller ett undantag.
Eftersom det är bekvämt, låt oss använda Djangos egen databas API, som vi täckte i Tutorial 2. Här är ett försök till en ny index() vy, som visar de senaste 5 omröstningsfrågorna i systemet, åtskilda med kommatecken, enligt publiceringsdatum:
polls/views.pyfrom django.http import HttpResponse\n\nfrom .models import Question\n\n\ndef index(request):\n latest_question_list = Question.objects.order_by("-pub_date")[:5]\n output = ", ".join([q.question_text for q in latest_question_list])\n return HttpResponse(output)\n\n\n# Leave the rest of the views (detail, results, vote) unchanged\nThere’s a problem here, though: the page’s design is hardcoded in the view. If\nyou want to change the way the page looks, you’ll have to edit this Python\ncode. So let’s use Django’s template system to separate the design from Python\nby creating a template that the view can use.
\nFörst skapar du en katalog som heter templates i din polls-katalog. Django kommer att leta efter mallar där.
Ditt projekts TEMPLATES-inställning beskriver hur Django ska ladda och rendera mallar. Standardinställningsfilen konfigurerar en DjangoTemplates-backend vars APP_DIRS-alternativ är inställt på True. Enligt konvention letar DjangoTemplates efter en ”templates”-underkatalog i varje INSTALLED_APPS.
I katalogen templates som du just har skapat, skapar du en annan katalog som heter polls, och i den skapar du en fil som heter index.html. Med andra ord bör din mall ligga på polls/templates/polls/index.html. På grund av hur mallladdaren app_directories fungerar enligt beskrivningen ovan, kan du hänvisa till denna mall inom Django som polls/index.html.
Lägg in följande kod i den mallen:
\npolls/templates/polls/index.html{% if latest_question_list %}\n <ul>\n {% for question in latest_question_list %}\n <li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li>\n {% endfor %}\n </ul>\n{% else %}\n <p>No polls are available.</p>\n{% endif %}\nLåt oss nu uppdatera vår vy index i polls/views.py så att den använder mallen:
polls/views.pyfrom django.http import HttpResponse\nfrom django.template import loader\n\nfrom .models import Question\n\n\ndef index(request):\n latest_question_list = Question.objects.order_by("-pub_date")[:5]\n template = loader.get_template("polls/index.html")\n context = {"latest_question_list": latest_question_list}\n return HttpResponse(template.render(context, request))\nDen koden laddar mallen som heter polls/index.html och skickar en kontext till den. Kontexten är en ordbok som mappar mallens variabelnamn till Python-objekt.
Ladda sidan genom att rikta webbläsaren mot ”/polls/”, och du bör se en punktlista som innehåller ”What’s up”-frågan från Tutorial 2. Länken pekar till frågans detaljsida.
\nrender()Link to this heading#Det är ett mycket vanligt idiom att ladda en mall, fylla en kontext och returnera ett HttpResponse-objekt med resultatet av den renderade mallen. Django tillhandahåller en genväg. Här är den fullständiga index()-vyn, omskriven:
polls/views.pyfrom django.shortcuts import render\n\nfrom .models import Question\n\n\ndef index(request):\n latest_question_list = Question.objects.order_by("-pub_date")[:5]\n context = {"latest_question_list": latest_question_list}\n return render(request, "polls/index.html", context)\nObservera att när vi har gjort detta i alla dessa vyer behöver vi inte längre importera loader och HttpResponse (du vill behålla HttpResponse om du fortfarande har stubmetoderna för detail, results och vote).
Funktionen render() tar request-objektet som sitt första argument, ett mallnamn som sitt andra argument och en ordbok som sitt valfria tredje argument. Den returnerar ett HttpResponse-objekt av den givna mallen renderad med den givna kontexten.
Låt oss nu ta itu med vyn för frågedetaljer - den sida som visar frågetexten för en viss undersökning. Här är vyn:
\npolls/views.pyfrom django.http import Http404\nfrom django.shortcuts import render\n\nfrom .models import Question\n\n\n# ...\ndef detail(request, question_id):\n try:\n question = Question.objects.get(pk=question_id)\n except Question.DoesNotExist:\n raise Http404("Question does not exist")\n return render(request, "polls/detail.html", {"question": question})\nDet nya konceptet här: Vyn ger upphov till undantaget Http404 om en fråga med det begärda ID:t inte finns.
Vi kommer att diskutera vad du kan lägga in i mallen polls/detail.html lite senare, men om du snabbt vill få ovanstående exempel att fungera, kan en fil som bara innehåller:
polls/templates/polls/detail.html{{ question }}\nkommer att hjälpa dig att komma igång för tillfället.
\nget_object_or_404()Link to this heading#Det är ett mycket vanligt idiom att använda get() och få Http404 om objektet inte finns. Django tillhandahåller en genväg. Här är detail() vyn, omskriven:
polls/views.pyfrom django.shortcuts import get_object_or_404, render\n\nfrom .models import Question\n\n\n# ...\ndef detail(request, question_id):\n question = get_object_or_404(Question, pk=question_id)\n return render(request, "polls/detail.html", {"question": question})\nFunktionen get_object_or_404() tar en Django-modell som sitt första argument och ett godtyckligt antal nyckelordsargument, som den skickar till funktionen get() i modellens manager. Den ger upphov till Http404 om objektet inte finns.
Det finns också en funktion get_list_or_404(), som fungerar precis som get_object_or_404() - förutom att den använder filter() istället för get(). Det ger upphov till Http404 om listan är tom.
Tillbaka till detail()-vyn för vår poll-applikation. Med tanke på kontextvariabeln question, så här kan mallen polls/detail.html se ut:
polls/templates/polls/detail.html<h1>{{ question.question_text }}</h1>\n<ul>\n{% for choice in question.choice_set.all %}\n <li>{{ choice.choice_text }}</li>\n{% endfor %}\n</ul>\nMallsystemet använder dot-lookup-syntax för att komma åt variabelattribut. I exemplet med {{ question.question_text }} gör Django först en ordboksuppslagning på objektet question. Om det misslyckas försöker den med en attributuppslagning - vilket fungerar i det här fallet. Om attributuppslagningen hade misslyckats skulle den ha försökt med en listindexuppslagning.
Metoduppringning sker i {% feller %}-loopen: question.choice_set.all tolkas som Python-koden question.choice_set.all(), som returnerar en iterabel av Choice-objekt och är lämplig för användning i taggen {% feller %}.
Se Mallguide för mer information om mallar.
\nKom ihåg att när vi skrev länken till en fråga i mallen polls/index.html, var länken delvis hårdkodad så här:
<li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li>\nProblemet med detta hårdkodade, tätt kopplade tillvägagångssätt är att det blir svårt att ändra webbadresser i projekt med många mallar. Men eftersom du definierade argumentet name i path()-funktionerna i modulen polls.urls, kan du ta bort beroendet av specifika URL-sökvägar som definieras i dina url-konfigurationer genom att använda malltaggen {% url %}:
<li><a href="{% url 'detail' question.id %}">{{ question.question_text }}</a></li>\nDet här fungerar genom att leta upp URL-definitionen som anges i modulen polls.urls. Du kan se exakt var URL-namnet ”detail” är definierat nedan:
...\n# the 'name' value as called by the {% url %} template tag\npath("<int:question_id>/", views.detail, name="detail"),\n...\nOm du vill ändra webbadressen till detaljvyn för omröstningar till något annat, kanske till något som polls/specifics/12/ istället för att göra det i mallen (eller mallarna) skulle du ändra den i polls/urls.py:
...\n# added the word 'specifics'\npath("specifics/<int:question_id>/", views.detail, name="detail"),\n...\nSjälvstudieprojektet har bara en app, polls. I riktiga Django-projekt kan det finnas fem, tio, tjugo appar eller fler. Hur skiljer Django URL-namnen mellan dem? Till exempel har appen polls en detail vy, och det kan också en app på samma projekt som är för en blogg. Hur gör man så att Django vet vilken appvy som ska skapas för en webbadress när man använder malltaggen {% url %}?
Svaret är att lägga till namnrymder i din URLconf. I filen polls/urls.py, gå vidare och lägg till en app_name för att ställa in applikationens namnrymd:
polls/urls.pyfrom django.urls import path\n\nfrom . import views\n\napp_name = "polls"\nurlpatterns = [\n path("", views.index, name="index"),\n path("<int:question_id>/", views.detail, name="detail"),\n path("<int:question_id>/results/", views.results, name="results"),\n path("<int:question_id>/vote/", views.vote, name="vote"),\n]\nÄndra nu din polls/index.html mall från:
polls/templates/polls/index.html<li><a href="{% url 'detail' question.id %}">{{ question.question_text }}</a></li>\nför att peka på den namngivna detaljvyn:
\npolls/templates/polls/index.html<li><a href="{% url 'polls:detail' question.id %}">{{ question.question_text }}</a></li>\nNär du känner dig bekväm med att skriva vyer kan du läsa del 4 i denna handledning för att lära dig grunderna om formulärbehandling och generiska vyer.
\n