URL maršrutizacija (URLconf) susieja gaunamus užklausos URL su views (rodiniais), kurie juos apdoroja. Django suderina gautą URL su šablonų sąrašu ir iškviečia atitinkamą rodinio funkciją, ištraukdamas visus parametrus iš 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=),
]
Kiekvienas path() susieja URL šabloną su rodinio funkcija. Django jų bando iš viršaus į apačią ir naudoja pirmą sutapimą.
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)
Kelio konverteriai (<int:pk>, <slug:slug>, <str:name>, <uuid:id>) paima ir tipo-konvertuoja URL dalies, perduodamos jas rodinio kaip argumentus.
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>
Pavadinti URL yra labai svarbūs: nurodant URL pagal jų name ({% url %} šablonuose ir reverse() kode), vietoj sunkiai užkoduotų kelių, galite keisti URL struktūrą viename vietoje nepažeisdami jokios nuorodos — tai DRY praktika, saugi refaktorizavimui.
# 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() pavedą URL priešdėlį aplikacijos savajam urls.py, todėl maršrutizacija išlieka modulinė ir kiekviena aplikacija yra savarankiška.
URL maršrutizacija yra esminė kiekvienai Django aplikacijai — ji apibrėžia jūsų svetainės URL struktūrą ir yra tai, kaip užklausos pasiekia tinkamą rodinio funkciją.
Jo supratimas yra būtina kasdienė žinios: žinoti, kaip apibrėžti URL šablonus, paėmimo ir tipo-konvertuoti parametrus iš URL (kelio konverteriai tokius kaip <int:pk>), ir organizuoti maršrutizaciją moduliškai su include() (perduodant per-aplikacijos URLconf) yra reikalinga bet kurios multi-puslapės aplikacijos ar API kūrimui.
Kritiškai svarbu yra pavadintų-URL / atbulinės-skyros praktika — nurodant URL pagal jų name per {% url %} ir reverse(), o ne sunkiai užkoduotais keliais — kuri įkūniją Django DRY filosofiją ir yra didžiulis priežiūros pelnas: tai leidžia jums perstruktūrizuoti URL viename vietoje nepersekiojant ir atnaujinant kiekvieną sunkiai užkoduotą nuorodą visuose šablonuose ir kode.
Tai yra geroji praktika, kuri atskiria gerai pastatytas Django projektus nuo trapių.
URL maršrutizacija sujungia įėjimo tašką (URL) su logika (views), papildydama užklausos apdorojimo paveikslą kartu su modeliais ir šablonais, todėl tai yra pagrindine, turi-žinoti medžiaga bet kurios Django aplikacijos organizavimui ir priežiūrai.