Django - 路由系統

 

Django - 路由系統

一. URLconf配置

　　1. 基本格式

　　　　from django.conf.urls import url

　　　　urlpatterns = [ url(正則表達式, views視圖, 參數, 別名), ]

　　　　示例

from django.conf.urls import url
from . import views

urlpatterns = [
    url(r'^articles/2003/$', views.special_case_2003),
    url(r'^articles/([0-9]{4})/$', views.year_archive),
    url(r'^articles/([0-9]{4})/([0-9]{2})/$', views.month_archive),
    url(r'^articles/([0-9]{4})/([0-9]{2})/([0-9]+)/$', views.article_detail),
]

　　2. 參數說明:

　　　　正則表達式: 一個正則表達式字符串

　　　　views視圖: 一個可調用對象, 一般爲一個視圖函數

　　　　參數: 可選的要傳遞給視圖函數的默認參數(字典形式)

　　　　別名: 一個可選色name參數

注意:

　　　　Django 2.0版本中的路由系統是下面的寫法:

from django.urls import path，re_path

urlpatterns = [
    path('articles/2003/', views.special_case_2003),
    path('articles/<int:year>/', views.year_archive),
    path('articles/<int:year>/<int:month>/', views.month_archive),
    path('articles/<int:year>/<int:month>/<slug:slug>/', views.article_detail),
]

　　　　2.0版本中re_path和1.11版本的url是同樣的寫法.

二. 正則表達式

　　1. 基本配置

from django.conf.urls import url
from . import views
urlpatterns = [
    url(r'^articles/2003/$', views.special_case_2003),
    url(r'^articles/([0-9]{4})/$', views.year_archive),
    url(r'^articles/([0-9]{4})/([0-9]{2})/$', views.month_archive),
    url(r'^articles/([0-9]{4})/([0-9]{2})/([0-9]+)/$', views.article_detail),
]

　　2. 注意事項

　　　　a, urlpatterns中的元素按照書寫順序從上往下注意匹配正則表達式, 一旦匹配成功則再也不繼續

　　　　b, 若要從URL中捕獲一個值, 只須要在他周圍放置一對圓括號(分組括號)

　　　　c, 不須要添加一個前導的反斜槓, 覺得每一個URL都有, 例如, 應該是^articles而不是^/articles

　　　　d, 每一個正則表達式前面的'r'是可選的可是建議加上

　　3. 補充說明

APPEND_SLASH=True
#是否開啓URL訪問地址後面不爲 / 跳轉至帶有 / 的路徑的配置項

　　　　Django settings.py配置文件中默認沒有APPEND_SLASH 這個參數, 但Django默認這個參數爲APPEND_SLASH = .True, 做用就是自動在網站結尾加'/''.

　　　　若是在sttings.py 中設置了APPEND_SLASH = False, 此時若是訪問界面後面不加 / ,就沒法訪問

三. 分組

　　1. 分組命名正則表達式的語法:　　(?P<name>pattern), 其中name 是組的名稱, pattent 是要匹配的模式

　　url(r'^del_publisher/(\d+)', views.del_publisher)

　　匹配到參數, 按照未知參數的方式傳遞給視圖函數 視圖函數須要定義形參接收變量

　　2. 命名分組

　　　　url(r'^blog/(?P<year>\d{4}/[1-9]{2})$', views.blog)

　　　　匹配到參數, 按照關鍵字參數的方式傳遞給視圖函數 視圖函數須要定義關鍵字參數

from django.conf.urls import url
from . import views
urlpatterns = [
    url(r'^articles/2003/$', views.special_case_2003),
    url(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive),
    url(r'^articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/$', views.month_archive),
    url(r'^articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/(?P<day>[0-9]{2})/$', views.article_detail),
]

　　　　視圖函數

