Em nosso artigo anterior, abordamos os fundamentos da configuração de um projeto Django e criamos nosso modelo de exercício , que exibimos no front-end como uma lista. Neste artigo, vamos nos aprofundar na execução de operações CRUD. Para quem não conhece, CRUD significa Criar, Ler, Atualizar e Excluir — essencialmente as quatro ações fundamentais que você pode realizar em seus dados.

Agora que configuramos nossa API na pasta app , simplesmente estenderemos a visualização do índice para lidar com solicitações de criação, atualização e exclusão.

A forma

Vamos configurar um formulário que permita aos usuários criar exercícios. Usaremos modelos HTML para essa finalidade mais uma vez. Para começar, crie um novo modelo chamado add_exercise.html na pasta app/templates.

Em seguida, em nosso modelo index.html , incluiremos o modelo add_exercise.html usando o seguinte método:

{% extends "base.html" %} {% block content %}
    
Exercises
    {% include 'add_exercise.html' %}
...
{% endblock %}

Estamos utilizando a tag include aqui, que promove a capacidade de composição em modelos HTML, tornando nosso código mais fácil de manter e entender. Se você atualizar a página em seu navegador, deverá ver o formulário aparecer na tela.

Em nosso HTML, usamos a tag 

class Exercise(models.Model):
    ...

    def create(request):
        title = request.POST.get('title')
        date = request.POST.get('date')

        exercise = Exercise.objects.create(title=title, date=date)

        return exercise

from django.http import HttpResponseRedirect

from app import models

...

def index(request):
    if request.method == 'POST':
        models.Exercise.create(request)
        return redirect('/')

    exercises = (
        models.Exercise.objects.all().order_by("created_at")
    )
    return render(request, "index.html", context={'exercises': exercises})

Exercises
{% include 'add_exercise.html' %}

Estamos usando a tag 

E em nossa visualização de exercícios , faremos as seguintes alterações para diferenciar as solicitações.

def index(request):
    if request.method == 'POST':
        create = 'create' in request.POST
        update = 'update' in request.POST

        if create == True:
            models.Exercise.create(request)
        elif update == True:
            models.Exercise.update(request)

        return redirect('/')

    exercises = (
        models.Exercise.objects.all().order_by("created_at")
    )
    return render(request, "index.html", context={'exercises': exercises})

Verificamos o nome do botão e encaminhamos a solicitação para o método de exercício apropriado.

Vamos adicionar um método de classe de atualização ao modelo de exercício em app/models.py.

def update(request):
    id = request.POST.get('id')
    title = request.POST.get('title')
    date = request.POST.get('date')

    exercise = Exercise.objects.filter(pk=id).update(title=title, date=date)

    return exercise

Para atualizar uma linha no banco de dados, podemos usar o método de atualização disponível no modelo de exercício. Porém, antes de atualizar, precisamos garantir que estamos atualizando o exercício correto. Para fazer isso, filtramos os exercícios pela chave primária, que é id, e atualizamos apenas aquele exercício específico.

Excluir exercício

Da mesma forma, adicionaremos um botão de exclusão ao lado de cada exercício no modelo exercicio.html.

Definiremos delete como o valor do atributo name e, em views.py, estenderemos as instruções if...elif para lidar com a operação de exclusão.

def index(request):
    if request.method == 'POST':
        create = 'create' in request.POST
        update = 'update' in request.POST
        delete = 'delete' in request.POST

        if create == True:
            models.Exercise.create(request)
        elif update == True:
            models.Exercise.update(request)
        elif delete == True:
            models.Exercise.delete(request)

        return redirect('/')

    exercises = (
        models.Exercise.objects.all().order_by("created_at")
    )
    return render(request, "index.html", context={'exercises': exercises})

E no modelo Exercício, adicionaremos o método de classe delete.

def delete(request):
    id = request.POST.get('id')
    is_deleted = Exercise.objects.filter(pk=id).delete()

    if is_deleted == 1:
        return True

    return False

Com esta adição, implementamos com sucesso operações CRUD em nosso aplicativo Python e Django.

Principais conclusões

1. Os manipuladores de visualização do Django não suportam solicitações PUT e DELETE, pois não analisam os parâmetros de consulta ou o corpo da solicitação para esses métodos HTTP. Como resultado, devemos confiar nas solicitações POST e diferenciá-las passando um campo adicional no corpo da solicitação.
2. Percebi que estou fazendo a solicitação POST para a mesma rota da qual estou buscando os exercícios. Isso é importante porque se você criasse um endpoint como /api/exercises para lidar com solicitações, precisaria gerenciar o redirecionamento manualmente. Caso contrário, o comportamento da tag
   após a solicitação é redirecionar o usuário para o endpoint especificado no atributo action. Portanto, você precisará redirecionar manualmente o usuário de volta para a página desejada ou, no nosso caso, manter o usuário na mesma página.

from django.http import HttpResponseRedirect

def index(request):
    ...

    return redirect('/')
    # or
    return HttpResponseRedirect(request.META['HTTP_REFERER'])

Em resumo, gerenciando efetivamente nossas solicitações POST e garantindo o redirecionamento adequado, podemos criar uma experiência de usuário perfeita ao implementar operações CRUD em nosso aplicativo Django.