URL usmerjanje (URLconf) preslika dohodne URL naslove zahtevkov na prikaze (views), ki jih obdelajo. Django ujema zahtevani URL naslov s seznamom vzorcev in pokliče ustrezni pogled, pri tem pa iz URL naslova ekstrahira poljubne parametre.
django.urls path
. views
urlpatterns = [
path(, views.home, name=),
path(, views.article_list, name=),
path(, views.article_detail, name=),
path(, views.by_slug, name=),
]
Vsaka path() preslika URL vzorec na funkcijo prikaza. Django jih preizkuša od zgoraj navzdol in uporabi prvo ujemanje.
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)
Pretvorniki poti (<int:pk>, <slug:slug>, <str:name>, <uuid:id>) zajamejo in tipa-pretvorijo dele URL naslova ter jih posredujejo prikazu kot argumente.
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>
Poimenovani URL naslovi so ključni: z nanašanjem na URL naslove preko njihovega name (prek {% url %} v predlogah in reverse() v kodi) namesto trdo kodiranih poti lahko spremenite strukturo URL naslovov na enem mestu brez motenja vseh povezav — to je praksa DRY in varna za refaktoriranje.
# 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() delegira predpono URL naslova na lastno datoteko urls.py aplikacije, s čimer ostane usmerjanje modulano in vsaka aplikacija samostojna.
URL usmerjanje je temeljno za vsako Django aplikacijo — opredeljuje strukturo URL naslovov vašega spletnega mesta in je način, kako zahtevki dosežejo pravi pogled.
Razumevanje je bistveno vsakodnevno znanje: vedeti, kako opredeliti URL vzorce, zajeti in tipa-pretvoriti parametre iz URL naslovov (pretvorniki poti, kot so <int:pk>), in organizirati usmerjanje modularno z include() (delegiranje na URLconf-e po aplikaciji) je potrebno za gradnjo katere koli večstranske aplikacije ali API-ja.
Kritično pomembna je praksa poimenovanih URL naslovov / obratne razrešitve — nanašanje na URL naslove preko njihovega name prek {% url %} in reverse() namesto trdo kodiranih poti — ki воплощuje Django-jevo filozofijo DRY in je velika zmaga vzdrževanja: omogoča vam, da prestrukturirate URL naslove na enem mestu brez pregledovanja in posodabljanja vsakega trdo kodiranega naslova v predlogah in kodi.
To je najboljša praksa, ki loči dobro zgrajene Django projekte od krhkih.
URL usmerjanje povezuje vhodno točko (URL naslove) z logiko (prikazi), s čimer dopolni sliko obdelave zahtevkov skupaj z modeli in predlogami, pri čemer je osredinski, nujni material za organizacijo in vzdrževanje katere koli Django aplikacije.