Django的路由层(URLconf)

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

urlpatterns = [
    url(正则表达式, views视图函数,参数,别名),
]

  参数说明:

  • 一个正则表达式字符串
  • 一个可调用对象,通常为一个视图函数或一个指定视图函数路径的字符串
  • 可选的要传递给视图函数的默认参数(字典形式)
  • 一个可选的别名(name)参数
view:
当正则表达式匹配到某个条目时,自动将封装的HttpRequest对象作为第一个参数,正则表达式“捕获”到的值作为第二个参数,传递给该条目指定的视图。
如果是简单捕获,那么捕获值将作为一个位置参数进行传递,如果是命名捕获,那么将作为关键字参数进行传递。 kwargs: 任意数量的关键字参数可以作为一个字典传递给目标视图。 name: 对你的URL进行命名,可以让你能够在Django的任意处,尤其是模板内显式地引用它。相当于给URL取了个全局变量名,你只需要修改这个全局变量的值,
在整个Django中引用它的地方也将同样获得改变。这是极为古老、朴素和有用的设计思想,而且这种思想无处不在。

 

一、简单的路由配置

1、在/first_pro/first_pro/urls.py中进行路由配置

from django.contrib import admin
from django.urls import path,re_path, include

from app01 import views


urlpatterns = [
    path('admin/', admin.site.urls),
    path('timer/', views.timer),

    path('login/', views.login),

    # 路由配置:  路径--------->视图函数
    # 正则匹配:r'^articles/2003/$'  以articles/2003/开头且以articles/2003/结尾
    re_path(r'^articles/2003/$', views.special_case_2003),  # special_case_2003(request)

    # 正则匹配四位的任意数字,多对一
    re_path(r'^articles/(/[0-9]{4})/$', views.year_archive),  # year_archive(request,1999)

    # 正则匹配一个四位的数字作为年,还要匹配一个2位的数字作为月
    # re_path(r'^articles/([0-9]{4})/([0-9]{2})/$', views.month_archive),  # month_archive(request,2009,12)

    # 改写为有名分组
    re_path(r'^articles/(?P<y>[0-9]{4})/(?P<m>[0-9]{2})/$', views.month_archive)  # month_archive(request,y=2009,m=12)

    # ([0-9]+):匹配前面的数字一次或无限次作为详情
    # re_path(r'^articles/([0-9]{4})/([0-9]{2})/([0-9]+)/$', views.article_detail)
]

注意:

  • 若要从URL中捕获一个值,值需要在它周围放置一对圆括号。

  • 不需要添加一个前导的反斜杠,因为每个URL都有。例如,应该是^articles而不是^/articles。

  • 每个正则表达式前面的'r'是可选的但是建议加上。它告诉python这个字符串是“原始的”—— 字符串中任何字符都不应该转义

2、/first_pro/app01/views.py编写对应的视图函数

from django.shortcuts import render,HttpResponse

def timer(request):
    import time
    ctime = time.strftime('%Y-%m-%d %H:%M:%S')   # 2018-06-30 05:48:11
    """
    render方法:
        1、帮忙找到timer.html取出里面的数据;
        2、按照固定的语法({})把变量嵌套到html文件中
    """
    return render(request, 'timer.html', {"date":ctime})    # 使用render方法,返回一个页面


def special_case_2003(request):
    return HttpResponse("special_case_2003")   # HttpResponse:响应对象


def year_archive(request,year):
    return HttpResponse(year)

def month_archive(request,y,m):
    return HttpResponse(y+"-"+m)

3、访问调用示例

'''
一些请求的例子:

/articles/2005/03/ 请求将匹配列表中的第三个模式。Django 将调用函数views.month_archive(request, '2005', '03')。
/articles/2005/3/ 不匹配任何URL 模式,因为列表中的第三个模式要求月份应该是两个数字。
/articles/2003/ 将匹配列表中的第一个模式不是第二个,因为模式按顺序匹配,第一个会首先测试是否匹配。请像这样自由插入一些特殊的情况来探测匹配的次序。
/articles/2003 不匹配任何一个模式,因为每个模式要求URL 以一个反斜线结尾。
/articles/2003/03/03/ 将匹配最后一个模式。Django 将调用函数views.article_detail(request, '2003', '03', '03')。
'''

