Funções de atalho do DjangoLink para este cabeçalho#

Argumentos requeridosLink para este cabeçalho#

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 opcionaisLink para este cabeçalho#

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.

ExemploLink para este cabeçalho#

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

ExemplosLink para este cabeçalho#

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:

   Code

   from django.shortcuts import redirect
   
   def my_view(request):
       ...
       obj = MyModel.objects.get(...)
       return redirect(obj)
   

2. Passando o nome de uma “view” e opcionalmente algum argumento posicional ou nomeado; a URL será inversamente resolvida usando o método reverse()

   Code

   def my_view(request):
       ...
       return redirect('some-view-name', foo='bar')
   

3. Passando uma URL diretamente no código para redirecionamento:

   Code

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

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

   Code

   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):
    ...
    obj = MyModel.objects.get(...)
    return redirect(obj, permanent=True)

Argumentos requeridosLink para este cabeçalho#

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().

ExemploLink para este cabeçalho#

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):
    obj = get_object_or_404(MyModel, pk=1)

Este exemplo é equivalente a:

from django.http import Http404

def my_view(request):
    try:
        obj = 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..

Argumentos requeridosLink para este cabeçalho#

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().

ExemploLink para este cabeçalho#

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.")