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),  
    ...  
]

posted @ 2019-02-14 11:26 Ethan_Y 阅读(125) 评论(0) 收藏举报

刷新页面返回顶部