Django5 实用指南（四）URL路由与视图函数

4.1 Django5的URL路由系统

Django 的 URL 路由系统是其核心组件之一，它负责将用户的 HTTP 请求（即 URL）映射到相应的视图函数上。每当用户在浏览器中访问某个 URL 时，Django 会根据项目的 URL 配置文件（urls.py）来匹配对应的视图函数，并调用它来处理请求。

Django 的 URL 路由支持模式匹配、动态路由以及带有参数的 URL，因此它非常强大和灵活。

4.1.1 URL路由的基础结构

在 Django 中，URL 路由配置通常位于 urls.py 文件中。这个文件定义了 URL 模式和它们对应的视图函数。

Django 通过 path() 和 re_path() 函数来配置 URL 路由。path() 是 Django 推荐的方式，它使用简洁的字符串匹配模式；而 re_path() 则使用正则表达式进行更复杂的匹配。

4.1.2 使用 path()定义 URL 路由

path() 是 Django5 最常用的 URL 路由配置方法。它的基本用法如下：

from django.urls import path
from . import views

urlpatterns = [
    path('home/', views.home, name='home'),

    path('about/', views.about, name='about'),
]

在上面的代码中，我们定义了两个 URL 路由：

1. /home/ 映射到 views.home 视图函数。
2. /about/ 映射到 views.about 视图函数。

4.1.3 路由参数

Django5 的路由系统支持动态参数，允许你在 URL 中包含动态值。例如，假设你要为用户的个人资料页面定义 URL，你可以通过如下方式实现：

urlpatterns = [
    path('profile/<int:user_id>/', views.profile, name='profile'),
]

此时，URL 中的 <int:user_id> 会被动态替换为实际的 user_id，并传递给视图函数 profile()。

在视图函数中，我们可以通过参数来访问这个 user_id：

from django.shortcuts import render

def profile(request, user_id):

    # 这里的 user_id 就是从 URL 中提取的动态参数
    user = User.objects.get(id=user_id)

    return render(request, 'profile.html', {'user': user})

Django 支持多种类型的参数：

• <int>：用于提取整数类型的参数。
• <str>：用于提取字符串类型的参数。
• <slug>：用于提取由字母、数字、连字符等组成的字符串（如文章的 URL 标识符）。

4.1.4 使用 re_path()定义 URL 路由

re_path() 允许你使用正则表达式来匹配更复杂的 URL 模式。它的基本语法与 path() 类似，但它允许你使用正则表达式进行灵活的匹配。

例如，以下代码演示了如何使用正则表达式匹配 URL：

from django.urls import re_path
from . import views

urlpatterns = [

    re_path(r'^article/(?P<slug>[\w-]+)/$', views.article_detail, name='article_detail'),

]

在这个示例中，(?P<slug>[\w-]+) 是一个正则表达式，表示 URL 中的 slug 参数可以是由字母、数字、下划线和连字符组成的字符串。Django 会将匹配到的 slug 传递给 article_detail 视图函数。

4.2 视图函数的使用

视图函数是 Django 的核心部分，它是处理用户请求并返回响应的地方。在 Django 中，视图函数接收 HTTP 请求，并返回一个 HTTP 响应。

4.2.1 基本视图函数

视图函数是普通的 Python 函数，接收一个 request 对象，并返回一个 HttpResponse 或其他响应对象。最常见的视图函数使用 render() 函数将数据传递给模板并返回一个渲染的页面。

基本视图函数示例：

from django.http import HttpResponse
from django.shortcuts import render

# 简单的视图函数
def home(request):

    return HttpResponse("Welcome to the home page!")

# 使用模板的视图函数
def about(request):

    return render(request, 'about.html')

在这个例子中，home() 视图函数直接返回了一个简单的文本响应，而 about() 视图函数则渲染了一个 HTML 模板并返回给用户。

4.2.2 使用上下文传递数据

