Modelagem inicial

Nos handouts a seguir, você construirá um sistema web para realizar anotações curtas chamado Get-it. Nesse sistema, o usuário será capaz de adicionar, ler, editar e remover suas anotações. Cada anotação possuirá um título e um conteúdo formado exclusivamente por texto.

Uma etapa importante no desenvolvimento de um sistema é a modelagem dos dados. Devemos refletir sobre quais dados queremos armazenar no banco de dados e como eles devem ser organizados. Em DevLife não vamos nos aprofundar nessa discussão, mas em semestres futuros você terá disciplinas nas quais aprenderá quais aspectos devem ser levados em conta nessa etapa do desenvolvimento. O que você precisa saber por enquanto é que nos bancos de dados que utilizaremos, as informações são armazenadas em tabelas. Por exemplo, os nossos dados de anotações poderiam ser armazenados em uma tabela como esta:

Note que a primeira coluna, o id, possui um número associado, que aumenta a cada linha. Em bancos de dados é comum que as linhas de uma tabela possuam um identificador numérico. Isso facilita o acesso à informação e também pode ser utilizado para criar relações entre tabelas, mas isso é assunto para um handout futuro.

O arquivo models.py#

Bancos de dados são sistemas bastante complexos, com diversas travas de segurança e otimizações. Por esse motivo, a grande maioria dos frameworks não cria um banco de dados próprio, mas se conecta a um banco de dados externo.

O Django possui diversas funcionalidades relacionadas a banco de dados. Para utilizá-las, devemos implementar classes que herdam do tipo django.db.models.Model. Cada classe de modelo que implementarmos será mapeada em uma tabela do banco de dados pelo Django. Nesse primeiro momento, não precisamos nos preocupar com os detalhes de como isso acontece.

Nas classes de modelo, devemos definir quais são os nomes e tipos das colunas que serão armazenadas na tabela do banco de dados. A seguir definimos uma classe Note¹ para representar uma anotação no banco de dados:

from django.db import models

class Note(models.Model):
    title = models.CharField(max_length=200)

Para entender o que esse código faz, vamos consultar a boa e velha documentação. O Django é um projeto muito maior e mais utilizado do que o Pygame. Portanto, a sua documentação é muito mais completa - você pode encontrar diversos exemplos de uso e explicações detalhadas de cada funcionalidade.

Assim, a classe Note definida acima, possui uma coluna chamada title que armazena strings de no máximo 200 caracteres.

E o ID?#

Na tabela mostrada no início da página havia 4 colunas: id, titulo, conteudo e criacao. Já vimos como criar as colunas de título e conteúdo, mas em nenhum momento criamos a coluna de id. E não vamos precisar criar. Como todo modelo do banco de dados precisa ter um id, o Django já cria essa coluna automaticamente. Assim não precisamos nos preocupar com ela durante a definição da classe.

Nosso primeiro modelo está pronto! Mas ainda falta um passo para podermos usá-lo no nosso sistema .