“Views” de baseLink para este cabeçalho#

A master “view” baseada em classe. Todas as outras “views” baseadas em classes herdam desta classe base.

Fluxograma de métodos

1. dispatch()

2. http_method_not_allowed()

3. options()

Examplo views.py:

from django.http import HttpResponse
from django.views.generic import View

class MyView(View):

    def get(self, request, *args, **kwargs):
        return HttpResponse('Hello, World!')

Exemplo urls.py:

from django.conf.urls import url

from myapp.views import MyView

urlpatterns = [
    url(r'^mine/$', MyView.as_view(), name='my-view'),
]

Atributos

http_method_namesLink para esta definição#

A lista de nomes de métodos HTTP que esta “view” irá aceitar.

Padrão:

Code

['get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'trace']

Métodos

classmethod as_view(**initkwargs)Link para esta definição#

Retorna uma “view” “chamável” que recebe um request e retorna uma resposta:

Code

response = MyView.as_view()(request)

A “view” retornada tem os atributos view_class e view_initkwargs.

dispatch(request, *args, **kwargs)Link para esta definição#

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.

http_method_not_allowed(request, *args, **kwargs)Link para esta definição#

Se a “view” é chamada com um método HTTP que ela não suport, então este método é chamado.

A implementação padrão retorna HttpResponseNotAllowed com uma lista de métodos permitidos in formato de texto simples.

options(request, *args, **kwargs)Link para esta definição#

Handles responding to requests for the OPTIONS HTTP verb. Returns a response with the Allow header containing a list of the view’s allowed HTTP method names.

Renderiza um dado template, com o contexto contendo parâmetros capturados na URL.

Ancestrais (MRO)

Essa “view” herda métodos e atributos das seguintes “views”:

• django.views.generic.base.TemplateResponseMixin

• django.views.generic.base.ContextMixin

• django.views.generic.base.View

Fluxograma de métodos

1. dispatch()

2. http_method_not_allowed()

3. get_context_data()

Examplo views.py:

from django.views.generic.base import TemplateView

from articles.models import Article

class HomePageView(TemplateView):

    template_name = "home.html"

    def get_context_data(self, **kwargs):
        context = super(HomePageView, self).get_context_data(**kwargs)
        context['latest_articles'] = Article.objects.all()[:5]
        return context

Exemplo urls.py:

from django.conf.urls import url

from myapp.views import HomePageView

urlpatterns = [
    url(r'^$', HomePageView.as_view(), name='home'),
]

Context

• Populada (através do ContextMixin) com os argumentos nomeados capturados do padrão formatado da URL que serve a “view”.

Redirecionamentos para uma URL específica.

A 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)

Essa “view” herda métodos e atributos da seguinte “view”:

• django.views.generic.base.View

Fluxograma de métodos

1. dispatch()

2. http_method_not_allowed()

3. get_redirect_url()

Examplo views.py:

from django.shortcuts import get_object_or_404
from django.views.generic.base import RedirectView

from articles.models import Article

class ArticleCounterRedirectView(RedirectView):

    permanent = False
    query_string = True
    pattern_name = 'article-detail'

    def get_redirect_url(self, *args, **kwargs):
        article = get_object_or_404(Article, pk=kwargs['pk'])
        article.update_counter()
        return super(ArticleCounterRedirectView, self).get_redirect_url(*args, **kwargs)

Exemplo urls.py:

from django.conf.urls import url
from django.views.generic.base import RedirectView

from article.views import ArticleCounterRedirectView, ArticleDetail

urlpatterns = [
    url(r'^counter/(?P<pk>[0-9]+)/$', ArticleCounterRedirectView.as_view(), name='article-counter'),
    url(r'^details/(?P<pk>[0-9]+)/$', ArticleDetail.as_view(), name='article-detail'),
    url(r'^go-to-django/$', RedirectView.as_view(url='https://djangoproject.com'), name='go-to-django'),
]

Atributos

urlLink para esta definição#

A URL para a qual será redirecionada, como string. Ou None para levantar um erro HTTP 410 (“Gone”).

pattern_nameLink para esta definição#

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”.

permanentLink para esta definição#

Se 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.

query_stringLink para esta definição#

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

get_redirect_url(*args, **kwargs)Link para esta definição#

Constrói a URL alvo para redirecionamento.

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.