视图函数不仅可以渲染模板，还可以向模板传递动态数据。你可以通过上下文字典将数据传递给模板，模板中可以使用这些数据来进行动态渲染。

视图函数传递数据示例：

def user_profile(request, user_id):

    user = User.objects.get(id=user_id)

    return render(request, 'user_profile.html', {'user': user})

在这个示例中，user_profile() 视图函数从数据库中获取了 user_id 对应的用户，并将用户数据传递给模板进行渲染。

4.2.3 视图函数中的重定向与反向解析

Django 提供了 HttpResponseRedirect 和 redirect() 方法来处理 URL 的重定向。重定向通常在用户提交表单后，将他们引导到另一个页面。

from django.shortcuts import redirect

def redirect_to_home(request):

    return redirect('home')

使用 redirect() 时，可以直接传入视图的名称（home）来实现反向解析，即根据视图名称自动生成 URL。

4.2.4 处理POST请求

Django的视图函数不仅可以处理GET请求，还可以处理POST请求。可以根据请求类型进行不同的处理。

处理POST请求的视图示例：

from django.shortcuts import render
from django.http import HttpResponse

def contact(request):

    if request.method == 'POST':

        name = request.POST.get('name')

        message = request.POST.get('message')

        # 这里可以进一步处理表单数据
        return HttpResponse(f"Thank you {name}, your message has been received!")

    return render(request, 'contact.html')

在这个示例中，当用户提交表单时，视图会接收POST请求并处理表单数据。

4.3 类视图（Class-Based Views）

Django 提供了基于类的视图（CBVs）来替代传统的函数视图（FBVs）。类视图通过继承 Django 提供的基类来组织视图逻辑，使得视图的代码更加模块化、可复用，并且更符合面向对象的编程范式。

4.3.1 基本的类视图

类视图通过继承 Django 的 View 类来定义。最常用的类视图包括 ListView、DetailView、CreateView 等，它们简化了常见的操作，如列出对象、显示详细信息、创建新对象等。

基本的类视图示例：

from django.http import HttpResponse
from django.views import View

class HomeView(View):

    def get(self, request):

        return HttpResponse("Welcome to the home page!")

在这个示例中，HomeView 继承了 View 类，并重写了 get() 方法来处理 GET 请求。

4.3.2 使用 TemplateView渲染模板****

Django 提供了 TemplateView 类视图来处理渲染模板的常见需求。

TemplateView示例：

from django.views.generic import TemplateView

class AboutView(TemplateView):

    template_name = 'about.html'

在这个例子中，AboutView 继承自 TemplateView，并指定了要渲染的模板。你可以通过 context 属性来传递动态数据。

4.3.3 使用 ListView和** DetailView**

Django 提供了很多通用类视图，例如 ListView 和 DetailView，用于列出对象和显示单个对象的详细信息。

ListView示例：

from django.views.generic import ListView
from .models import Article

class ArticleListView(ListView):
    model = Article

    template_name = 'article_list.html'

    context_object_name = 'articles'

ListView 自动查询数据库中的所有 Article 对象，并将它们传递给模板。

DetailView示例：

from django.views.generic import DetailView
from .models import Article

class ArticleDetailView(DetailView):
    model = Article

    template_name = 'article_detail.html'

    context_object_name = 'article'

DetailView 用于显示数据库中单个对象的详细信息。它会自动根据 URL 中的参数（通常是主键）来获取对象，并将其传递给模板。

小结

本章深入探讨了 Django5 的 URL 路由系统、视图函数以及类视图。通过 Django 的 URL 路由系统，你可以轻松地将 URL 与视图函数映射，并使用动态路由来处理不同类型的请求。视图函数是 Django 应用的核心，处理请求并返回响应。而类视图则提供了更加模块化和可复用的方式来组织视图逻辑。

在实际开发中，选择合适的视图类型和路由方式，有助于提高代码的可维护性和扩展性。后续章节将继续介绍如何在 Django 项目中深入应用这些概念。