Směrování URL (URLconf) mapuje příchozí URL požadavky na views, které je zpracovávají. Django porovnává požadovanou URL se seznamem vzorů a volá odpovídající view, přičemž extrahuje všechny parametry z URL.
django.urls path
. views
urlpatterns = [
path(, views.home, name=),
path(, views.article_list, name=),
path(, views.article_detail, name=),
path(, views.by_slug, name=),
]
Každý path() mapuje vzor URL na funkci view. Django je postupně zkoušíí od shora dolů a používá první shodu.
path("articles/<int:pk>/", 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)
Konvertory cest (<int:pk>, <slug:slug>, <str:name>, <uuid:id>) zachytávají a provádějí typovou konverzi částí URL a předávají je viewu jako argumenty.
path("articles/<int:pk>/", views.article_detail, name="detail") # the `name`
# 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
<!-- in templates -->
<a href="{% url 'detail' pk=article.pk %}">Read more</a>
Pojmenované URL jsou zásadní: odkazováním na URL pomocí jejich name (přes {% url %} v šablonách a reverse() v kódu) místo hardcodování cest můžete změnit strukturu URL na jednom místě bez porušení všech odkazů — jde o DRY, bezpečný na refaktorování.
# 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() deleguje předponu URL na vlastní urls.py aplikace, čímž je směrování modulární a každá aplikace je samostatná.
Směrování URL je základem každé Django aplikace — definuje strukturu URL vaší stránky a je to cesta, kterou požadavky dosahují správného view.
Rozvíjení v něm je nezbytné každodenní znalosti: vědět, jak definovat vzory URL, zachytávat a provádět typovou konverzi parametrů z URL (konvertory cest jako <int:pk>) a organizovat směrování modulárně pomocí include() (delegování na URLconfs jednotlivých aplikací) je nezbytné pro vytváření jakékoli aplikace s více stránkami nebo API.
Kriticky důležitá je praxe pojmenovaných URL / reverse resolution — odkazování na URL pomocí jejich name přes {% url %} a reverse() místo hardcodování cest — která ztělešňuje Djangovu DRY filozofii a je velkým přínosem na údržbu: umožňuje vám změnit strukturu URL na jednom místě bez hledání a aktualizace každého hardcodovaného odkazu v šablonách a kódu.
Jde o osvědčenou praxi, která rozlišuje dobře vytvořené Django projekty od křehkých.
Směrování URL spojuje vstupní bod (URL) s logikou (views), čímž doplňuje obraz zpracování požadavků spolu s modely a šablonami, čímž se stává základním, nezbytným materiálem pro organizaci a údržbu jakékoli Django aplikace.