URL-reititys (URLconf) kartoittaa saapuvat HTTP-pyyntöjen URL:t näkymiä, jotka käsittelevät ne. Django vertaa pyydettyä URL:tä kuviolistaan ja kutsuu vastaavaa näkymää, poistaen kaikki parametrit URL:stä.
django.urls path
. views
urlpatterns = [
path(, views.home, name=),
path(, views.article_list, name=),
path(, views.article_detail, name=),
path(, views.by_slug, name=),
]
Jokainen path() kartoittaa URL-kuvion näkymäfunktioon. Django kokeilee niitä ylhäältä alaspäin ja käyttää ensimmäistä osumaa.
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)
Polun konvertterit (<int:pk>, <slug:slug>, <str:name>, <uuid:id>) sieppaavat ja tyyppinmuuntavat URL:n osia, välittäen ne näkymälle argumentteina.
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>
Nimetyt URL:t ovat ratkaisevansa: viitaamalla URL:iin niiden name-arvon perusteella (käyttäen {% url %}-tunnisteita malleissa ja reverse()-funktiota koodissa) hardkoodattujen polkujen sijaan, voit muuttaa URL-rakennetta yhdessä paikassa häiritsemättä jokaista linkkiä — DRY-periaate, refaktorointiturva.
# 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() siirtää URL-etuliitteen sovelluksen omaan urls.py-tiedostoon, pitäen reitityksen modulaarisena ja kunkin sovelluksen itsenäisenä.
URL-reititys on perustavanlaatuista jokaisessa Django-sovelluksessa — se määrittää sivustosi URL-rakenteen ja on se, kuinka pyynnöt saavuttavat oikean näkymän.
Ymmärtäminen on välttämätöntä päivittäistä tietoa: osaa määrittää URL-kuviot, siepata ja tyyppinmuuntaa parametreja URL:ista (polun konvertterit kuten <int:pk>) ja organisoida reititys modulaarisesti include()-funktiolla (siirtäen sovelluksittaisiin URLconf-tiedostoihin) on välttämätöntä monisivuisen sovelluksen tai API:n rakentamiseksi.
Erittäin tärkeää on nimetty-URL / käänteisen ratkaisun käytäntö — viitata URL:iin niiden name-arvon perusteella {% url %}- ja reverse()-funktiolla hardkoodattujen polkujen sijaan — joka uusintaa Djangon DRY-filosofiaa ja on merkittävä ylläpidettävyyden parannus: se antaa sinulle mahdollisuuden muuttaa URL-rakennetta yhdessä paikassa ilman, että joudut etsimään ja päivittämään jokaista hardkoodattua linkkiä malleissa ja koodissa.
Tämä on paras käytäntö, joka erottaa hyvin rakennetut Django-projektit haurailta olevilta.
URL-reititys yhdistää sisääntulopisteen (URL:t) logiikkaan (näkymät), täydentäen pyyntöjen käsittelykuvaa malleilla ja malleilla yhdessä, mikä tekee siitä ydinaineistoa, jota on välttämätöntä osata minkä tahansa Django-sovelluksen organisoimiseksi ja ylläpitämiseksi.