• 10.1 路由系统基础
  • 10.1.1 认识URLconf
    • 概念的角度理解URLconf
  • 10.1.2 URL模式定义相关的函数
    • path函数
      • kwargs参数用法
    • re_path函数
    • include函数
    • register_converter函数
  • 10.1.3 路由参数的传递
    • 1. 无参数传递
    • 2. URL模式参数绑定
    • 3. 请求传参
    • 4. 动态路由参数捕获
  • 10.1.4 自定义错误页面
    • 自定义错误页面
      • 修改系统配置
      • 定义错误页面模板文件
      • 定义错误处理视图
      • 配置handler

---

• 什么是URLconf
• URLconf实现什么功能
• URL路由定义的语法
• 不同的定义方式实现了什么样的效果
• URL中参数传递的几种形式

---

10.1.1 认识URLconf

• 目的：定义URL与视图之间的映射表，实现将不同的URL分发给不同的视图处理函数

概念的角度理解URLconf

理解是什么；在一次HTTP请求的过程中扮演什么样的角色

• 创建Django项目（django-admin startproject），执行此命令就会在当前的项目中创建一份URLconf，即urls.py文件，同时创建的settings.py文件中还定义了变量ROOT_URLCONF指向了这个URLconf

• URLconf(urls.py文件)

  • urlpatterns：是一个列表，列表中的元素成为URL成为URL模式，每个模式定义了一个URL的基本格式。URL模式实现了两类绑定
    • 第一类：URL与视图函数的绑定，及URL关联到处理方法
    • 第二类：URL与URLconf的绑定，实现路由分发

• ROOT_URLCONF：即根URLconf。作为URL查找的入口

• URLconf的查找，Django定义了以下两个规则

  • HTTP请求中的URL被认为是一个普通的python字符串，进行匹配时不包含请求参数和域名
  • URLconf不会检查HTTP请求类型，即不论GET POST PUT或HEAD，都会路由到同一个视图函数

• Django推荐的路由做法：每个应用都定义自己的URLconf，并在根URLconf中声明;(URL的分级概念)

  • 如：path('post/', include('post.urls'))

10.1.2 URL模式定义相关的函数

• 为视图函数定义URL模式，主要涉及：path，re_path，include，register_converter

path函数

• 用于定义URL模式，一般用于定义常规的字符串路由
• (partial 是偏函数)
• path实际是对_path函数（partial中传递的第一个参数）的包装，且指定了_path函数的Pattern参数为RoutePattern
• _path的前四个参数
  • route：必填参数，是包含URL模式的字符串或gettext_lazy函数（实现对字符串的惰性存储，在真正被用到时才会去翻译）的返回值
  • view：必填参数，可传递两种类型
    • 视图函数或基于类的视图的as_view方法的结果，此类参数在Python中称为可调用对象
    • 是调用include函数的返回值，是一个元组对象
  • kwargs：选填参数，字典类型，需要给目录视图传递参数
  • name：选填参数，给URL模式命令，非常有用；通常在重定向和模板中被引用到，即使修改了route，也不需要修改引用的地方

kwargs参数用法

例子：

# urls.py
path('topic/<int:topic_id>/', views_topic_detail_view, kwargs={"foo":"bar"})

# views.py
# 访问 post/topic/1/ 实际调用视图传递的参数为
topic_detail_view(request, topic_id=1, foo='bar')

# 注意
# 要求topic_detail_view视图定义的参数中包含foo

• 当存在参数冲突问题时，以URL中的参数为准（默认只认URL中的参数）

re_path函数

• 定义正则表达式路由
• re_path = partial(_path, Pattern = RegexPattern)

include函数

