Como funciona o roteamento de URL?

Question

Accepted Answer

**Roteamento de URL** (URLconf) mapeia URLs de solicitação recebidas para **visualizações** que as tratam. Django combina o URL solicitado com uma lista de padrões e chama a visualização correspondente, extraindo todos os parâmetros do URL. ## Definindo padrões de URL ```python # urls.py from django.urls import path from . import views urlpatterns = [ path("", views.home, name="home"), # / path("articles/", views.article_list, name="article_list"), # /articles/ path("articles//", views.article_detail, name="detail"), # /articles/5/ path("articles//", views.by_slug, name="by_slug"), # /articles/my-post/ ] ``` Cada `path()` mapeia um padrão de URL para uma função de visualização. Django tenta-os de cima para baixo e usa a primeira correspondência. ## Capturando parâmetros de URL ```python path("articles//", views.article_detail) # captures an integer as `pk` # the view receives the captured value as a parameter def article_detail(request, pk): # pk = 5 for /articles/5/ article = Article.objects.get(pk=pk) ``` Os conversores de caminho (``, ``, ``, ``) capturam e convertem tipos de partes do URL, passando-as para a visualização como argumentos. ## URLs nomeadas e resolução reversa (importante!) ```python path("articles//", views.article_detail, name="detail") # the `name` ``` ```python # generate URLs by NAME instead of hardcoding them — DRY and refactor-safe from django.urls import reverse url = reverse("detail", kwargs={"pk": 5}) # → "/articles/5/" redirect("detail", pk=5) # in views ``` ```html Read more ``` **URLs nomeadas** são cruciais: ao se referir aos URLs pelo seu `name` (via `{% url %}` em templates e `reverse()` em código) em vez de hardcodificar caminhos, você pode alterar a estrutura de URL em um único lugar sem quebrar cada link — uma prática DRY e segura para refatoração. ## Incluindo URLs de aplicativo (roteamento modular) ```python # project urls.py — delegate to each app's URLconf from django.urls import include, path urlpatterns = [ path("blog/", include("blog.urls")), # /blog/... handled by the blog app path("shop/", include("shop.urls")), path("admin/", admin.site.urls), ] ``` `include()` delega um prefixo de URL para o próprio `urls.py` de um aplicativo, mantendo o roteamento modular e cada aplicativo autossuficiente. ## Por que isso importa O roteamento de URL é fundamental para cada aplicação Django — define a estrutura de URL do seu site e é como as solicitações chegam à visualização correta. Compreendê-lo é conhecimento essencial do dia a dia: saber como definir padrões de URL, capturar e converter tipos de parâmetros de URLs (conversores de caminho como ``) e organizar roteamento de forma modular com `include()` (delegando para URLconfs por aplicativo) é necessário para construir qualquer aplicativo multipágina ou API. Criticamente importante é a prática de **URL nomeada / resolução reversa** — referir-se a URLs pelo seu `name` via `{% url %}` e `reverse()` em vez de hardcodificar caminhos — que incorpora a filosofia DRY do Django e é uma grande vitória de manutenibilidade: permite que você reestruture URLs em um único lugar sem procurar e atualizar cada link codificado em templates e código. Esta é uma prática recomendada que distingue projetos Django bem construídos de projetos frágeis. O roteamento de URL conecta o ponto de entrada (URLs) à lógica (visualizações), completando a imagem de tratamento de solicitações junto com modelos e templates, tornando-o material essencial que deve ser conhecido para organizar e manter qualquer aplicação Django.