Django 路由层

news/2024/11/27 11:45:50/

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/news/1550339.html

相关文章

【MySQL系列】通过创建新表备份`password`字段

&#x1f49d;&#x1f49d;&#x1f49d;欢迎来到我的博客&#xff0c;很高兴能够在这里和您见面&#xff01;希望您在这里可以感受到一份轻松愉快的氛围&#xff0c;不仅可以获得有趣的内容和知识&#xff0c;也可以畅所欲言、分享您的想法和见解。 推荐:kwan 的首页,持续学…

Rust学习(十):计算机科学简述

Rust学习&#xff08;十&#xff09;&#xff1a;计算机科学简述 在计算机技术这片广袤的领域中&#xff0c;深入理解其内在机制与逻辑需要付出诸多努力。 学习基础知识是构建计算机技术能力大厦的基石&#xff0c;而这一过程往往漫长而艰辛。只有在对基础知识有了扎实的掌握…

鸿蒙学习自由流转与分布式运行环境-跨端迁移(2)

文章目录 跨端迁移应用场景 跨端迁移是指将一个软件实体从一台设备转移到另外一台设备上运行。借助跨端迁移能力&#xff0c;鸿蒙生态应用可以自由地在多个设备之间流转&#xff0c;为用户带来无缝的用户体验&#xff0c;也会为开发者带来更多的入口和流量。 跨端迁移应用场景 …

【设计模式】【行为型模式(Behavioral Patterns)】之状态模式(State Pattern)

1. 设计模式原理说明 状态模式&#xff08;State Pattern&#xff09; 是一种行为设计模式&#xff0c;它允许对象在其内部状态发生变化时改变其行为。这个模式的核心思想是使用不同的类来表示不同的状态&#xff0c;每个状态类都封装了与该状态相关的特定行为。当对象的状态发…

2024.9 Pruning Cycles in UMLS Metathesaurus: A NeuroSymbolic AI Approach

UMLS Metathesdragon 中的修剪周期&#xff1a;一种神经符号 AI 方法 UMLS Metathesdragon 中的修剪周期&#xff1a;一种神经符号 AI 方法 Richard Wallace1、Ravi Bajracharya1、Jans Aasman1 和 Craig Norvell1 Franz Inc https://allegrograph.com/wp-content/uploads/2…

安装Docker报错TCP connection reset by peer或者Timeout

原因&#xff1a;访问的外网下载导致超时或者断连接报错 修改为国内阿里下载地址 yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

ES索引模板操作

在使用 Kibana 操作 Elasticsearch 索引模板时&#xff0c;可以通过 Kibana Dev Tools 控制台来执行相应的命令。以下是一些常见的增删改操作示例&#xff1a; 创建索引模板 要创建一个新的索引模板&#xff0c;可以使用 PUT 请求。以下是一个创建索引模板的示例&#xff1a;…

第三十天 NODE.js的使用 node 编写登录页面 文件管理 数据库互联 以及 相应的安全问题

前言 学习node.js 就是因为这个 node.js 和前端的js是不同的 因为他是运行在 服务器端的 而前端的只能运行在 浏览器 前端的js 很容易就被捕捉内容 但是 node.js 其实和php一样 我们学习的目的就是 以后碰到这样的 问题 会解决 也要了解 node.js 相应的安全问题 …