• 用于将URLconf的完整Python路径引入另一个URLconf中
• 常见用法：在项目的跟URLconf中引入各个应用的URLconf，实现路由分发
• def include(args, namespace=None)
  • namespace: 指定实例的命名空间，可选参数
  • args的三种定义形式：module，pattern_list，（pattern_list,app_namespace）

    • module：是用于指定URLconf的Python路径；path('post/', include('post.urls', namespace='bbs_post'))

    • pattern_list：是可迭代的path或re_path实例：

      path('post_2', include(
          [path('index/', views.IndexView.as_view()),
          path('hello/', views.hello_django_bbs)]
      ))

      • 这样只会包含post应用下的两个URL模式：/post_2/index和/post_2/hello
      • 此类形式不能指定namespace

    • (pattern_list,app_namespace):

      path('post_2', include(
          (
              [path('index/', views.IndexView.as_view()),
              path('hello', views.hello_django_bbs),
              'post]
          ),
          namespace='bbs_post2'
      ))

register_converter函数

• 用于注册path函数中route参数用到的转换器
• def register_converter(converter, type_name)
  • converter: 转换器类
  • type_name：转换器名称，在route中被使用

10.1.3 路由参数的传递

1. 无参数传递

• 通常是欢迎页或者出错页的视图定义，不需要任何处理逻辑，直接返回结果

• 此类视图也称为静态路由，即URL是固定不变的，且不需要在URL中传递参数

  # views.py
  def hello_django(request):
      pass
  
  # urls.py
  path('hello/', views.hello_django)

2. URL模式参数绑定

• 定义URL模式（path或re_path函数）时，指定kwargs，以字典的形式定义；其中的每一个键值对都将映射到视图的各个参数上去

3. 请求传参

• 请求参数存储在HttpRequest对象中

• GET请求：参数位于URL的?后面，格式为键值对的形式，以&连接

• POST请求：通过表单的形式给视图函数传递参数

• 在视图中获取请求参数的方式是类似的：GET请求通过HttpRequest的GET属性，POST请求通过P OST属性，在视图函数中获取GET请求的参数

  def get_request(request):
      a = request.GET['a']   # 需要确保URL中有传递，否则有异常
      b = request.GET.get('b','y')  # 在URL中非必需

4. 动态路由参数捕获

• 实现方式
  • 路径转换器：用在path函数中，格式:<converter:name>
    • converter: 表示转换器类
    • name：参数名
    • path('dynamic/<int:year>/<mth:month'), views.dynamic_hello)
  • 正则表达式：通过分组匹配来捕获URL中的值并以位置参数的形式传递给视图，分组：
    • 命名分组：re_path('re_dynamic/(?P<year>[0-9]{4})/(?P<month>[0-9]{2}/)',views.dynamic_hello)
    • 未命名分组：re_path('re_dynamic/([0-9]{4})/([0-9]{2}/)',views.dynamic_hello)

10.1.4 自定义错误页面

• Django给4种错误定义了“handler”处理视图

• 定义文件：django/cong/urls/__init__.py

  handler400 = defaults.bad_request
  handler403 = defaults.permission_denied
  handler404 = defaults.page_not_found
  handler500 = defaults.server_error

• handler名称固定，不可以修改

• 处理错误的视图定义在:django/views/defaults.py

自定义错误页面

• 实现过程，4个步骤
  • 修改系统配置
  • 定义错误页面模板文件
  • 定义错误处理视图
  • 配置handler

修改系统配置

自定义的错误页面只会在非调试模式下生效，所以需要修改配置文件settings.py

• （1）将DEBUG设置为False，标识当前处于非调试模式。
• （2）非调试模式下需要指定ALLOWED_HOSTS，这里将它简单地设置为['*']，代表允许所有的域名访问

定义错误页面模板文件

• 在templates下创建模板文件
  • 404.html
  • 400.html
  • 403.html
  • 500.html

定义错误处理视图

• 对于404错误，Django实现的是:defaults.page_not_found

• 自定义错误处理视图，在应用下的views.py文件中定义

  # 400
  def bad_request(request, exception, tempalte_name='post/400.html'):
      return render(request, template_name)
  # exception: 保存异常的信息
  # 403
  def permission_denied(request, exception, template_name='post/403.html'):
      return render(request, tempalte_name)
  
  # 404
  def page_not_found(request, exception, template_name='post/404.html'):
      return render(request, tempalte_name)
  
  # 500
  def server_error(request, template_name='post/500.html'):
      return render(request, tempalte_name)

配置handler

• 指定错误处理handler的入口，需要在项目的urls.py文件中指定

  # project/urls.py
  handler400 = defaults.bad_request
  handler403 = defaults.permission_denied
  handler404 = defaults.page_not_found
  handler500 = defaults.server_error

版权所有

本文链接：/python/9w49btb4/

许可证：署名 4.0 国际 (CC-BY-4.0)