Django 路由层

server/2024/11/27 9:41:49/

1. 路由基础概念

  • URLconf (URL 配置):Django 的路由系统是基于 urls.py 文件定义的。
  • 路径匹配:通过模式匹配 URL,并将请求传递给对应的视图处理函数。
  • 命名路由:每个路由可以定义一个名称,用于反向解析。

2. 基本路由配置

示例 urls.py 文件

from django.urls import path
from . import viewsurlpatterns = [path('', views.home, name='home'),  # 根路径path('about/', views.about, name='about'),  # 静态路径path('article/<int:id>/', views.article_detail, name='article-detail'),  # 动态参数
]

# views.pyfrom django.http import HttpResponsedef home(request):return HttpResponse("Welcome to the Home page!")def about(request):return HttpResponse("This is the About page.")def article_detail(request, id):return HttpResponse(f"Article Detail for Article {id}")

  • path() 函数
    • 第一个参数:URL 模式。
    • 第二个参数:对应的视图函数。
    • 第三个参数(可选):name 用于反向解析。

3. 动态路由

动态路由允许在 URL 中传递参数。

示例

urlpatterns = [path('user/<int:user_id>/', views.user_profile, name='user-profile'),  # 整数参数path('post/<slug:slug>/', views.post_detail, name='post-detail'),      # 字符串参数path('date/<int:year>/<int:month>/', views.archive, name='archive'),   # 多参数
]

# views.py
from django.http import HttpResponsedef user_profile(request, user_id):return HttpResponse(f"User Profile for user {user_id}")def post_detail(request, slug):return HttpResponse(f"Post Detail for post {slug}")def archive(request, year, month):return HttpResponse(f"Archive for {year}-{month}")

支持的路径转换器:

转换器描述示例
str匹配任意非空字符串(默认类型)'hello/'
int匹配正整数'123/'
slug匹配字母、数字、-_'my-post-slug/'
uuid匹配 UUID 格式'550e8400-e29b-...'
path匹配包含 / 的字符串'some/path/'

4. 子路由与 include

Django 推荐在大型项目中将路由分模块管理。

示例:主路由

from django.urls import path, includeurlpatterns = [path('blog/', include('blog.urls')),  # 引入子路由path('shop/', include('shop.urls')),  # 引入另一个应用的路由
]

