O método POST

Quando acessamos a página na URL http://localhost:8000/, o navegador faz uma requisição GET para o servidor. Quando preenchemos o formulário de criação de anotações e apertamos o botão de submissão, o navegador faz uma requisição POST para a mesma URL, enviando as informações do formulário. Como podemos saber a diferença?

O objeto request recebido como argumento nas suas views possui um atributo method. Esse atributo é uma string contendo o nome do método em letras maiúsculas ('GET' ou 'POST'). Além disso, caso seja uma requisição do tipo POST, haverá também um atributo POST com um dicionário (na verdade um dictionary-like) cujas chaves são os nomes (atributo name dos inputs do formulário) dos inputs e os valores são os valores preenchidos pelo usuário.

from django.shortcuts import render
from .models import Note


def index(request):
    if request.method == 'POST':
        title = request.POST.get('titulo')
        content = request.POST.get('detalhes')

        print(f'Titulo={title}\nConteudo={content}\n')

        # TAREFA: Utilize o title e content para criar um novo Note no banco de dados

    all_notes = # COLOQUE AQUI O CÓDIGO QUE LISTA TODAS AS ANOTAÇÕES ORDENADAS POR DATA DE CRIAÇÃO
    return render(request, 'notes/index.html', {'notes': all_notes})

Redirecionando a resposta#

Assim como existem diferentes tipos de requisição (GET e POST - existem outros, mas não vamos nos preocupar com eles por enquanto), existem também diferentes tipos de resposta. Toda resposta HTTP possui um código de status. São números entre 100 e 599. O mais comum de todos é o status 200, que significa que a requisição foi bem sucedida. Você já deve ter se deparado com pelo menos outros 2 ao longo de sua vida: o status 500 (erro do servidor - internal server error) e o status 404 (não encontrado). Na página anterior, tivemos também o erro 403 (acesso proibido). Cada código possui um significado, mas conhecê-los não é o nosso objetivo no momento¹.

Você não precisa saber todos os códigos de cor, mas acabará decorando os principais depois de usar algumas vezes. O que importa para nós desta discussão é que existe um código específico que indica um redirecionamento. A resposta com redirecionamento faz com que o navegador faça uma nova requisição para um novo endereço. É mais ou menos como se fosse uma placa na frente de uma loja dizendo "estamos temporariamente atendendo neste outro endereço".

Fizemos esta digressão para apresentarmos uma solução muito comum para o problema que encontramos em nosso último exercício. Sempre que recebermos uma requisição POST, fazemos o que foi solicitado e, ao invés de devolvermos a página HTML, devolvemos uma resposta de redirecionamento para o mesmo endereço. Assim, o navegador fará uma nova requisição GET para esse endereço. Veja o exercício abaixo:

from django.shortcuts import render, redirect
from .models import Note


def index(request):
    if request.method == 'POST':
        title = request.POST.get('titulo')
        content = request.POST.get('detalhes')

        print(f'Titulo={title}\nConteudo={content}\n')

        # AQUI DEVE CONTINUAR O SEU CÓDIGO QUE CRIA A NOVA ANOTAÇÃO

        return redirect('index')
    else:  # GET
        all_notes = # COLOQUE AQUI O CÓDIGO QUE LISTA TODAS AS ANOTAÇÕES ORDENADAS POR DATA DE CRIAÇÃO
        return render(request, 'notes/index.html', {'notes': all_notes})

O que significa o 'index' usado como argumento da função redirect?

Por acaso é o mesmo nome da função, mas o Django procura pelo nome na lista de padrões de url no arquivo urls.py.

Nosso próximo passo é receber parâmetros no caminho da URL.