一、基础视图 (APIView)
APIView 是 DRF 中所有视图的基类,继承自 Django 的 View,并添加了 DRF 特有的功能(如认证、权限、限流等)。
示例:使用APIView实现“增删改查查”
配置路由:urls.py
这种方式虽然直观,但存在大量重复代码(如查询集获取、序列化器实例化等)。为了解决这个问题,DRF 提供了通用视图。
二、通用视图 (Generic Views)
DRF 的通用视图基于 “Mixin 组合” 思想,将常用功能封装成可复用的组件,通过继承组合实现复杂功能。通用视图的核心是 GenericAPIView,它提供了基础的查询集和序列化器管理功能。
常用通用视图
ListAPIView:获取列表数据(GET)CreateAPIView:创建数据(POST)RetrieveAPIView:获取单个数据(GET)UpdateAPIView:更新数据(PUT/PATCH)DestroyAPIView:删除数据(DELETE)- 组合视图:
ListCreateAPIView、RetrieveUpdateAPIView等
通用视图示例:学生信息管理
步骤 1:定义模型
步骤 2:创建序列化器
步骤 3:实现通用视图
步骤 4:配置 URL
使用通用视图,实现完整的 CRUD 功能,大大减少了重复代码。
测试通用视图
运行Django项目
打开浏览器登录访问:http://127.0.0.1:8000/api/books/
- get:查询列表
- post:新增

打开浏览器登录访问:http://127.0.0.1:8000/api/books/1
- get:查询单个对象
- put:修改
- delete:删除

三、通用视图的高级用法
动态查询集
通过重写 get_queryset() 方法,可以实现动态过滤查询集,例如只返回当前登录用户的数据:
多字段查询
默认情况下,通用视图通过 pk 字段查询单个对象。如果需要支持多字段查询,可以自定义 Mixin 类:
使用示例:
自定义权限和认证
通过设置 permission_classes 和 authentication_classes 属性,可以为视图添加权限和认证控制:
四、GenericAPIView类深度解析
GenericAPIView 是 DRF 视图系统的核心抽象,它通过标准化的属性和方法,简化了数据查询、序列化和过滤等常见操作。通过与 Mixin 类结合,GenericAPIView 能够快速实现 CRUD 功能,同时保留了足够的灵活性,允许开发者通过重写方法定制业务逻辑。
类继承关系
GenericAPIView 是 DRF 通用视图体系的基石,其继承关系如下
- 作为
APIView的子类,GenericAPIView保留了请求处理、认证、权限、限流等基础功能 GenericAPIView新增了对查询集(QuerySet)和序列化器(Serializer)的标准化管理,为数据操作提供了统一接口

核心类属性
GenericAPIView 通过类属性定义了视图的核心配置,这些属性决定了视图如何获取数据、如何序列化数据以及如何处理查询参数。
| 属性名 | 说明 |
|---|---|
queryset | 视图使用的基础查询集,用于获取模型实例。通常需要设置此属性或重写 get_queryset() 方法。注意直接访问 self.queryset 会导致结果缓存,应优先使用 get_queryset() 方法。 |
serializer_class | 用于数据验证、序列化和反序列化的序列化器类。需设置此属性或重写 get_serializer_class() 方法。 |
lookup_field | 用于查询单个对象的模型字段,默认值为 'pk'(主键)。若使用自定义字段,需确保视图和序列化器同步设置。 |
lookup_url_kwarg | URL 中用于对象查找的关键字参数,默认与 lookup_field 相同。需与 URL 配置中的参数名保持一致。 |
pagination_class | 列表数据的分页类,默认使用全局配置 DEFAULT_PAGINATION_CLASS。设置为 None 可禁用分页。 |
filter_backends | 用于过滤查询集的后端类列表,默认使用全局配置 DEFAULT_FILTER_BACKENDS。 |
常用类方法
GenericAPIView 提供了一系列方法用于处理查询集、对象实例和序列化器,这些方法是构建数据交互逻辑的核心。
数据查询相关方法
- get_queryset(self):返回视图使用的查询集,是获取数据的主要入口。默认返回 queryset 属性定义的查询集,可重写以实现动态过滤(如返回当前用户的数据)
- get_object(self):返回详细视图所需的单个对象实例。默认通过 lookup_field 从查询集中过滤对象,可重写以实现复杂查询逻辑(如多字段联合查询)。
- filter_queryset(self, queryset):应用过滤后端对查询集进行过滤,返回处理后的查询集。可通过重写自定义过滤逻辑
序列化器相关方法
- get_serializer_class(self):返回当前视图使用的序列化器类,默认返回 serializer_class 属性。可重写以根据条件返回不同的序列化器
- get_serializer(self, instance=None, data=None, many=False, partial=False):返回序列化器实例,自动注入请求上下文(如 request、view)。通常无需重写,直接调用即可
钩子方法(与 Mixin 配合)
GenericAPIView 本身不直接实现 CRUD 操作,而是通过与 Mixin 类(如 CreateModelMixin、UpdateModelMixin)结合实现完整功能。这些 Mixin 提供了以下钩子方法,用于定制对象的保存和删除行为
| 方法名 | 所属 Mixin | 说明 |
|---|---|---|
perform_create(self, serializer) | CreateModelMixin | 创建对象时调用,可用于添加额外字段(如设置创建者): def perform_create(self, serializer): serializer.save(author=self.request.user) |
perform_update(self, serializer) | UpdateModelMixin | 更新对象时调用,可用于记录更新时间等: def perform_update(self, serializer): serializer.save(updated_at=timezone.now()) |
perform_destroy(self, instance) | DestroyModelMixin | 删除对象时调用,可用于执行额外清理操作: def perform_destroy(self, instance): instance.comments.all().delete() instance.delete() |
其他实用方法
以下方法通常无需重写
get_serializer_context(self):返回序列化器的上下文字典,默认包含request、view、format信息,可用于在序列化器中访问请求数据。paginate_queryset(self, queryset):对查询集进行分页处理,返回页面对象或None(若未配置分页)。get_paginated_response(self, data):返回分页格式的响应对象,配合分页功能使用。
您正在阅读的是《Django从入门到实战》专栏!关注不迷路~
3722



被折叠的 条评论
为什么被折叠?