4、设置项是否开启URL访问地址后面不为/ 跳转至带有/的路径

APPEND_SLASH=True

二、有名分组(named group)

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

  在Python 正则表达式中,命名正则表达式组的语法是(?Ppattern),其中name 是组的名称,pattern 是要匹配的模式。 下面是以上URLconf 使用命名组的重写:

from django.urls import path,re_path

from app01 import views

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

  这个实现与前面的示例完全相同,只有一个细微的差别:捕获的值作为关键字参数而不是位置参数传递给视图函数。例如视图函数month_archive:

def month_archive(request,year,month):
    return HttpResponse(year+"-"+month)

  url访问调用效果如下:

/articles/2005/03/ 
请求将调用views.month_archive(request, year='2005', month='03')函数,而不是views.month_archive(request, '2005', '03')。

/articles/2003/03/03/ 
请求将调用函数views.article_detail(request, year='2003', month='03', day='03')

  在实际应用中,这意味你的URLconf 会更加明晰且不容易产生参数顺序问题的错误 —— 你可以在你的视图函数定义中重新安排参数的顺序。当然,这些好处是以简洁为代价;有些开发人员认为命名组语法丑陋而繁琐。

三、应用include函数实现分发

  为了实现路由解耦,创建/first_pro/app01/urls.py文件。将/first_pro/first_pro/urls.py中关于app01的路由配置注释。

1、应用include函数设置/first_pro/app01/urls分发路径

from django.contrib import admin
from django.urls import path,re_path, include

from app01 import views


urlpatterns = [
    path('admin/', admin.site.urls),
    path('timer/', views.timer),

    path('login/', views.login),

    #分发:
    # re_path(r"app01/", include("app01.urls"))
    # 改写如下:不用app01
    re_path(r"^", include("app01.urls"))
]

(1)分发总结

  1)分发配置为re_path(r"app01/", include("app01.urls"))时:访问页面需要按照如下规则:

    

  2)分发配置为re_path(r"^", include("app01.urls"))时:访问页面不需要添加app01:

    

(2)include使用注意

  1)include() 的正则表达式并不包含一个 $ (字符串结尾匹配符),但是包含了一个斜杆/;

  2)每当Django遇到 include() 时,它将截断匹配的URL,并把剩余的字符串发往包含的URLconf作进一步处理。

2、在/first_pro/app01/urls.py进一步配置app01路由

# -*- coding:utf-8 -*-
__author__ = 'Qiushi Huang'


from django.contrib import admin
from django.urls import path,re_path

from app01 import views


urlpatterns = [
    # 路由配置:  路径--------->视图函数
    # 正则匹配:r'^articles/2003/$'  以articles/2003/开头且以articles/2003/结尾
    re_path(r'^articles/2003/$', views.special_case_2003),  # special_case_2003(request)

    # 正则匹配四位的任意数字,多对一
    re_path(r'^articles/([0-9]{4})/$', views.year_archive),  # year_archive(request,1999)

    # 正则匹配一个四位的数字作为年,还要匹配一个2位的数字作为月
    # re_path(r'^articles/([0-9]{4})/([0-9]{2})/$', views.month_archive),  # month_archive(request,2009,12)

    # 改写为有名分组
    re_path(r'^articles/(?P<y>[0-9]{4})/(?P<m>[0-9]{2})/$', views.month_archive)  # month_archive(request,y=2009,m=12)

    # ([0-9]+):匹配前面的数字一次或无限次作为详情
    # re_path(r'^articles/([0-9]{4})/([0-9]{2})/([0-9]+)/$', views.article_detail)
]

四、路由控制——登录验证示例

1、在/first_pro/first_pro/urls.py中,编写路由配置login:

from django.contrib import admin
from django.urls import path,re_path, include

from app01 import views


urlpatterns = [
    path('admin/', admin.site.urls),
    path('timer/', views.timer),
    path('login/', views.login)
]

2、修改/first_pro/app01/views.py文件,配置login视图函数

from django.shortcuts import render,HttpResponse