示例:子路由(blog/urls.py

from django.urls import path
from . import viewsurlpatterns = [path('', views.blog_home, name='blog-home'),path('<int:post_id>/', views.blog_post, name='blog-post'),
]

# blog/views.pyfrom django.http import HttpResponsedef blog_home(request):return HttpResponse("Welcome to the blog home page.")def blog_post(request, post_id):return HttpResponse(f"Blog Post with ID {post_id}")

URL /blog//blog/123/ 将分别被子路由处理。


5. 命名空间

在大型项目中,为不同应用的路由定义命名空间,避免路由名称冲突。

主路由配置

from django.urls import path, includeurlpatterns = [path('blog/', include(('blog.urls', 'blog'), namespace='blog')),  # 定义命名空间
]

子路由配置(blog/urls.py

from django.urls import path
from . import viewsapp_name = 'blog'  # 命名空间urlpatterns = [path('', views.home, name='home'),path('<int:post_id>/', views.post_detail, name='post-detail'),
]

使用反向解析

from django.urls import reverse# 使用命名空间解析路由
url = reverse('blog:post-detail', kwargs={'post_id': 1})  # 返回 /blog/1/

6. 正则表达式路由

如果路径匹配需要更复杂的规则,可以使用 re_path,支持正则表达式。

* 示例:  在2.x以上版本 无名分组 有名分组 可以用 re_path 实现

# urls.pyfrom django.urls import re_path
from . import viewsurlpatterns = [# 无名分组re_path(r'^page/(\d+)/$', views.page_view, name='page-view'),# 有名分组re_path(r'^page/(?P<page_number>\d+)/$', views.page_view, name='page-view'),
]

路径 /page/123/ 会被捕获为 page_number=123


# views.pyfrom django.http import HttpResponsedef page_view(request, page_number):return HttpResponse(f"Page number: {page_number}")


7. 路由中的默认值

可以为动态路由提供默认值,以减少 URL 的复杂度。

示例

from django.urls import path
from . import viewsurlpatterns = [path('profile/<str:username>/', views.profile, name='profile'),path('profile/', views.profile, {'username': 'default_user'}, name='default-profile'),
]

请求 /profile/ 将自动解析为 username='default_user'


# views.pyfrom django.http import HttpResponsedef profile(request, username='default_user'):return HttpResponse(f"User profile: {username}")

8. 类视图的路由

在路由中,可以直接绑定类视图。

示例

# urls.pyfrom django.urls import path
from .views import HomeView, ArticleViewurlpatterns = [path('', HomeView.as_view(), name='home'),path('article/<int:pk>/', ArticleView.as_view(), name='article-detail'),
]

类视图必须使用 .as_view() 方法绑定。


# views.pyfrom django.views import View
from django.http import HttpResponseclass HomeView(View):def get(self, request):return HttpResponse("Welcome to the Home page!")class ArticleView(View):def get(self, request, pk):return HttpResponse(f"Article Detail for Article {pk}")

9. 自定义路由转换器

Django 支持自定义路径转换器,用于处理特定格式的路径。

定义自定义转换器

converters.py 中:

class FourDigitYearConverter:regex = r'\d{4}'def to_python(self, value):return int(value)def to_url(self, value):return f'{value}'

局部注册转换器

urls.py 中:

from django.urls import path, register_converter
from .converters import FourDigitYearConverterregister_converter(FourDigitYearConverter, 'yyyy')urlpatterns = [path('year/<yyyy:year>/', views.year_archive, name='year-archive'),
]

请求 /year/2024/ 将解析为 year=2024


 * 也可以用继承

导包

from django.urls.converters import StringConverterclass FourDigitYearConverter(StringConverter):regex = r'\d{4}'def to_python(self, value):return int(value)def to_url(self, value):return f'{value}'


 * 全局注册

from django.urls.converters import StringConverter, DEFAULT_CONVERTERSDEFAULT_CONVERTERS['yyyy'] = FourDigitYearConverter


# views.pyfrom django.http import HttpResponsedef year_archive(request, year):return HttpResponse(f"Year Archive for {year}")

10. 静态文件与媒体文件路由

Django 开发模式下可以通过路由处理静态文件和媒体文件。

配置 settings.py

from pathlib import PathBASE_DIR = Path(__file__).resolve().parent.parentSTATIC_URL = '/static/'
MEDIA_URL = '/media/'STATICFILES_DIRS = [BASE_DIR / "static"]
MEDIA_ROOT = BASE_DIR / "media"

配置 urls.py

from django.conf import settings
from django.conf.urls.static import staticurlpatterns = [# 其他路由
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

总结

Django 路由是通过 urls.py 文件进行管理的,支持以下特性:

  1. 静态和动态路由:支持静态路径和动态参数传递。
  2. 子路由与命名空间:方便模块化管理,避免路由名称冲突。
  3. 反向解析:通过路由名称动态生成 URL。
  4. 自定义转换器:处理自定义路径格式。
  5. 正则表达式路由:支持复杂路径匹配。

路由系统是 Django 项目请求处理的起点,合理设计路由结构能显著提高项目的可维护性

* 11. 前后端反向解析 

解析方式方法示例代码解析结果
前端解析{% url 'route-name' %}<a href="{% url 'about' %}">About</a>/about/
后端解析reverse('route-name')reverse('about')/about/
动态参数reverse/{% url %}reverse('article-detail', kwargs={'id': 42})/article/42/
命名空间reverse/{% url %}{% url 'blog:post-detail' post_id=5 %}/blog/5/
延迟解析reverse_lazyreverse_lazy('profile', kwargs={...})/profile/...

http://www.ppmy.cn/server/145304.html

相关文章

Python人工智能项目报告

一、实践概述 1、实践计划和目的 在现代社会&#xff0c;计算机技术已成为支撑社会发展的核心力量&#xff0c;渗透到生活的各个领域&#xff0c;应关注人类福祉&#xff0c;确保自己的工作成果能够造福社会&#xff0c;同时维护安全、健康的自然环境&#xff0c;设计出具有包…

计算机网络习题解答--个人笔记(未完)

本篇文章为关于《计算机网络-自顶向下方法第七版》的阅读总结和课后习题解答(未完待续) 第二章&#xff1a; cookie&#xff1a;&#xff08;这里是比较老版本的HTTP&#xff0c;具体HTTPs是怎么实现的不是很清楚&#xff09;cookie的原理其实很简单。就是在HTTP消息头上又多…

spring boot有那些优势?

Spring Boot 作为 Spring 框架的一个扩展&#xff0c;旨在简化新 Spring 应用程序的初始搭建以及开发过程。它通过提供一系列默认配置来快速启动基于 Spring 的应用&#xff0c;并且减少了大量的样板代码和配置工作。以下是使用 Spring Boot 的一些主要优势&#xff1a; 简化配…

文件上传代码分析

目录 不同类型的语言脚本语⾔/解释型语⾔⼀次编译到处运⾏编译型语⾔ 不同语⾔的webshell上传差异脚本语⾔/解释型语⾔⼀次编译到处运⾏编译型语⾔ ⽂件上传到webshell任意⽂件上传js检测解析规则MIME⽂件头后缀检测失效 NTFS Tricks 不同类型的语言 脚本语⾔/解释型语⾔ 代表…

Redis设计与实现第14章 -- 服务器 总结(命令执行器 serverCron函数 初始化)

14.1 命令请求的执行过程 一个命令请求从发送到获得回复的过程中&#xff0c;客户端和服务器都需要完成一系列操作。 14.1.1 发送命令请求 当用户在客户端中输入一个命令请求的时候&#xff0c;客户端会把这个命令请求转换为协议格式&#xff0c;然后通过连接到服务器的套接字…

大数据新视界 -- 大数据大厂之 Hive 数据桶:优化聚合查询的有效手段(下)(10/ 30)

&#x1f496;&#x1f496;&#x1f496;亲爱的朋友们&#xff0c;热烈欢迎你们来到 青云交的博客&#xff01;能与你们在此邂逅&#xff0c;我满心欢喜&#xff0c;深感无比荣幸。在这个瞬息万变的时代&#xff0c;我们每个人都在苦苦追寻一处能让心灵安然栖息的港湾。而 我的…

刷题日常(移动零,盛最多水的容器,三数之和,无重复字符的最长子串)

移动零 给定一个数组 nums&#xff0c;编写一个函数将所有 0 移动到数组的末尾&#xff0c;同时保持非零元素的相对顺序。 请注意 &#xff0c;必须在不复制数组的情况下原地对数组进行操作。 俩种情况&#xff1a; 1.当nums[i]为0的时候 直接i 2.当nums[i]不为0的时候 此时 …

Java面试之多线程并发篇

前言 本来想着给自己放松一下&#xff0c;刷刷博客&#xff0c;突然被几道面试题难倒&#xff01;说一说自己对于 synchronized 关键字的了解&#xff1f;说说自己是怎么使用 synchronized 关键字&#xff1f;什么是线程安全&#xff1f;Vector是一个线程安全类吗&#xff1f;…