As três classes seguintes fornecem a maioria das fincionalidades necessárias para criar “views” do Django. Você pode pensar nelas como “views” mães, as quais podem ser usadas elas mesmas ou serem herdadas. Elas talvez não forneçam todas as capacidades requeridas para projetos, para tais casos existem “Mixins” e “views” genéricas baseadas em classes.
\nMuitas das “views” baseadas em classes embutidas no Django herdam de outras “views” baseadas em classes ou vários “mixins. Por causa dessa cadeia de heranças é muito importante, que a classe ascendente seja documentada sob a seção título do Ancestors (MRO).MRO é um acronismo em inglês para Ordem de Resolução de Método.
\nViewLink para este cabeçalho#The master class-based base view. All other class-based views inherit from\nthis base class. It isn’t strictly a generic view and thus can also be\nimported from django.views.
Fluxograma de métodos
\n\nExamplo views.py:
\nfrom django.http import HttpResponse\nfrom django.views import View\n\nclass MyView(View):\n\n def get(self, request, *args, **kwargs):\n return HttpResponse('Hello, World!')\nExemplo urls.py:
\nfrom django.urls import path\n\nfrom myapp.views import MyView\n\nurlpatterns = [\n path('mine/', MyView.as_view(), name='my-view'),\n]\nAtributos
\nA lista de nomes de métodos HTTP que esta “view” irá aceitar.
\nPadrão:
\n['get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'trace']\nMétodos
\nRetorna uma “view” “chamável” que recebe um request e retorna uma resposta:
\nresponse = MyView.as_view()(request)\nA “view” retornada tem os atributos view_class e view_initkwargs.
When the view is called during the request/response cycle, the\nsetup() method assigns the HttpRequest to\nthe view’s request attribute, and any positional and/or keyword\narguments captured from the URL pattern to the args and kwargs\nattributes, respectively. Then dispatch() is called.
Initializes view instance attributes: self.request, self.args,\nand self.kwargs prior to dispatch().
Overriding this method allows mixins to setup instance attributes for\nreuse in child classes. When overriding this method, you must call\nsuper().
A parte view da “view”– o método que aceita um argumento request mais outros argumentos, e retorna uma resposta HTTP.
A implementação padrão irá introspectar o método HTTP e tentar delegar para um método que combine com o método HTTP; um GET será delegado para get(), um POST``para um ``post(), e assim por diante.
Por padrão, uma requisição HEAD será delegada para get(). Se você precisa manipular requisições HEAD de uma maneira diferente de um GET, você pode sobrescrever o método head(). veja Supporting other HTTP methods para um exemplo.
Se a “view” é chamada com um método HTTP que ela não suport, então este método é chamado.
\nA implementação padrão retorna HttpResponseNotAllowed com uma lista de métodos permitidos in formato de texto simples.
Handles responding to requests for the OPTIONS HTTP verb. Returns a\nresponse with the Allow header containing a list of the view’s\nallowed HTTP method names.
TemplateViewLink para este cabeçalho#Renderiza um dado template, com o contexto contendo parâmetros capturados na URL.
\nAncestrais (MRO)
\nEssa “view” herda métodos e atributos das seguintes “views”:
\nFluxograma de métodos
\n\nExamplo views.py:
\nfrom django.views.generic.base import TemplateView\n\nfrom articles.models import Article\n\nclass HomePageView(TemplateView):\n\n template_name = "home.html"\n\n def get_context_data(self, **kwargs):\n context = super().get_context_data(**kwargs)\n context['latest_articles'] = Article.objects.all()[:5]\n return context\nExemplo urls.py:
\nfrom django.urls import path\n\nfrom myapp.views import HomePageView\n\nurlpatterns = [\n path('', HomePageView.as_view(), name='home'),\n]\nContext
\nPopulada (através do ContextMixin) com os argumentos nomeados capturados do padrão formatado da URL que serve a “view”.
You can also add context using the\nextra_context keyword\nargument for as_view().
RedirectViewLink para este cabeçalho#Redirecionamentos para uma URL específica.
\nA URL dada deve pode conter formatação de string no estilo de dicionario, o qual será interpolado com os parâmetros capturados na UTL. Porque a interpoalação de palavras-chave sempre são feitas (mesmo que nenhum argumento seja passado), qualquer caracter "%" na URL deve ser escrita como "%%" então o Python irá converte-los para um único sinal de porcentagem na saída.
Se a dada URL é None, o Django irá retornar um HttpResponseGone (410).
Ancestrais (MRO)
\nEssa “view” herda métodos e atributos da seguinte “view”:
\n\nFluxograma de métodos
\n\nExamplo views.py:
\nfrom django.shortcuts import get_object_or_404\nfrom django.views.generic.base import RedirectView\n\nfrom articles.models import Article\n\nclass ArticleCounterRedirectView(RedirectView):\n\n permanent = False\n query_string = True\n pattern_name = 'article-detail'\n\n def get_redirect_url(self, *args, **kwargs):\n article = get_object_or_404(Article, pk=kwargs['pk'])\n article.update_counter()\n return super().get_redirect_url(*args, **kwargs)\nExemplo urls.py:
\nfrom django.urls import path\nfrom django.views.generic.base import RedirectView\n\nfrom article.views import ArticleCounterRedirectView, ArticleDetail\n\nurlpatterns = [\n path('counter/<int:pk>/', ArticleCounterRedirectView.as_view(), name='article-counter'),\n path('details/<int:pk>/', ArticleDetail.as_view(), name='article-detail'),\n path('go-to-django/', RedirectView.as_view(url='https://djangoproject.com'), name='go-to-django'),\n]\nAtributos
\nA URL para a qual será redirecionada, como string. Ou None para levantar um erro HTTP 410 (“Gone”).
O nome do padrão formatado para URL para redirecionar. O reverso será feito usando o mesmo “args” e “kwargs” como foram passados para esta “view”.
\nSe o redirecionamento deve ser permanente ou não. A única diferença aqui é o código de estatus HTTP retornado. Se True, então o redirecionamento usará código de estatus 301. Se False, o redirecionamento usará código de estatus 302. Por padrão, permanent é False.
Se passa ou não no GET a “query string” para o novo local. Se True, então a “query string” é adicionada à URL. Se False, entao a “query string” é descartada. Por padrão, query_string é False.
Métodos
\nConstrói a URL alvo para redirecionamento.
\nThe args and kwargs arguments are positional and/or keyword\narguments captured from the URL pattern, respectively.
A implementação padrão usa url como a string inicial e realiza a expansão dos parâmetros nomeados % na string usando os grupos nomeados capturados na URL.
Se url não está definido, get_redirect_url() tenta fazer o reverse de pattern_name usando o que foi capturado na URL (ambos os grupos, nomeados e não nomeados são usados).
Se requisitado via query_string, também será adicionado a “query string” a URL gerada. Subclasses podem implementar qualquer comportamento que quiser, contanto que o método retorne uma string URL de redirecionamento pronta.