Funções de atalho do Django

O pacote django.shortcuts agrega funções e classes auxiliares que “abrangem” múltiplos níveis do MVC. Em outras palavras, essas funções/classes introduzem uma composição controlada por uma questão de conveniência.

render()

render(request, template_name, context=None, content_type=None, status=None, using=None)[código fonte]

Combina uma dado template com um dado dicionário de dados e retorna um objeto HttpResponse com aquele texto renderizado.

O Django não fornece um atalho de função o qual retorna uma TemplateResponse porque o construtor da TemplateResponse oferece o mesmo nível de facilidade que o render().

Argumentos requeridos

request
O objeto de requisição usado para gerar esta resposta.
template_name
O nome completo do template a ser usado ou uma sequência de nomes de templates. Se uma sequência é dada, o primeiro template que existir será usado. Veja a documentação de carga de templates para maiores informações de como os templates são encontrados.

Argumentos opcionais

context
Um dicionário de valores que são adicionados ao contexto do template. Por padrao, é um dicionário vazio. Se um valor neste dicionário é um executável, a “view” irá executá-lo logo antes de renderizar o template.
content_type
O tipo MIME para usar para o documento resultante. O valor padrão é o que está definido em DEFAULT_CONTENT_TYPE
status
O código de status da resposta. Padrão é 200.
using
O NAME do mecanismo de template a ser usado para a carga do template.

Exemplo

O exemplo seguinte renderiza o template myapp/index.html com o tipo MIME application/xhtml+xml:

from django.shortcuts import render

def my_view(request):
    # View code here...
    return render(request, 'myapp/index.html', {
        'foo': 'bar',
    }, content_type='application/xhtml+xml')

Este exemplo é equivalente a:

from django.http import HttpResponse
from django.template import loader

def my_view(request):
    # View code here...
    t = loader.get_template('myapp/index.html')
    c = {'foo': 'bar'}
    return HttpResponse(t.render(c, request), content_type='application/xhtml+xml')

render_to_response()

render_to_response(template_name, context=None, content_type=None, status=None, using=None)[código fonte]

Essa função precedeu a introdução da função render() e funciona de maneira similar exceto que não deixa disponível o request na resposta. Não é recomendada e está para ficar obsoleta no futura.

redirect()

redirect(to, permanent=False, *args, **kwargs)[código fonte]

Retorna uma HttpResponseRedirect para a URL apropriada de acordo com os argumentos passados.

Os argumentos podem ser:

  • Um modelo: a função get_absolute_url() do modelo será chamada.
  • Um nome de uma “view”, possivelmente com argumentos: a reverse() será usada para resolver inversamente o nome
  • Uma URL absoluta ou relativa, a qual será usada como tal para o local do redirecionamento.

Emiti por padrão um redirecionamento temporário, passe permanent=True para ter um redirecionamento permanente.

Exemplos

Você pode usar a função redirect() de várias maneiras.

  1. Passando algum objeto; o método get_absolute_url() daquele objeto será chamado para descobrir a URL de redirecionamento:

    from django.shortcuts import redirect
    
    def my_view(request):
        ...
        object = MyModel.objects.get(...)
        return redirect(object)
    
  2. Passando o nome de uma “view” e opcionalmente algum argumento posicional ou nomeado; a URL será inversamente resolvida usando o método reverse()

    def my_view(request):
        ...
        return redirect('some-view-name', foo='bar')
    
  3. Passando uma URL diretamente no código para redirecionamento:

    def my_view(request):
        ...
        return redirect('/some/url/')
    

    Isso também funciona com URLs não relativas:

    def my_view(request):
        ...
        return redirect('https://example.com/')
    

Por padrão, a redirect() retorna um redirecionamento temporário. Todas as formas acima aceitam um argumento chamado permanent; se definido como True um redirecionamento permanente será retornado:

def my_view(request):
    ...
    object = MyModel.objects.get(...)
    return redirect(object, permanent=True)

get_object_or_404()

get_object_or_404(klass, *args, **kwargs)[código fonte]

Chama o get() de um dado “manager” de modelo, mas emiti um Http404 no lugar de uma exceção DoesNotExist do modelo.

Argumentos requeridos

klass
Uma classe Model, um Manager, ou uma instância de QuerySet da qual pegar o objeto.
**kwargs
Parâmetros de filtro, o quais devem estar no mesmo formato que os aceito por get() e filter().

Exemplo

O exemplo seguinte pega o objeto do modelo MyModel e com chave-primária igual a 1:

from django.shortcuts import get_object_or_404

def my_view(request):
    my_object = get_object_or_404(MyModel, pk=1)

Este exemplo é equivalente a:

from django.http import Http404

def my_view(request):
    try:
        my_object = MyModel.objects.get(pk=1)
    except MyModel.DoesNotExist:
        raise Http404("No MyModel matches the given query.")

O caso de uso mais comum é passar uma Model, como mostrado acima. Porém, você pode também passar uma instância de QuerySet:

queryset = Book.objects.filter(title__startswith='M')
get_object_or_404(queryset, pk=1)

O exemplo acima é um pouco exagerado já que é equivalente a fazer:

get_object_or_404(Book, title__startswith='M', pk=1)

mas pode ser útil se você estiver passando uma varável queryset vinda de algum outro lugar.

E fInalmente, você pode usar uma Manager. Isso é útil por exemplo quando você tem uma custom manager:

get_object_or_404(Book.dahl_objects, title='Matilda')

Você pode usar também uma "Manager"/s relacionados:

author = Author.objects.get(name='Roald Dahl')
get_object_or_404(author.book_set, title='Matilda')

Nota: Assimcomo o get(), uma exceção do tipo MultipleObjectsReturned será emitida se mais de um objeto for encontrado..

get_list_or_404()

get_list_or_404(klass, *args, **kwargs)[código fonte]

Retorna o resultado de filter() de um dado “manager” de modelo como uma lista (cast), emitindo um Http404 se a lista estiver vazia.

Argumentos requeridos

klass
Uma instância Model, Manager ou de QuerySet da qual ler a lista.
**kwargs
Parâmetros de filtro, o quais devem estar no mesmo formato que os aceito por get() e filter().

Exemplo

O exemplo seguinte pega todos os objetos publicados do MyModel:

from django.shortcuts import get_list_or_404

def my_view(request):
    my_objects = get_list_or_404(MyModel, published=True)

Este exemplo é equivalente a:

from django.http import Http404

def my_view(request):
    my_objects = list(MyModel.objects.filter(published=True))
    if not my_objects:
        raise Http404("No MyModel matches the given query.")
Back to Top