views.month_archive(request, year="2017", month="12"

　　　3. URLconf匹配的位置　　　

　　　　URLconf 在請求的URL 上查找，將它當作一個普通的Python 字符串。不包括GET和POST參數以及域名。

　　　　例如，http://www.example.com/myapp/ 請求中，URLconf 將查找 /myapp/ 。

　　　　在http://www.example.com/myapp/?page=3 請求中，URLconf 仍將查找 /myapp/ 。

　　　　URLconf 不檢查請求的方法。換句話講，全部的請求方法 —— 同一個URL的POST、GET、HEAD等等 —— 都將路由到相同的函數。

　　　4. 捕獲的參數永遠都是字符串　　　　

　　　　每一個在URlconf中捕獲的參數都做爲一個普通的Python字符串傳遞給視圖, 不管正則表達式使用的是什麼匹配方式.

url(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive),

　　　　傳遞到視圖函數 views.year_archive() 中的year參數永遠是一個字符串類型

　　　　5. 視圖函數中指定默認值

# urls.py中
from django.conf.urls import url

from . import views

urlpatterns = [
    url(r'^blog/$', views.page),
    url(r'^blog/page(?P<num>[0-9]+)/$', views.page),
]

# views.py中，能夠爲num指定默認值
def page(request, num="1"):
    pass

　　　　在上面的例子中, 兩個URL模式指向相同的view - views.page 可是第一個模式並無從URl中捕6.獲任何東西,若是第一模式匹配上了,page()函數將使用其默認參數num='1', 若是第二個模式匹配, page() 將使用正則表達式捕獲的num值.

　　　　6. include其餘的URlconfs

#At any point, your urlpatterns can 「include」 other URLconf modules. This
#essentially 「roots」 a set of URLs below other ones.

#For example, here’s an excerpt of the URLconf for the Django website itself.
#It includes a number of other URLconfs:


from django.conf.urls import include, url
urlpatterns = [
   url(r'^admin/', admin.site.urls),
   url(r'^blog/', include('blog.urls')),  # 能夠包含其餘的URLconfs文件

 

四 命名URl和URl反向解析

　　1.普通url

　　　　命名

url(r'^publisher_list/', view.publisher_list, name= 'publisher')

　　　　在視圖中使用:

　　　　　　from django.urls import reverse

　　　　　　reverse('publisher') -->> '/app01/publisher_list'

　　　　模板中使用:

　　　　　　{% url 'publisher'%} -->> '/app01/publisher/'

　　2. 使用分組

　　　　命名

url(r'^blog/(?P<year>\d{4})/(?P<month>[1-9]{2})/$', views.blog, name='blog')

　　　　視圖中使用:

　　　　　　reverse('blog'/, args=('2018', '12'))　　#‘/blog/2018/12/'

　　　　模板中使用:

　　　　　　{% url  ’blog‘  ’2018‘  ’12‘  %}

　　3. 使用命名分組

url(r'^blog/(?P<year>\d{4})/(?P<month>[1-9]{2})/$', views.blog, name='blog')

　　　　視圖中使用:

　　　　　　reverse('blog',args=('2018','12'))         ‘/blog/2018/12/'

　　　　　　reverse('blog', kwargs={'month': '12', 'year': '2018'})

　　　　模板中使用:

　　　　　　{% url 'blog'  '2018' '12' %}   ——》 ‘/blog/2018/12/'

　　　　　　{% url 'blog'  year='2018' month='12' %}    ——》  ‘/blog/2018/12/'

　　　　　　　{% url 'blog'  month='12' year='2018'  %}    ——》  ‘/blog/2018/12/'

 

五. namespace

project中的urls.py

from django.conf.urls import url, include
urlpatterns = [
    url(r'^app01/', include('app01.urls', namespace='app01')),
    url(r'^app02/', include('app02.urls', namespace='app02')),
]

app01中的urls.py

from django.conf.urls import url
from app01 import views

app_name = 'app01'
urlpatterns = [
    url(r'^(?P<pk>\d+)/$', views.detail, name='detail')
]

app02中的urls.py

from django.conf.urls import url
from app02 import views
 
app_name = 'app02'
urlpatterns = [
    url(r'^(?P<pk>\d+)/$', views.detail, name='detail')
]

　　如今，個人兩個app中 url名稱重複了，我反轉URL的時候就能夠經過命名空間的名稱獲得我當前的URL

語法:

　　'命名空間: URl名稱'

模板中使用:

　　{% url 'app01 : detail' %}

views視圖:

　　v = reverse('app01:detail', kwargs={'pk':11})