Django REST Framework 教程：基于类的视图详解

最新推荐文章于 2025-06-01 09:03:06 发布

翟江哲Frasier

最新推荐文章于 2025-06-01 09:03:06 发布

阅读量305

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00293/article/details/148360554

Django REST Framework 教程：基于类的视图详解

django-rest-framework encode/django-rest-framework: Django REST framework 是一个强大的 Web API 开发工具包，专为 Django 框架设计，提供了一套丰富的功能集来构建 Web API，包括序列化、分页、权限管理等。项目地址: https://gitcode.com/gh_mirrors/dj/django-rest-framework

前言

在 Django REST Framework 开发中，视图是处理请求和返回响应的核心组件。本教程将深入探讨如何从函数视图迁移到更强大的基于类的视图（Class-based Views），并展示如何利用框架提供的各种高级特性来简化代码。

从函数视图到类视图

基础类视图实现

首先让我们看看如何将简单的函数视图转换为基于类的视图。使用 APIView 作为基类，我们可以清晰地分离不同 HTTP 方法对应的处理逻辑：

from rest_framework.views import APIView
from rest_framework.response import Response

class SnippetList(APIView):
    """
    代码片段列表视图
    支持GET获取所有片段和POST创建新片段
    """
    def get(self, request):
        snippets = Snippet.objects.all()
        serializer = SnippetSerializer(snippets, many=True)
        return Response(serializer.data)

    def post(self, request):
        serializer = SnippetSerializer(data=request.data)
        if serializer.is_valid():
            serializer.save()
            return Response(serializer.data, status=201)
        return Response(serializer.errors, status=400)

这种转换带来了几个明显优势：

代码组织结构更清晰，每个HTTP方法有独立处理函数
类属性可以方便地共享数据和配置
更易于扩展和维护

详情视图的实现

同样地，我们可以实现详情视图：

class SnippetDetail(APIView):
    """
    代码片段详情视图
    支持GET、PUT和DELETE操作
    """
    def get_object(self, pk):
        try:
            return Snippet.objects.get(pk=pk)
        except Snippet.DoesNotExist:
            raise Http404

    def get(self, request, pk):
        snippet = self.get_object(pk)
        serializer = SnippetSerializer(snippet)
        return Response(serializer.data)

    def put(self, request, pk):
        snippet = self.get_object(pk)
        serializer = SnippetSerializer(snippet, data=request.data)
        if serializer.is_valid():
            serializer.save()
            return Response(serializer.data)
        return Response(serializer.errors, status=400)

    def delete(self, request, pk):
        snippet = self.get_object(pk)
        snippet.delete()
        return Response(status=204)

使用Mixin增强视图

Django REST Framework 提供了一系列Mixin类，可以大幅减少重复代码：

List和Create操作的Mixin

from rest_framework import mixins, generics

class SnippetList(mixins.ListModelMixin,
                 mixins.CreateModelMixin,
                 generics.GenericAPIView):
    queryset = Snippet.objects.all()
    serializer_class = SnippetSerializer

    def get(self, request, *args, **kwargs):
        return self.list(request, *args, **kwargs)

    def post(self, request, *args, **kwargs):
        return self.create(request, *args, **kwargs)

这里的关键点：

GenericAPIView 提供了基础功能
ListModelMixin 添加了 .list() 方法
CreateModelMixin 添加了 .create() 方法

详情视图的Mixin实现

class SnippetDetail(mixins.RetrieveModelMixin,
                    mixins.UpdateModelMixin,
                    mixins.DestroyModelMixin,
                    generics.GenericAPIView):
    queryset = Snippet.objects.all()
    serializer_class = SnippetSerializer

    def get(self, request, *args, **kwargs):
        return self.retrieve(request, *args, **kwargs)

    def put(self, request, *args, **kwargs):
        return self.update(request, *args, **kwargs)

    def delete(self, request, *args, **kwargs):
        return self.destroy(request, *args, **kwargs)

通用视图的终极简化

Django REST Framework 还提供了一组预组合的通用视图类，可以进一步简化代码：

from rest_framework import generics

class SnippetList(generics.ListCreateAPIView):
    queryset = Snippet.objects.all()
    serializer_class = SnippetSerializer

class SnippetDetail(generics.RetrieveUpdateDestroyAPIView):
    queryset = Snippet.objects.all()
    serializer_class = SnippetSerializer

这些通用视图类已经完美组合了常见的CRUD操作模式，只需指定最基本的配置即可完成功能完整的API端点。

路由配置

使用类视图后，URL配置需要稍作调整：

from django.urls import path
from snippets import views

urlpatterns = [
    path('snippets/', views.SnippetList.as_view()),
    path('snippets/<int:pk>/', views.SnippetDetail.as_view()),
]

注意每个类视图都需要调用 as_view() 方法将其转换为Django可识别的视图函数。