Django-路由层(URLconf)

Django-路由层(URLconf)

    URL配置(URLconf)就像Django所支撑网站的目录。它的本质是URL与要为该URL调用的视图函数之间的映射表；就是以这种方式告诉Django，对于客户端发来的某个URL，调用哪一段逻辑代码对应执行。

简单的路由配置

1) 2.0版本如下

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

urlpatterns = [
    url(r"^articles/2003/$", views.func)                  # func(request)
    url(r"^articles/(\d{4})/(\d{2})/$", views.func)       # func(request, "2013", "07")
]

2) 2.0版本以上

from django.urls import path, re_path
from app01 import views

urlpatterns = [
    path(r"^articles/2003/$", views.func)                     # func(request)
    re_path(r"^articles/(\d{4})/(\d{2})/$", views.func)       # func(request, "2013", "07")
]

注：

• 若要从URL中捕获一个值，只须要在它周围放置一对圆括号
• 不须要添加一个前导的反斜杠，由于每一个URL都有。例如，应该是^articles而不是^/articles
• 每一个正则表达式前面的"r"是可选的偍建议加上。它告诉python这个字符串是"原始的"——字符串中任何字符都不该该转义

有名分组

    上面的示例使用简单的、没有命名的正则表达式组（经过圆括号）来捕获URL 中的值并以位置参数传递给视图。在更高级的用法中，可使用命名的正则表达式组来捕获URL 中的值并以关键字参数传递给视图。

    在Python 正则表达式中，命名正则表达式组的语法是(?P<name>pattern)，其中name 是组的名称，pattern 是要匹配的模式。

1) 2.0版本如下

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

urlpatterns = [
    url(r"^articles/(？P<y>\d{4})/(?P<d>\d{2})/$", views.func)       # func(request, y="2013", d="07")
]

2) 2.0版本以上

from django.urls import path, re_path
from app01 import views

urlpatterns = [
    re_path(r"^articles/(?P<y>\d{4})/(?P<d>\d{2})/$", views.func)       # func(request, y="2013", d="07")
]

    在实际应用中，这意味你的URLconf会更加清晰且不容易产生参数顺序问题的错误——你能够在你的视图函数定义中从新安排参数的顺序。固然，这些好处是以简洁为代价

分发

'''
At any point, your urlpatterns can “include” other URLconf modules. This
essentially “roots” a set of URLs below other ones.

'''


# 全局urls.py:
from django.urls import path,re_path,include
from app01 import views

urlpatterns = [
   re_path(r'^admin/', admin.site.urls),
   re_path(r'^app01/', include('app01.urls')),
]


# app01 urls.py:
from django.urls import path, re_path
from app01 import views
urlpatterns = [
    path("articles/", views.func)    # http://127.0.0.1:8000/app01/articles/
]

反向解析

    在使用Django项目时，一个常见的需求是得到URL的最终形式，以用于嵌入到生成的内容中(视图中和显示给用户的URL等)或者用于处理服务器端的导航(重定向等)

    人们强烈但愿不要硬编码这些URL(费力、不可扩展且容易产生错误)或者设计一种与URLconf绝不相关的专门的URL生成机制，由于这样容易致使必定程度上产生过时的URL

    在须要URL的地方，对于不一样层级，Django提供不一样的工具用于URL反查：

• 在模板中：使用url模板标签
• 在Python代码中：使用reverse()函数

from django.urls import reverse

urls.py：

from django.urls import path,re_path
from app01 import views

urlpatterns = [
    #...
    re_path(r'^articles/(\d{4})/$', views.year_archive, name='news-year-archive'),
    #...
]

在模板中：

<a href="{% url 'news-year-archive' 2012 %}">2012 Archive</a>

在Python中：

from django.shortcuts import render, redirect, reverse

def redirect_to_year(request):
    #...
    year = "2006"
    #...
    return redirect(reverse("news-year-archive", args=(year,)))

    当命名你的URL模式时，请确保使用的名称不会与其它应用中名称冲突。若是你的URL模式叫作comment，而另一个应用中也有一个一样的名称，当你在模板中使用这个名称的时候不能保证将插入哪一个URL，在URL名称中加上一个前缀，好比应用的名称，将减小冲突的可能。建议使用myapp-comment而不是comment

