Programação de Sistemas para Internet

Prof. Diego Cirilo

Aula 05: Apps Django

Apps no Django

• Os códigos do sistema em si, fazem parte de aplicações Django;
• Os projetos podem conter apenas uma ou mais aplicações;
• Dividir o seu projeto em aplicações pode permitir o reuso no futuro;

Criando um app no Django

• Utilizamos o script manage.py:

python manage.py startapp meuapp

Um app no Django

• O app é criado com a seguinte estrutura:

meuapp
├── admin.py
├── apps.py
├── __init__.py
├── migrations
│   └── __init__.py
├── models.py
├── tests.py
└── views.py

Estrutura de um app

• admin.py - Configuração da interface padrão de administração do Django;
• apps.py - Configurações do app;
• migrations - Pasta onde aparecerão as migrations, que são as definições/alterações na estrutura do BD;
• models.py - Onde serão descritos os models, que definem a estrutura de dados do sistema;
• tests.py - Testes de software;
• views.py - Descrição das views.

Ativando um app

• Não basta criar o app;
• O arquivo settings.py contém a lista dos apps ativos;
• Para ativar, basta adicionar o nome do app na lista:

# Application definition

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'meuapp',
]

URLs

• Uniform Resource Locator;
• Também conhecido como rotas;
• Os recursos que o usuário procura na URL do navegador são filtrados no urls.py;
• Os filtros direcionam cada URL solicitada para uma view que será responsável por processar a requisição;
• É possível organizar as URLs por apps.

urls.py

• Usamos o include para redirecionar as requisições para seu app responsável:

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path("", include("tarefas.urls")),
    path("admin/", admin.site.urls),
]

Criando urls.py no app

• Dentro na pasta do app deve ser criado um arquivo urls.py:

from django.urls import path
from . import views

urlpatterns = [
    path("", views.index, name="index"),
]

Views

• Provavelmente o arquivo mais "movimentado" no projeto;
• Recebem e processam as requisições, retornando um conteúdo baseado nos templates;
• Podem ser escritas como funções (Funcion-based View - FBVs) ou como classes (Class-based View - CBVs);
• Iniciaremos com FBVs;
• As requisições são direcionadas para cada view a partir da regra da rota (urls.py).

FBV

• As funções são chamadas a partir das regras de urls.py;
• Cada função recebe um argumento request, que traz os dados da requisição;
• Dentro da função fazemos o processamento/tratamento/aquisição/armazenamento/etc dos dados;
• No fim a função renderiza e retorna uma página web, através de templates.

Views

from django.shortcuts import render


def index(request):
    return render(request, "index.html")

Templates

• As views podem retornar páginas estáticas, mas qual seria a vantagem?
• Templates permitem a substituição dinâmica de dados em uma página HTML;
• Isso é possível através de tags;
• A estrutura é de um HTML normal, com tags extras.

Templates

• O Django por padrão procura os templates na pasta templates em cada app;
• É possível configurar outras pastas no arquivo settings.py;
• Ex. uma pasta chamada templates na raiz do projeto:

TEMPLATES = [
    {
        ...
        "DIRS": [BASE_DIR / "templates"],
        ...
    },
]

Tarefa 02

• Configure o ambiente (venv, git);
• Inicialize um projeto (config) e um app chamado exemplo;
• Configure as urls do projeto (em config) e as urls do app;
• As urls do app devem apontar para uma view: index;
• Crie a views index e o template index.html. O conteúdo do template pode ser uma página simples;
• Verifique o funcionamento do sistema;
• Faça os commits quando julgar necessário, e envie para o Github.

Dúvidas?