---
title: "Escrevendo “views”"
version: 1.9
locale: pt-br
source: https://docs.djangoproject.com/pt-br/1.9/topics/http/views/
canonical: https://djangodocs.dev/pt-br/1.9/topics/http/views/
---
# Escrevendo “views”
Uma função do tipo “view”, ou “view” em resumo, é simplesmente uma função Python que recebe uma requisição Web e retorna uma resposta Web. Esta resposta pode ser um conteúdo HTML de uma página Web, ou um redirecionamento, ou um erro 404, ou um documento XML, ou uma imagem … ou qualquer coisa, realmente. A própria “view” contém qualquer lógica arbitrária que seja necessária para retornar a resposta. Este código pode estar em qualquer lugar que queira, contanto que esteja dentro do seu “python path”. Não existe nenhum outro requerimento–sem “mágica”, assim dizendo. Para não colcoarmos o código em *qualquer lugar*, a convenção é colcoar as “views” em um arquivo chamado `views.py`, colocado dentro do diretório do seu projeto ou da sua aplicação.
## Uma “view” simples.
Aqui uma “view” que retorna a data e hora corrente, como um documento HTML:
```
from django.http import HttpResponse
import datetime
def current_datetime(request):
now = datetime.datetime.now()
html = "It is now %s." % now
return HttpResponse(html)
```
Vamos passar por este código linha por linha:
- Primeiro, importamos a classe [`HttpResponse`](/pt-br/1.9/ref/request-response/#django.http.HttpResponse) do módulo [`django.http`](/pt-br/1.9/ref/request-response/#module-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`](/pt-br/1.9/ref/request-response/#django.http.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`](/pt-br/1.9/ref/request-response/#django.http.HttpResponse) que contém a resposta gerada. Cada função “view” é responsável por retornar um objeto da [`HttpResponse`](/pt-br/1.9/ref/request-response/#django.http.HttpResponse). (existem exceções, mas chegaremos lá mais tarde.)
> **Fuso Horário do Django**
>
> O Django inclui uma definição [`TIME_ZONE`](/pt-br/1.9/ref/settings/#std-setting-TIME_ZONE) cujo padrão é `America/Chicago`. Este provavelmente não é onde você mora, então talvez queira mudar isso no seus arquivo de definições.
## Mapiando URLs para “views”
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](/pt-br/1.9/topics/http/urls/) para instruções.
## Retornando erros
É fácil retornar códigos de erros no Django. Existem subclasses de [`HttpResponse`](/pt-br/1.9/ref/request-response/#django.http.HttpResponse) para vários códigos de status HTTP além do 200 (o qual significa *“OK”*). Você encontrará uma lista completa de subclasses na documentação do [request/response](/pt-br/1.9/ref/request-response/#ref-httpresponse-subclasses). Apenas retorne uma instância de uma daquelas subclasses ao invés de uma [`HttpResponse`](/pt-br/1.9/ref/request-response/#django.http.HttpResponse) normal para que indique um erro. Por exemplo:
```
from django.http import HttpResponse, HttpResponseNotFound
def my_view(request):
# ...
if foo:
return HttpResponseNotFound('Page not found
')
else:
return HttpResponse('Page was found
')
```
Nã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`](/pt-br/1.9/ref/request-response/#django.http.HttpResponse), você pode também passar o código de status HTTP dentro do construtor para a [`HttpResponse`](/pt-br/1.9/ref/request-response/#django.http.HttpResponse) para que crie a classe de retorno para qualquer código de estatus que queira. Por exemplo:
```
from django.http import HttpResponse
def my_view(request):
# ...
# Return a "created" (201) response code.
return HttpResponse(status=201)
```
Como os erros 404 são de longe o erro HTTP mais comum, existe uma maneira mais fácil de lidar com estes erros.
### A exceção `Http404`
#### `class django.http.Http404`
Quando retornar um erro como o [`HttpResponseNotFound`](/pt-br/1.9/ref/request-response/#django.http.HttpResponseNotFound), você é responsável por definir o HTML da página de erro resultante:
```
return HttpResponseNotFound('Page not found
')
```
Por 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:
```
from django.http import Http404
from django.shortcuts import render
from polls.models import Poll
def detail(request, poll_id):
try:
p = Poll.objects.get(pk=poll_id)
except Poll.DoesNotExist:
raise Http404("Poll does not exist")
return render(request, 'polls/detail.html', {'poll': p})
```
Para 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`](/pt-br/1.9/ref/settings/#std-setting-DEBUG) está definido como `False`.
Quando [`DEBUG`](/pt-br/1.9/ref/settings/#std-setting-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.
## Personalizando “views” de erro
As “views”de erro padrão do Django devem ser suficientes para a maioria das alicações Web, mas podem ser facilmente sobrescritas se você precisar personalizar seu comportamento. Simplesmente especifique os manipuladores como se vê abaixo no seu URLconf (definido-os em qualquer outro lugar não terá nenhum efeito).
A “view” [`page_not_found()`](/pt-br/1.9/ref/views/#django.views.defaults.page_not_found) é substituída por [`handler404`](/pt-br/1.9/ref/urls/#django.conf.urls.handler404):
```
handler404 = 'mysite.views.my_custom_page_not_found_view'
```
A “view” [`server_error()`](/pt-br/1.9/ref/views/#django.views.defaults.server_error) é substituída pelo [`handler500`](/pt-br/1.9/ref/urls/#django.conf.urls.handler500):
```
handler500 = 'mysite.views.my_custom_error_view'
```
A “view” [`permission_denied()`](/pt-br/1.9/ref/views/#django.views.defaults.permission_denied) é substituída pelo [`handler403`](/pt-br/1.9/ref/urls/#django.conf.urls.handler403):
```
handler403 = 'mysite.views.my_custom_permission_denied_view'
```
A “view” [`bad_request()`](/pt-br/1.9/ref/views/#django.views.defaults.bad_request) é substituída pelo [`handler400`](/pt-br/1.9/ref/urls/#django.conf.urls.handler400):
```
handler400 = 'mysite.views.my_custom_bad_request_view'
```