名称空间

    因为name没有做用域，Django在反解URL时，会在项目上全局顺序搜索，当查找到第一个name指定URL时，当即返回。

    在开发项目时，会常用name属性反解出URL,当不当心在不一样的app的urls中定义相同的name时，可能会致使URL反解错误，为了不这种事情发生，引入了命名空间。

    命名空间(英语：Namespace)是表示标识符的可见范围。一个标识符可在多个命名空间中定义，它在不一样的命名空间中的含义是互不相干的。这样，在一个新的命名空间中可定义任何标识符，它们不会与任何已有的标识符发生冲突，由于已有的定义都处于其它命名空间中。

project urls.py：

urlpatterns = [
    re_path(r'^admin/', admin.site.urls),
    re_path(r'^app01/', include("app01.urls",namespace="app01")),
    re_path(r'^app02/', include("app02.urls",namespace="app02")),
]

app01 urls.py：

urlpatterns = [
    re_path(r'^index/', views.index,name="index"),
]

app02 urls.py：

urlpatterns = [
    re_path(r'^index/', views.index,name="index"),
]

app01 views：

from django.shortcuts import render, redirect, reverse

def redirect_to_index(request):
    return redirect(reverse("app01:index"))

app02 views：

from django.shortcuts import render, redirect, reverse

def redirect_to_index(request):
    return redirect(reverse("app02:index"))

django2.0版的path

urlpatterns = [  
    re_path('articles/(?P<year>[0-9]{4})/', year_archive),  
    re_path('article/(?P<article_id>[a-zA-Z0-9]+)/detail/', detail_view),  
    re_path('articles/(?P<article_id>[a-zA-Z0-9]+)/edit/', edit_view),  
    re_path('articles/(?P<article_id>[a-zA-Z0-9]+)/delete/', delete_view),  
]

    两个问题：

• 函数year_archive中year参数是字符串类型，若是须要先转化为整数类型的变量值，固然year=int(year)不会有诸如如TypeError或者ValueError的异常。那么有没有一种方法，在url中，使得这一转化步骤能够由Django自动完成？
• 三个路由中article_id都是一样的正则表达式，可是须要写三遍，当以后article_id规则改变后，须要同时修改三处代码，那么有没有一种方法，只需修改一处便可？

    在Django 2.0中，可使用path解决以上问题

基本示例

from django.urls import path  
from . import views  
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>/', views.article_detail),  
] 

基本规则：

• 使用尖括号(<>)从url中捕获值
• 捕获值中能够包含一个转化器类型(converter type)，好比使用<int:name>捕获一个整数变量。若是没有转化器，将匹配任何字符串，固然也包括了/字符
• 无需添加前导斜杠

    如下根据2.0官方文档而整理的示例分析表：

path转化器

"""文档原文Path converters, 暂且翻译为转化器"""

    Django默认支持如下5个转化器：

• str，匹配除了路径分隔符( / )以外的非空字符串，这是默认的形式
• int，匹配正整数，包含0
• slug，匹配字母、数字以及横杠、下划线 组成的字符串
• uuid，匹配格式化的uuid，如075194d3-6885-417e-a8a8-6c931e272f00
• path，匹配任何非空字符串，包含了路径分隔符

注册自定义转化器

    对于一些复杂或者复用的须要， 能够定义本身的转化器。转化器是一个类或接口，它地要求有三点：

• regex类属性，字符串类型
• to_python(self, value)方法，value是由类属性regex所匹配到的字符串，返回具体的Python变量值，以供Django传递到对应的视图函数中
• to_url(self, vlaue)方法，和to_python相反，value是一个具体的Python变量值，返回其字符串，一般用于反向引用

class FourDigitYearConverter:  
    regex = '[0-9]{4}'  
    def to_python(self, value):  
        return int(value)  
    def to_url(self, value):  
        return '%04d' % value  

使用register_converter将其注册到URL配置中：

from django.urls import register_converter, path  
from app01 import converters, views  
register_converter(converters.FourDigitYearConverter, 'yyyy')  
urlpatterns = [  
    path('articles/2003/', views.special_case_2003),  
    path('articles/<yyyy:year>/', views.year_archive),  
    ...  
]