A view function, or view for short, is a Python function that takes a\nweb request and returns a web response. This response can be the HTML contents\nof a web page, or a redirect, or a 404 error, or an XML document, or an image .\n. . or anything, really. The view itself contains whatever arbitrary logic is\nnecessary to return that response. This code can live anywhere you want, as long\nas it’s on your Python path. There’s no other requirement–no “magic,” so to\nspeak. For the sake of putting the code somewhere, the convention is to\nput views in a file called views.py, placed in your project or\napplication directory.
Aqui uma “view” que retorna a data e hora corrente, como um documento HTML:
\nfrom django.http import HttpResponse\nimport datetime\n\n\ndef current_datetime(request):\n now = datetime.datetime.now()\n html = "<html><body>It is now %s.</body></html>" % now\n return HttpResponse(html)\nVamos passar por este código linha por linha:
\nPrimeiro, importamos a classe HttpResponse do módulo django.http, juntamente com a biblioteca datetime do Python.
Próximo, definimos a função chamada current_datetime. Esta a função da “view”. Cada função “view” recebe um objeto HttpRequest como seu primeiro argumento, o qual é tipicamente chamado request.
Note que o nome da função “view” não importa, essa não tem que ser nominada de uma certa maniera para que o Django as reconheça. Chamaremos aqui de current_time, porque este nome claramente indica o que ela faz.
A “view” retorna um objeto HttpResponse que contém a resposta gerada. Cada função “view” é responsável por retornar um objeto da HttpResponse. (existem exceções, mas chegaremos lá mais tarde.)
Então, para recaptular, essa função “view” retorna uma página HTML que inclui a data e hora corrente. Para mostrar esta “view” em uma URL em particular, é necessário criar um URLconf; veja Despachante de URL para instruções.
\nDjango provides help for returning HTTP error codes. There are subclasses of\nHttpResponse for a number of common HTTP status codes\nother than 200 (which means “OK”). You can find the full list of available\nsubclasses in the request/response\ndocumentation. Return an instance of one of those subclasses instead of a\nnormal HttpResponse in order to signify an error. For\nexample:
from django.http import HttpResponse, HttpResponseNotFound\n\n\ndef my_view(request):\n # ...\n if foo:\n return HttpResponseNotFound("<h1>Page not found</h1>")\n else:\n return HttpResponse("<h1>Page was found</h1>")\nNão existe uma subclasse especializada para código de resposta HTTP possível, já que muitos deles não são muito comuns. Contudo, como documentado na documentação do HttpResponse, você pode também passar o código de status HTTP dentro do construtor para a HttpResponse para que crie a classe de retorno para qualquer código de estatus que queira. Por exemplo:
from django.http import HttpResponse\n\n\ndef my_view(request):\n # ...\n\n # Return a "created" (201) response code.\n return HttpResponse(status=201)\nComo os erros 404 são de longe o erro HTTP mais comum, existe uma maneira mais fácil de lidar com estes erros.
\nHttp404Link para este cabeçalho#Quando retornar um erro como o HttpResponseNotFound, você é responsável por definir o HTML da página de erro resultante:
return HttpResponseNotFound("<h1>Page not found</h1>")\nPor conveniência, e porque é uma boa idéia ter uma página de erro 404 consistente para todo o seu site, o Django fornece uma exceção Http404. Se você emitir um Http404 em qualquer ponto em uma função “view”, o Django irá capturá-la e retornar a página de erro padrão para sua aplicação, juntamente com um código de erro HTTP 404.
Exemplo de uso:
\nfrom django.http import Http404\nfrom django.shortcuts import render\nfrom polls.models import Poll\n\n\ndef detail(request, poll_id):\n try:\n p = Poll.objects.get(pk=poll_id)\n except Poll.DoesNotExist:\n raise Http404("Poll does not exist")\n return render(request, "polls/detail.html", {"poll": p})\nPara que seja mostrado um HTML personalizado quando o Django retornar um 404, você pode criar um “template” HTML chamado 404.htm e colocá-lo no nível superior da sua árvore de “templates”. Este “template” irá então ser servido quando DEBUG está definido como False.
Quando DEBUG for True, você pode fornecer uma mensagem para Http404 e ela irá aparecer em depuração no “template” 404 padrão. Use estas mensagens para propósitos de depuração; elas geralmente não são adequadas para serem usadas em um template 404 em producão.
The default error views in Django should suffice for most web applications,\nbut can easily be overridden if you need any custom behavior. Specify the\nhandlers as seen below in your URLconf (setting them anywhere else will have no\neffect).
\nA “view” page_not_found() é substituída por handler404:
handler404 = "mysite.views.my_custom_page_not_found_view"\nA “view” server_error() é substituída pelo handler500:
handler500 = "mysite.views.my_custom_error_view"\nA “view” permission_denied() é substituída pelo handler403:
handler403 = "mysite.views.my_custom_permission_denied_view"\nA “view” bad_request() é substituída pelo handler400:
handler400 = "mysite.views.my_custom_bad_request_view"\nTo test the response of a custom error handler, raise the appropriate exception\nin a test view. For example:
\nfrom django.core.exceptions import PermissionDenied\nfrom django.http import HttpResponse\nfrom django.test import SimpleTestCase, override_settings\nfrom django.urls import path\n\n\ndef response_error_handler(request, exception=None):\n return HttpResponse("Error handler content", status=403)\n\n\ndef permission_denied_view(request):\n raise PermissionDenied\n\n\nurlpatterns = [\n path("403/", permission_denied_view),\n]\n\nhandler403 = response_error_handler\n\n\n# ROOT_URLCONF must specify the module that contains handler403 = ...\n@override_settings(ROOT_URLCONF=__name__)\nclass CustomErrorHandlerTests(SimpleTestCase):\n def test_handler_renders_template_response(self):\n response = self.client.get("/403/")\n # Make assertions on the response here. For example:\n self.assertContains(response, "Error handler content", status_code=403)\nAs well as being synchronous functions, views can also be asynchronous\n(“async”) functions, normally defined using Python’s async def syntax.\nDjango will automatically detect these and run them in an async context.\nHowever, you will need to use an async server based on ASGI to get their\nperformance benefits.
Here’s an example of an async view:
\nimport datetime\nfrom django.http import HttpResponse\n\n\nasync def current_datetime(request):\n now = datetime.datetime.now()\n html = "<html><body>It is now %s.</body></html>" % now\n return HttpResponse(html)\nYou can read more about Django’s async support, and how to best use async\nviews, in Suporte assíncrono.
\n