def login(request):
    print(request.method)  # GET或POST
    # get请求来的话拿到页面,post请求来的话做校验
    if request.method == 'GET':
        return render(request, "login.html")
    # post请求
    else:  
        print(request.POST)  # <QueryDict: {'user': ['yuan'], 'pwd': ['123']}>

        user = request.POST.get("user")
        pwd = request.POST.get("pwd")

        if user=="yuan" and pwd=="123":
            return HttpResponse("登录成功")  # 返回字符串
        else:
            return HttpResponse("用户名或密码错误!")

  取请求的方式:request.method。

  得到GET请求的时候,通过render方法拿到页面;得到POST请求的时候,由于request.POST得到一个字典,通过get()方法拿到键值。

3、在/first_pro/templates/中,创建login.html模板

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <!--在不指名action的情况下,默认使用当前页面的ip地址和端口(同源)-->
    <form action="http://127.0.0.1:8000/login/" method="post">
        用户名 <input type="text" name="user">
        密码 <input type="password" name="pwd">
        <input type="submit">
    </form>
</body>
</html>

  action代表的是一个路径。由于同源的原因,可以写为action="http://127.0.0.1:8000/login/",也可以写为action="/login/"。

  由于提交的是login函数,在urls.py控制器中查找到对应的path('login/', views.login)。找到对应的视图函数来进行处理。

4、在浏览器登录,输入正确用户名和密码后,执行效果:

  

五、路由控制——反向解析

  在使用Django 项目时,一个常见的需求是获得URL 的最终形式,以用于嵌入到生成的内容中(视图中和显示给用户的URL等)或者用于处理服务器端的导航(重定向等)。人们强烈希望不要硬编码这些URL(费力、不可扩展且容易产生错误)或者设计一种与URLconf 毫不相关的专门的URL 生成机制,因为这样容易导致一定程度上产生过期的URL。

  获取一个URL 最开始想到的信息是处理它视图的标识(例如名字),查找正确的URL 的其它必要的信息有视图参数的类型(位置参数、关键字参数)和值。

Django 提供一个办法是让URL 映射是URL 设计唯一的地方。你填充你的URLconf,然后可以双向使用它:

  • 根据用户/浏览器发起的URL 请求,它调用正确的Django 视图,并从URL 中提取它的参数需要的值。
  • 根据Django 视图的标识和将要传递给它的参数的值,获取与之关联的URL

  第一种方式是我们在前面一直讨论的用法。第二种方式叫做反向解析URL、反向URL 匹配、反向URL 查询或者简单的URL 反查

在需要URL 的地方,对于不同层级,Django 提供不同的工具用于URL 反查:

  • 在模板中:使用url 模板标签。
  • 在Python 代码中:使用django.core.urlresolvers.reverse() 函数。
  • 在更高层的与处理Django模型实例相关的代码中:使用get_absolute_url() 方法。

1、在模板中实现反向解析

(1)修改配置/first_pro/first_pro/urls.py,设置别名

from django.contrib import admin
from django.urls import path,re_path, include

from app01 import views


urlpatterns = [
    path('admin/', admin.site.urls),
    path('timer/', views.timer),

    # path('login/', views.login),
    path('login.html', views.login, name='Log'),
]

(2)修改模板first_pro/templates/login.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <!--在不指名action的情况下,默认使用当前页面的ip地址和端口(同源)-->
    <!--<form action="http://127.0.0.1:8000/login/" method="post">-->
    <form action="{% url 'Log' %}" method="post">
        用户名 <input type="text" name="user">
        密码 <input type="password" name="pwd">
        <input type="submit">
    </form>
</body>
</html>

  注意form表单的修改。

(3)从新路由地址访问

  

注意:

  1)模板中的<form action="{% url 'Log' %}" method="post">,在页面渲染

时改为了<form action="/login/html" method="post">。django在执行return render(request,"login.html")时,并不是直接返回的login.html页面,而是经过了处理(主要是渲染模板语法)。

  2)模板语法有两种:一种是"{{ }}";一种是"{% %}"。在遇到这两种情况时,会进行相应的语法渲染,将渲染的结果交给页面浏览器。

2、使用django.core.urlresolvers.reverse() 函数实现反向解析

(1)在/first_pro/app01/urls.py中给视图函数路由配置别名:

from django.contrib import admin
from django.urls import path,re_path

from app01 import views

