3.1 视图函数 (Function-Based Views - FBV)

第三章：视图（Views）

3.1 视图函数（Function-Based Views，FBV）

在 Django Web 框架中，视图是处理用户请求并返回响应的核心组件，承担模型（Models）与模板（Templates）之间的协调职责。视图接收 HTTP 请求，执行业务逻辑（如数据库查询、权限校验、表单验证），组织数据，并最终生成 HTTP 响应返回给客户端。Django 提供两种主流视图实现方式：视图函数（Function-Based Views，FBV） 和 类视图（Class-Based Views，CBV）。本节聚焦于视图函数——Django 最基础、最直观、应用最广泛的视图编写范式，适用于快速开发、逻辑清晰的业务场景及初学者系统性入门。

3.1.1 视图函数的本质定义

视图函数是使用标准 Python 函数语法编写的可调用对象，其接口契约明确：接收一个 HttpRequest 实例作为唯一必需参数，返回一个 HttpResponse 或其子类的实例。

该设计遵循单一职责原则，将请求处理流程封装为可预测、可测试、可组合的单元。其核心价值在于降低认知负荷，使开发者能以自然的函数式思维组织 Web 逻辑。

核心特性

• 简洁性与可读性高
  无框架抽象层干扰，代码即逻辑，适合快速验证、原型开发与教学演示。

• 高度灵活
  不受类继承结构约束，可自由引入任意第三方库、自定义中间件或异步操作（配合 async def）。

• 测试友好
  作为纯函数（或接近纯函数），可直接实例化 HttpRequest 进行单元测试，无需启动 Web 服务器或模拟请求生命周期。

• 渐进式演进支持
  可平滑升级为 CBV，或与装饰器（如 @login_required、@csrf_exempt）组合增强功能。

3.1.2 视图函数的标准结构

以下为符合 Django 最佳实践的视图函数骨架：

from django.http import HttpResponse

def example_view(request):
    """
    示例视图：处理请求并返回响应
    """
    # 1. 请求解析与校验（如方法判断、参数提取）
    if request.method != 'GET':
        return HttpResponse('仅支持 GET 请求', status=405)

    # 2. 业务逻辑执行（数据查询、计算、外部服务调用等）
    user_data = {'name': 'Alice', 'role': 'admin'}

    # 3. 响应构建（内容、状态码、头信息）
    response = HttpResponse(
        f"<h1>欢迎，{user_data['name']}！</h1>",
        content_type='text/html',
        status=200
    )
    response['X-Frame-Options'] = 'DENY'

    # 4. 响应返回
    return response
​

结构要点解析

3.1.3 HttpRequest 对象深度解析

HttpRequest 是 Django 请求处理的入口数据载体，提供对客户端请求全量信息的安全访问接口。

关键属性

关键方法

• is_ajax()：检测是否为 AJAX 请求（检查 HTTP_X_REQUESTED_WITH 头）
• is_secure()：判断是否为 HTTPS 协议
• get_host()：获取请求主机名（含端口）
• build_absolute_uri()：构建完整绝对 URL（用于邮件链接、API 返回）

安全提示：所有用户输入（GET、POST、FILES、COOKIES）均视为不可信数据，必须经过校验、清洗或转义后方可使用，尤其在拼接 SQL、HTML 或执行系统命令时。

3.1.4 HttpResponse 及其子类体系

Django 提供分层响应类体系，覆盖 Web 开发中绝大多数响应场景，确保语义清晰、类型安全、开箱即用。

主要响应类对比

响应类继承关系图示

实践建议：优先使用 JsonResponse 替代 HttpResponse(content=json.dumps(...))；用 redirect() 替代 HttpResponseRedirect；文件下载务必设置 as_attachment=True 并指定 filename，确保浏览器正确识别。

3.1.5 URL 路由配置与视图绑定

Django 通过 urls.py 文件定义 URL 模式与视图函数的映射关系，实现请求分发。现代 Django（2.0+）推荐使用 path() 函数，其语义清晰、支持类型转换、避免正则复杂度。

path() 函数详解

from django.urls import path
from . import views

urlpatterns = [
    # 基础路径
    path('hello/', views.hello_view, name='hello'),

    # 带整型参数
    path('articles/<int:article_id>/', views.article_detail, name='article_detail'),

    # 带字符串参数（不含 '/'）
    path('users/<str:username>/', views.user_profile, name='user_profile'),

    # 带 slug 参数（字母/数字/下划线/连字符）
    path('posts/<slug:post_slug>/', views.post_detail, name='post_detail'),

    # 带 UUID 参数
    path('orders/<uuid:order_id>/', views.order_status, name='order_status'),

    # 匹配任意路径（含 '/'）
    path('files/<path:file_path>/', views.serve_file, name='serve_file'),
]
​

URL 分发流程图示

关键原则：URL 名称（name 参数）是反向解析的唯一标识，模板中使用 {% url 'article_detail' article_id=42 %}，视图中使用 reverse('article_detail', args=[42])，彻底解耦 URL 字符串硬编码。

3.1.6 视图函数中的高频操作模式

实际项目中，FBV 常与以下 Django 核心机制协同工作：

1. 模板渲染：render() 函数

from django.shortcuts import render

def product_list_view(request):
    products = Product.objects.filter(is_active=True)  # ORM 查询
    context = {
        'products': products,
        'title': '商品列表'
    }
    return render(request, 'products/list.html', context)
​

• render() 封装了 HttpResponse + loader.get_template().render()，自动处理模板查找、上下文渲染、CSRF token 注入。

