Django的路由层(URLconf)

时间  2019-11-16
标签 django 路由 urlconf 栏目 Python 繁體版
原文   原文链接

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

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

　　参数说明：python

  • 一个正则表达式字符串
  • 一个可调用对象，一般为一个视图函数或一个指定视图函数路径的字符串
  • 可选的要传递给视图函数的默认参数（字典形式）
  • 一个可选的别名(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中捕获一个值，值须要在它周围放置一对圆括号。django

  • 不须要添加一个前导的反斜杠，由于每一个URL都有。例如，应该是^articles而不是^/articles。浏览器

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

二、/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方法：
        一、帮忙找到timer.html取出里面的数据；
        二、按照固定的语法（{}）把变量嵌套到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)

三、访问调用示例

'''
一些请求的例子：

/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')。
'''

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

APPEND_SLASH=True

2、有名分组（named group）

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

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

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 会更加明晰且不容易产生参数顺序问题的错误 —— 你能够在你的视图函数定义中从新安排参数的顺序。固然，这些好处是以简洁为代价；有些开发人员认为命名组语法丑陋而繁琐。

3、应用include函数实现分发

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

一、应用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做进一步处理。

二、在/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)
]

4、路由控制——登陆验证示例

一、在/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)
]

二、修改/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()方法拿到键值。

三、在/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)。找到对应的视图函数来进行处理。

四、在浏览器登陆，输入正确用户名和密码后，执行效果：

　　

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

　　在使用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）修改配置/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）模板语法有两种：一种是"{{ }}"；一种是"{% %}"。在遇到这两种状况时，会进行相应的语法渲染，将渲染的结果交给页面浏览器。

二、使用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方法：
        一、帮忙找到timer.html取出里面的数据；
        二、按照固定的语法（{}）把变量嵌套到html文件中
    """
    return render(request, 'timer.html', {"date":ctime})    # 使用render方法，返回一个页面

（4）在浏览器访问http://127.0.0.1:8000/timer/，在程序控制台输出：

　　/app01/articles/4009/，能够发现反向解析放在任意视图中都可以生效。

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

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

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

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

一、不一样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反解错误。

二、命名空间解决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反解正常。

7、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 解决以上的两个问题。

一、基本示例

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官方文档 而整理的示例分析表：　　

二、path转化器（path converters）

　　文档原文是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, 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被转化为了数字类型。

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程