urlpatterns = [
    # 路由配置:  路径--------->视图函数
    # 正则匹配:r'^articles/2003/$'  以articles/2003/开头且以articles/2003/结尾
    re_path(r'^articles/2003/$', views.special_case_2003, name="s_c_2003"),  # special_case_2003(request)

    # 正则匹配四位的任意数字,多对一
    re_path(r'^articles/([0-9]{4})/$', views.year_archive, name="y_a"),  # year_archive(request,1999)

    # 正则匹配一个四位的数字作为年,还要匹配一个2位的数字作为月
    # re_path(r'^articles/([0-9]{4})/([0-9]{2})/$', views.month_archive),  # month_archive(request,2009,12)

    # 改写为有名分组
    re_path(r'^articles/(?P<y>[0-9]{4})/(?P<m>[0-9]{2})/$', views.month_archive)  # month_archive(request,y=2009,m=12)

    # ([0-9]+):匹配前面的数字一次或无限次作为详情
    # re_path(r'^articles/([0-9]{4})/([0-9]{2})/([0-9]+)/$', views.article_detail)
]

(2)修改/first_pro/first_pro/urls.py配置(为了修改路径区分更大)

from django.contrib import admin
from django.urls import path,re_path, include

from app01 import views


urlpatterns = [
    path('admin/', admin.site.urls),
    path('timer/', views.timer),

    # path('login/', views.login),
    path('login.html/', views.login, name='Log'),

    #分发:
    # re_path(r"app01/", include("app01.urls"))
    # 改写如下:不用app01
    # re_path(r"^", include("app01.urls"))

    re_path(r"^app01/", include("app01.urls"))
]

(3)在/first_pro/app01/views.py中导入反向解析

from django.shortcuts import render,HttpResponse

# Create your views here.

# 反向解析函数
from django.urls import reverse

def timer(request):
    import time
    ctime = time.strftime('%Y-%m-%d %H:%M:%S')   # 2018-06-30 05:48:11

    url = reverse("s_c_2003")
    url = reverse("y_a", args=(4009,))  # '^articles/([0-9]{4})/$'
    print(url)  # /app01/articles/4009/

    """
    render方法:
        1、帮忙找到timer.html取出里面的数据;
        2、按照固定的语法({})把变量嵌套到html文件中
    """
    return render(request, 'timer.html', {"date":ctime})    # 使用render方法,返回一个页面

(4)在浏览器访问http://127.0.0.1:8000/timer/,在程序控制台输出:

  /app01/articles/4009/,可以发现反向解析放在任意视图中均可以生效。

六、路由控制——名称空间

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

  由于name没有作用域,Django在反解URL时,会在项目全局顺序搜索,当查找到第一个name指定URL时,立即返回。

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

1、不同app定义相同name,URL反解现象

  1)创建app02应用

$ python3 manage.py startapp app02

  2)文件配置修改

/first_pro/first_pro/urls.py:

from django.contrib import admin
from django.urls import path,re_path, include

from app01 import views

urlpatterns = [
    path('admin/', admin.site.urls),
    path('timer/', views.timer),

    #分发:
    re_path(r"^app01/", include("app01.urls")),
    re_path(r"^app02/", include("app02.urls")),
]

/first_pro/app01/urls.py:

urlpatterns = [
    # 路由配置:  路径--------->视图函数
    # re_path("index/", views.index)
    re_path("index/", views.index, name="index")
]

/first_pro/app02/urls.py:

urlpatterns = [
    # 路由配置:  路径--------->视图函数
    # re_path("index/", views.index)
    re_path("index/", views.index, name= "index")   # 别名重复
]

/first_pro/app01/views.py:

# 反向解析函数
from django.urls import reverse

def index(request):
    # 反向解析
    return HttpResponse(reverse("index"))

/first_pro/app02/views.py:

# 反向解析函数
from django.urls import reverse

def index(request):
    # 反向解析
    return HttpResponse(reverse("index"))

  3)在页面上访问这两个应用地址

      

  可以看到两个都解析为/app02/index/,可以看出在不同app中出现两个别名重复,导致了URL反解错误。

2、命名空间解决URL反解错误

  1)配置命名空间 

/first_pro/first_pro/urls.py:

from django.contrib import admin
from django.urls import path,re_path, include

from app01 import views

urlpatterns = [
    path('admin/', admin.site.urls),
    path('timer/', views.timer),

    #分发:
    re_path(r"^app01/", include(("app01.urls","app01"))),   # 换为一个元组
    re_path(r"^app02/", include(("app02.urls","app02"))),
]

  注意:这里include里面包含的是一个元组 

/first_pro/app01/views.py:

from django.urls import reverse

def index(request):
    # 反向解析
    return HttpResponse(reverse("app01:index"))

/first_pro/app02/views.py: 

from django.urls import reverse

def index(request):
    # 反向解析
    return HttpResponse(reverse("app02:index"))

  2)在页面上访问测试

      

  可以看到引入了命名空间后,URL反解正常。

七、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规则改变后,需要同时修改三处代码,那么有没有一种方法,只需修改一处即可?

  在Django2.0中,可以使用 path 解决以上的两个问题。

1、基本示例

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中捕获值。相当于有名分组,括号内的int是path内置的转换器
  • 捕获值中可以包含一个转化器类型(converter type),比如使用 <int:name> 捕获一个整数变量。若果没有转化器,将匹配任何字符串,当然也包括了 / 字符。
  • 无需添加前导斜杠

对first_pro进行修改:

/first_pro/first_pro/urls.py:

from django.contrib import admin
from django.urls import path,re_path, include

from app01 import views

urlpatterns = [
    path("articles/<int:year>/",views.path_year)   # path_year(request,2010)
]

/first_pro/app01/views.py:

from django.shortcuts import render,HttpResponse

# Create your views here.
def month_archive(request,y,m):
    print(m)   # 11
    print(type(m))   # <class 'str'>
    print(y)   # 2010
    print(type(y))   # <class 'str'>
    return HttpResponse(y+"-"+m)


def path_year(request, year):
    print(year)             # 2010
    print(type(year))    # <class 'int'>
    return HttpResponse("path year")

运行效果:

  

  同时控制台输出:2010和<class 'int'>,说明使用<int:year>捕获的是一个整数变量。

以下是根据 2.0官方文档 而整理的示例分析表:  

2、path转化器(path converters)

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

Django默认支持以下5个转化器:

  • str,匹配除了路径分隔符(/)之外的非空字符串,这是默认的形式
  • int,匹配正整数,包含0
  • slug,匹配字母、数字以及横杠、下划线组成的字符串。(变量常用)
  • uuid,匹配格式化的uuid,如 075194d3-6885-417e-a8a8-6c931e272f00
  • path,匹配任何非空字符串,包含了路径分隔符 (捕获任何字符串,非空即可,但是?不行作用是分隔符)

3、注册自定义转化器

对于一些复杂或者复用的需要,可以定义自己的转化器。转化器是一个类或接口,它的要求有三点:

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

应用示例:

(1)创建/first_pro/app01/url_convert.py文件

class MonConvert:
    # regex 类属性,字符串类型。因此不能随便取其他名字
    regex = "[0-9]{2}"   # 两位的数字

    # to_python(self, value)方法,value是由类属性regex所匹配到的字符串,返回具体的Python变量值
    def to_python(self, value):
        return int(value)

    # to_url(self, value) 方法,value是一个具体的Python变量值,返回其字符串,通常用于url反向引用
    def to_url(self, value):
        return '%04d' % value

(2)注册定义的url转换器:/first_pro/first_pro/urls.py

from django.contrib import admin
from django.urls import path,re_path, include, register_converter   # 注意register_converter模块引入

from app01.url_convert import MonConvert   # 引入创建的转换器

# 注册定义的url转换器
register_converter(MonConvert, "mm")

from app01 import views

urlpatterns = [
    path("articles/<mm:month>", views.path_month)
]

(3)自定义转化器/first_pro/app01/urls.py

from django.shortcuts import render,HttpResponse

# 自定义转化器
def path_month(request, month):
    print(month, type(month))
    return HttpResponse("path month....")

(4)访问验证

  

  程序控制台输出:12 <class 'int'>,可以看到month被转化为了数字类型。

 

posted @ 2018-07-01 00:30  休耕  阅读(706)  评论(0编辑  收藏  举报