This tutorial begins where Tutorial 2 left off.\nWe’re continuing the web-poll application and will focus on creating the public\ninterface – “views.”
\n\nA view is a “type” of web page in your Django application that generally serves\na specific function and has a specific template. For example, in a blog\napplication, you might have the following views:
\nPágina inicial do blog - exibe os artigos mais recentes.
Página de “detalhes” - página de vínculo estático permanente para um único artigo.
Página de arquivo por ano - exibe todos os meses com artigos para um determinado ano.
Página de arquivo por mês - exibe todos os dias com artigos para um determinado mês.
Página de arquivo por dia - exibe todos os artigos de um determinado dia.
Ação de comentários - controla o envio de comentários para um artigo.
Em nossa aplicação de enquetes, nós teremos as seguintes views:
\nPágina de “índice” de enquetes - exibe as enquetes mais recente.
Question “detail” page – displays a question text, with no results but\nwith a form to vote.
Página de “resultados” de perguntas - exibe os resultados de uma pergunta em particular.
Ação de voto - gerencia a votação para uma escolha particular em uma enquete em particular.
In Django, web pages and other content are delivered by views. Each view is\nrepresented by a Python function (or method, in the case of class-based views).\nDjango will choose a view by examining the URL that’s requested (to be precise,\nthe part of the URL after the domain name).
\nNow in your time on the web you may have come across such beauties as\nME2/Sites/dirmod.htm?sid=&type=gen&mod=Core+Pages&gid=A6CD4967199A42D9B65B1B.\nYou will be pleased to know that Django allows us much more elegant URL\npatterns than that.
A URL pattern is the general form of a URL - for example:\n/newsarchive/<year>/<month>/.
To get from a URL to a view, Django uses what are known as ‘URLconfs’. A\nURLconf maps URL patterns to views.
\nThis tutorial provides basic instruction in the use of URLconfs, and you can\nrefer to Despachante de URL for more information.
\nAgora vamos adicionar mais algumas views em polls/views.py. Estas views são um pouco diferentes, porque elas recebem um argumento:
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)\nWire these new views into the polls.urls module by adding the following\npath() calls:
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]\nTake a look in your browser, at “/polls/34/”. It’ll run the detail()\nfunction and display whatever ID you provide in the URL. Try\n“/polls/34/results/” and “/polls/34/vote/” too – these will display the\nplaceholder results and voting pages.
When somebody requests a page from your website – say, “/polls/34/”, Django\nwill load the mysite.urls Python module because it’s pointed to by the\nROOT_URLCONF setting. It finds the variable named urlpatterns\nand traverses the patterns in order. After finding the match at 'polls/',\nit strips off the matching text ("polls/") and sends the remaining text –\n"34/" – to the ‘polls.urls’ URLconf for further processing. There it\nmatches '<int:question_id>/', resulting in a call to the detail() view\nlike so:
detail(request=<HttpRequest object>, question_id=34)\nA parte question_id=34 vem de <int:question_id>. O uso de colchetes angulares “captura” parte da URL e a envia como um argumento de palavra-chave para a função de view. A parte question_id da string define o nome que será usado para identificar o padrão correspondente, e a parte int é um conversor que determina quais padrões devem corresponder a essa parte do caminho da URL. Os dois pontos (:) separam o conversor e o nome do padrão.
Cada view é responsável por fazer uma das duas coisas: devolver um objeto HttpResponse contendo o conteúdo para a página requisitada, ou levantar uma exceção como Http404. O resto é com você.
Sua view pode ler registros do banco de dados, ou não. Ela pode usar um sistema de templates como o do Django - ou outro sistema de templates Python de terceiros - ou não. Ele pode gerar um arquivo PDF, saída em um XML, criar um arquivo ZIP sob demanda, qualquer coisa que você quiser, usando qualquer biblioteca Python você quiser.
\nTudo que o Django espera é que a view devolva um HttpResponse. Ou uma exceção.
Porque é conveniente, vamos usar a própria API de banco de dados do Django, a qual cobrimos em Tutorial 2. Aqui uma nova tentativa de view index(), a qual mostra as últimas 5 “poll questions” do sistema, separada por vírgulas, de acordo com sua data de publicação:
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.
\nPrimeiro, crie um diretório chamado `` templates`` em seu diretório polls. O Django irá procurar templates lá.
A sua configuração de projeto TEMPLATES descreve como o Django vai carregar e renderizar templates. O arquivo de configuração padrão usa o backend DjangoTemplates do qual a opção APP_DIRS é configurada como True. Por convenção DjangoTemplates procura por um subdiretório “templates” em cada uma das INSTALLED_APPS.
Dentro do diretório templates que você acabou de criar, crie outro diretório chamado polls, e dentro dele crie um arquivo chamado index.html. Em outras palavras, seu template deve estar em polls/templates/polls/index.html. Por causa de como o carregador de template app_directories funciona conforme descrito acima, você pode se referir a este template dentro do Django como polls/index.html.
Ponha o seguinte código neste template:
\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 %}\nAgora vamos atualizar nossa view index em polls/views.py para usar o template:
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))\nEsse código carrega o template chamado polls/index.html e passa um contexto para ele. O contexto é um dicionário mapeando nomes de variáveis para objetos Python.
Carregue a página apontando seu navegador para “/polls/”, e você deve ver uma lista contendo a questão “What’s up” do Tutorial 2. O link aponta para página de detalhes das perguntas.
\nrender()Link para este cabeçalho#É um estilo muito comum carregar um template, preenchê-lo com um contexto e retornar um objeto HttpResponse com o resultado do template renderizado. O Django fornece este atalho. Aqui esta toda a view index() reescrita:
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)\nNote que uma vez que você tiver feito isto em todas as views, nós não vamos mais precisar importar loader e HttpResponse (você vai querer manter HttpResponse se você ainda tiver os métodos criados para detail, results, e vote).
A função render() recebe o nome do template como primeiro argumento e um dicionário opcional como segundo argumento. Ele retorna um objeto HttpResponse do template informado renderizado com o contexto determinado.
Agora, vamos abordar a view de detalhe de pergunta – a página que mostra as questões para uma enquete lançada. Aqui esta a view:
\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})\nUm novo conceito aqui: A view levanta uma exceção Http404 se a enquete com ID requisitado não existir.
Nós iremos discutir o que você poderia colocar no template polls/detail.html mais tarde, mas se você gostaria de ter o exemplo acima funcionando rapidamente, um arquivo contendo:
polls/templates/polls/detail.html{{ question }}\nirá ajudar a começar por enquanto.
\nget_object_or_404()Link para este cabeçalho#É um estilo muito comum usar get() e levantar uma exceção Http404 se o objeto não existir. O Django fornece um atalho para isso. Aqui esta a view detail(), reescrita:
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})\nA função get_object_or_404() recebe um modelo do Django como primeiro argumento e uma quantidade arbitrária de argumentos nomeados, que ele passa para a função do módulo get(). E levanta uma exceção Http404 se o objeto não existir.
Existe também a função get_list_or_404(), que trabalha da mesma forma que get_object_or_404() – com a diferença de que ela usa filter() ao invés de get(). Ela levanta Http404 se a lista estiver vazia.
De volta para a view detail() da nossa aplicação de enquentes. Dada a variável de contexto question, aqui está como o template polls/detail.htm deve ser:
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>\nO sistema de templates usa uma sintaxe separada por pontos para acessar os atributos da variável. No exemplo de {{ question.question_text }}, primeiro o Django procura por dicionário no objeto question. Se isto falhar, ele tenta procurar por um atributo – que funciona, neste caso. Se a procura do atributo também falhar, ele irá tentar uma chamada do tipo list-index.
A chamada do método acontece no laço {% for %}: poll.choice_set.all é interpretado como código Python poll.choice_set.all(), que retorna objetos Choice iteráveis que são suportado para ser usado na tag {% for %}.
Veja o guia de templates para maiores detalhes sobre templates.
\nLembre-se, quando escrevemos o link para uma pergunta no template polls/templates/index.html, o link foi parcialmente codificado como este:
<li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li>\nThe problem with this hardcoded, tightly-coupled approach is that it becomes\nchallenging to change URLs on projects with a lot of templates. However, since\nyou defined the name argument in the path() functions in\nthe polls.urls module, you can remove a reliance on specific URL paths\ndefined in your url configurations by using the {% url %} template tag:
<li><a href="{% url 'detail' question.id %}">{{ question.question_text }}</a></li>\nA maneira como isso funciona é, observando as definições de URL como especificado no módulo polls.urls. Você pode ver exatamente onde o nome de URL ‘detalhe’ é definido a seguir
...\n# the 'name' value as called by the {% url %} template tag\npath("<int:question_id>/", views.detail, name="detail"),\n...\nSe você quiser alterar a URL das views de detalhe da enquete para outra coisa, talvez para algo como polls/specifics/12/ em vez de fazê-lo no template (ou templates) você mudaria em polls/urls.py:
...\n# added the word 'specifics'\npath("specifics/<int:question_id>/", views.detail, name="detail"),\n...\nEste projeto tutorial tem apenas um aplicação, polls. Em projetos reais Django, pode haver cinco, dez, vinte ou mais aplicações. Como o Django diferencia os nomes de URL entre eles? Por exemplo, a aplicação polls tem uma view detail, e assim pode um aplicativo no mesmo projeto que é para um blog. Como é que faz para que o Django saiba qual view da aplicação será criada para a url ao usar a tag de template`` {% url%} ``?
A resposta é adicionar namespaces a seu URLconf. No arquivo polls/urls.py, continue e adicione um app_name para configurar o namespace da aplicação.
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]\nAgora mudo seu template``polls/index.html`` de:
\npolls/templates/polls/index.html<li><a href="{% url 'detail' question.id %}">{{ question.question_text }}</a></li>\npara apontar para a view de detalhes d namespace:
\npolls/templates/polls/index.html<li><a href="{% url 'polls:detail' question.id %}">{{ question.question_text }}</a></li>\nWhen you’re comfortable with writing views, read part 4 of this tutorial to learn the basics about form processing and generic\nviews.
\n