2. 数据库操作：Django ORM 集成

• 查询：Model.objects.filter(), get(), all(), values()
• 创建：Model.objects.create(), form.save()
• 更新：instance.save(), Model.objects.update()
• 删除：instance.delete(), Model.objects.filter().delete()

3. 表单处理：Form 类驱动

from django import forms

class ContactForm(forms.Form):
    name = forms.CharField(max_length=100)
    email = forms.EmailField()
    message = forms.CharField(widget=forms.Textarea)

def contact_view(request):
    if request.method == 'POST':
        form = ContactForm(request.POST)
        if form.is_valid():
            # 处理有效数据
            send_email(form.cleaned_data['email'], form.cleaned_data['message'])
            return redirect('contact_success')
    else:
        form = ContactForm()
    return render(request, 'contact.html', {'form': form})
​

4. 用户认证与权限控制

• 登录：from django.contrib.auth import login; login(request, user)
• 登出：from django.contrib.auth import logout; logout(request)
• 权限装饰器：@login_required, @permission_required('app.add_model')
• 模板中：{% if user.is_authenticated %}...{% endif %}

5. 会话管理

# 存储
request.session['preferred_language'] = 'zh-hans'
request.session.set_expiry(3600)  # 1小时后过期

# 读取
lang = request.session.get('preferred_language', 'en-us')

# 删除
del request.session['preferred_language']
​

6. 错误处理最佳实践

from django.http import Http404
from django.core.exceptions import PermissionDenied

def sensitive_view(request):
    if not request.user.has_perm('app.view_sensitive'):
        raise PermissionDenied("无权访问此资源")

    try:
        obj = ExpensiveModel.objects.get(pk=1)
    except ExpensiveModel.DoesNotExist:
        raise Http404("对象不存在")
    
    return HttpResponse("敏感内容")
​

• 使用 raise Http404 触发 404 页面（由 handler404 处理）
• 使用 raise PermissionDenied 触发 403 页面（由 handler403 处理）
• 避免裸 try/except Exception:，应捕获具体异常类型

3.1.7 FBV 的适用性评估：优势与局限

决策指南：
✅ 选择 FBV：逻辑简单（<50 行）、功能单一（如“发送邮件”、“下载报告”）、团队熟悉函数式编程、MVP 快速验证。
⚠️ 考虑 CBV：需复用通用逻辑（如列表页分页、详情页对象加载）、多 HTTP 方法统一处理（如 RESTful API）、项目已采用 CBV 规范、追求更高内聚性。

3.1.8 实战代码示例

示例 1：基础响应与状态码

from django.http import HttpResponse, HttpResponseNotFound

def health_check(request):
    """健康检查端点，返回 200 OK"""
    return HttpResponse('OK', status=200)

def legacy_redirect(request):
    """301 重定向至新路径"""
    from django.urls import reverse
    new_url = reverse('new_home')
    return HttpResponsePermanentRedirect(new_url)
​

示例 2：参数化文章详情

from django.http import HttpResponseNotFound
from django.shortcuts import get_object_or_404

def article_detail(request, article_id):
    # 使用 get_object_or_404 替代手动 try/except
    article = get_object_or_404(Article, id=article_id, is_published=True)
    
    # 渲染 HTML 片段
    html = f"""
    <article>
        <h1>{article.title}</h1>
        <p>{article.content[:200]}...</p>
        <small>发布于 {article.pub_date}</small>
    </article>
    """
    return HttpResponse(html, content_type='text/html')
​

示例 3：JSON API 接口

from django.http import JsonResponse
from django.views.decorators.csrf import csrf_exempt
import json

@csrf_exempt
def api_search(request):
    if request.method != 'POST':
        return JsonResponse({'error': '仅支持 POST'}, status=405)
    
    try:
        data = json.loads(request.body)
        query = data.get('q', '').strip()
        if not query:
            return JsonResponse({'error': '缺少搜索关键词'}, status=400)
        
        # 模拟搜索（实际应调用 ORM 或 Elasticsearch）
        results = [
            {'id': 1, 'title': f'关于 {query} 的文章'},
            {'id': 2, 'title': f'{query} 最佳实践'}
        ]
        return JsonResponse({'results': results})
    
    except json.JSONDecodeError:
        return JsonResponse({'error': '无效 JSON'}, status=400)
​

示例 4：文件下载服务

from django.http import FileResponse
from django.shortcuts import get_object_or_404

def download_report(request, report_id):
    report = get_object_or_404(Report, id=report_id, owner=request.user)
    
    # 打开文件（确保路径安全，禁止用户控制路径）
    file_path = f'/var/reports/{report.id}.pdf'
    response = FileResponse(
        open(file_path, 'rb'),
        as_attachment=True,
        filename=f'report-{report.id}.pdf',
        content_type='application/pdf'
    )
    response['Content-Length'] = report.file_size
    return response
​

本节总结

视图函数（FBV）是 Django 构建 Web 应用的基石，其以 Python 函数的纯粹性、明确的输入输出契约、与框架深度集成的响应生态，成为处理绝大多数 Web 交互场景的首选方案。掌握 HttpRequest 的全量能力、HttpResponse 子类的语义化使用、path() 路由的精准配置，以及与模板、ORM、表单、认证等模块的协同模式，是构建健壮、可维护 Django 应用的关键能力。

后续章节将深入探讨类视图（CBV）的设计哲学与高级用法，帮助开发者在项目规模增长、逻辑复杂度提升时，实现代码结构的优雅演进。