认识 Django REST Framework：一篇全面介绍

在现代软件开发的浪潮中，API（应用程序编程接口）已经成为连接不同系统、实现前后端分离、构建移动应用和微服务架构的基石。对于使用 Python 和 Django 构建 Web 应用的开发者来说，如何高效、优雅地构建功能强大且符合 RESTful 风格的 API，是一个重要的课题。

正是在这样的背景下，Django REST Framework（DRF）应运而生。它是一个强大而灵活的工具包，用于快速构建 Web API。如果说 Django 是为 Web 网站开发而生，那么 DRF 就是 Django 生态系统中为 API 开发量身定做的瑞士军刀。

本文将带你深入认识 Django REST Framework，从基本概念到核心组件，从安装使用到高级特性，进行一次全面的探索。

为什么选择 Django REST Framework？

在深入细节之前，我们先来理解为什么 DRF 如此受欢迎，以及它解决了哪些痛点。

构建一个 Web API，本质上涉及到以下几个关键环节：

接收请求： 处理来自客户端（浏览器、移动 App、其他服务）的 HTTP 请求。
解析请求数据： 从请求中提取数据（如 JSON、XML、表单数据），并将其转换为应用程序易于处理的格式（如 Python 对象）。
业务逻辑处理： 根据请求执行相应的业务操作，可能涉及数据库交互、调用其他服务等。
准备响应数据： 将业务逻辑处理结果（如数据库查询结果）组织成适合返回给客户端的格式。
序列化响应数据： 将内部的 Python 对象或数据结构转换为外部可读的格式（如 JSON、XML）。
发送响应： 将序列化后的数据作为 HTTP 响应发送回客户端。

手动实现这些环节不仅繁琐，而且容易出错，特别是在处理认证、权限、限流、分页等常见 API 需求时。

DRF 的优势在于：

基于 Django： 完美集成 Django 的 ORM、URLconf、认证系统等，对于熟悉 Django 的开发者来说学习曲线平缓。
快速开发： 提供了一系列强大的抽象和工具，极大地简化了 API 的开发流程，例如 ModelSerializer、Generic Views、ViewSets 等。
强大的序列化： 提供了灵活易用的序列化器（Serializer），轻松处理复杂数据结构的转换和验证。
丰富的特性： 内置了对认证（Authentication）、权限（Permissions）、限流（Throttling）、分页（Pagination）、过滤（Filtering）、排序（Ordering）等的支持。
可浏览的 API： 提供了一个方便的 Web 界面，可以在浏览器中直接查看和测试 API，极大地提高了开发和调试效率。
广泛的社区支持和完善的文档： 作为一个成熟的框架，拥有庞大的用户群体和高质量的官方文档。

简而言之，DRF 抽象并封装了构建 RESTful API 的许多通用任务，让开发者能够更专注于核心业务逻辑，从而提高开发效率和代码质量。

RESTful API 简介

虽然 DRF 并不强制你完全遵循 REST 的每一个原则，但它是一个构建 RESTful API 的框架。理解 REST（Representational State Transfer）的一些基本概念有助于更好地使用 DRF。

REST 是一种架构风格，其核心思想是将 Web 视为资源的集合。每个资源（如用户、订单、产品）通过一个唯一的 URI（统一资源标识符）来标识。客户端通过 HTTP 动词（GET, POST, PUT, PATCH, DELETE）对资源进行操作，而操作的结果以某种表示（如 JSON、XML）的形式在客户端和服务器之间传递。

REST 的关键原则包括：

无状态（Stateless）： 服务器不存储客户端的状态信息。每个请求都包含处理该请求所需的所有信息。
客户端-服务器分离（Client-Server）： 客户端和服务器职责分离，各自独立演进。
缓存（Cacheable）： 响应可以是可缓存的，以提高性能。
统一接口（Uniform Interface）： 提供一套标准的、统一的接口，简化了系统的整体架构。这包括资源标识（URIs）、资源的表示（Representations）、自描述消息（Self-descriptive Messages）、超媒体作为应用状态引擎（HATEOAS）。

DRF 帮助你实现这些原则，例如使用 HTTP 动词对应不同的操作、使用序列化器生成资源表示（JSON 等）、提供认证和权限机制来管理资源访问。

安装与基本设置

开始使用 DRF 非常简单。首先，你需要有一个 Django 项目。

安装 DRF：
bash pip install djangorestframework
添加到 INSTALLED_APPS：
在你的 Django 项目的 settings.py 文件中，将 rest_framework 添加到 INSTALLED_APPS 列表中：
“`python
# settings.py

INSTALLED_APPS = [
# … other apps
‘rest_framework’,
# …
]
“`

完成这两步后，你就已经在你的 Django 项目中集成了 DRF。

DRF 的核心组件

DRF 的强大之处在于它提供了一系列高度抽象和可复用的组件，这些组件协同工作，简化了 API 的开发。最核心的几个组件包括：

Serializer（序列化器）
Request 和 Response 对象
Views（视图）
ViewSets 和 Routers（视图集和路由）
Authentication（认证）
Permissions（权限）
Throttling（限流）
Pagination（分页）

接下来，我们将逐一详细介绍这些组件。

1. Serializer（序列化器）

序列化器是 DRF 中最核心也是最基础的概念之一。它的主要作用有两个：

序列化 (Serialization): 将复杂的 Python 数据类型（如 Django 模型实例、QuerySet）转换为可以轻松渲染成 JSON、XML 或其他媒体类型的原生 Python 数据类型（如字典、列表）。这是将数据库中的数据发送给客户端的过程。
反序列化 (Deserialization): 将接收到的原生 Python 数据类型（如来自请求的 JSON 数据）转换回复杂的 Python 数据类型，并进行数据验证。这是处理客户端发送的数据（如创建或更新资源）的过程。

基本使用：

你可以创建一个继承自 serializers.Serializer 或 serializers.ModelSerializer 的类来定义序列化器。

serializers.Serializer: 用于定义任意数据结构的序列化和反序列化。你需要明确指定每个字段及其类型。
serializers.ModelSerializer: 这是一个便利的类，它自动根据 Django 模型创建序列化器。它可以自动生成字段，并包含了对模型实例的创建和更新逻辑。这是在处理 Django 模型时最常用的序列化器。

示例 (使用 ModelSerializer):

假设你有一个简单的 Django 模型：

“`python

models.py

from django.db import models

class Product(models.Model):
name = models.CharField(max_length=100)
price = models.DecimalField(max_digits=10, decimal_places=2)
description = models.TextField(blank=True)
in_stock = models.BooleanField(default=True)

def __str__(self):
    return self.name

“`

你可以创建一个对应的 ModelSerializer：

“`python

serializers.py

from rest_framework import serializers
from .models import Product

class ProductSerializer(serializers.ModelSerializer):
class Meta:
model = Product
fields = [‘id’, ‘name’, ‘price’, ‘description’, ‘in_stock’]
# 或者使用 ‘all‘ 来包含模型的所有字段
# fields = ‘all‘
# 或者排除某些字段
# exclude = [‘in_stock’]
“`

序列化过程：

“`python

假设 product 是一个 Product 模型实例

serializer = ProductSerializer(product)
print(serializer.data) # 输出一个字典，可以转换为 JSON

{‘id’: 1, ‘name’: ‘Laptop’, ‘price’: ‘1200.00’, ‘description’: ‘Powerful laptop’, ‘in_stock’: True}

假设 products 是一个 Product QuerySet

serializer = ProductSerializer(products, many=True) # many=True 表示序列化多个对象
print(serializer.data) # 输出一个列表，列表中的每个元素是一个产品的字典
“`

反序列化和验证过程：

“`python

假设 data 是接收到的请求数据（一个字典）

data = {‘name’: ‘Tablet’, ‘price’: ‘300.00’}
serializer = ProductSerializer(data=data)

进行数据验证

if serializer.is_valid():
# 验证通过，可以通过 .validated_data 获取清洗后的数据
print(serializer.validated_data)
# {‘name’: ‘Tablet’, ‘price’: Decimal(‘300.00’), ‘description’: ”, ‘in_stock’: True}

# 保存到数据库 (如果使用 ModelSerializer 并且数据包含所有必要字段)
product_instance = serializer.save()
print("Product created:", product_instance)

else:
# 验证失败，可以通过 .errors 查看错误信息
print(serializer.errors)
# {‘name’: [‘This field is required.’]} # 假设 name 字段是必须的
“`

序列化器还支持定义自定义字段、关系字段（如 ForeignKey、ManyToManyField），以及进行更复杂的数据验证。它是 DRF 中最灵活且功能强大的组件之一。

2. Request 和 Response 对象

DRF 提供了自己的 Request 和 Response 对象，它们是 Django 原生 HttpRequest 和 HttpResponse 的增强版本，专门用于处理 Web API 的输入和输出。

Request 对象:
- 继承自 Django 的 HttpRequest。
- 提供了更灵活的数据解析：request.data 可以处理 JSON、XML、表单等不同格式的请求体数据，并自动解析。相比之下，Django 原生的 request.POST 只处理表单数据，request.body 需要手动解析。
- 提供了对文件上传的更好支持。
- 提供了认证用户 (request.user) 和认证方式 (request.auth) 的信息。
Response 对象:
- 继承自 Django 的 HttpResponse。
- 允许你直接传递原生 Python 数据（如字典、列表）给 Response 构造函数，DRF 会根据请求头中的 Accept 字段和配置的渲染器（Renderer）自动将其渲染成合适的格式（如 JSON）。
- 设置 HTTP 状态码变得更加直观。

示例：

“`python
from rest_framework.response import Response
from rest_framework.views import APIView

… other imports

class ProductListView(APIView):
def get(self, request):
products = Product.objects.all()
serializer = ProductSerializer(products, many=True)
return Response(serializer.data) # 直接传递字典/列表，DRF 会自动渲染为 JSON

def post(self, request):
    serializer = ProductSerializer(data=request.data) # 使用 request.data 获取解析后的数据
    if serializer.is_valid():
        serializer.save()
        return Response(serializer.data, status=201) # 设置 HTTP 状态码为 201 Created
    return Response(serializer.errors, status=400) # 设置 HTTP 状态码为 400 Bad Request

“`

3. Views（视图）

在 DRF 中，视图的角色与 Django 类似，它们接收请求，执行业务逻辑，并返回响应。DRF 提供了几种不同类型的视图，以适应不同的需求和开发风格：

APIView: 这是 DRF 提供的最基本的视图类，继承自 Django 的 View。它提供了 DRF 的核心功能，如对 Request 和 Response 对象的支持、认证、权限、限流等的处理。你需要在 APIView 子类中为每个 HTTP 动词（如 get(), post(), put(), delete()）编写相应的方法。这为你提供了最大的灵活性。
Generic Views（通用视图）: DRF 提供了一系列混合了特定操作（如列表、创建、详情、更新、删除）的通用视图类。它们建立在 APIView 的基础上，并结合了 Mixins（混入类），从而大大减少了处理常见 CRUD（创建、读取、更新、删除）操作所需的代码量。
- 常用的通用视图包括：ListAPIView, RetrieveAPIView, CreateAPIView, UpdateAPIView, DestroyAPIView, ListCreateAPIView, RetrieveUpdateAPIView, RetrieveDestroyAPIView, RetrieveUpdateDestroyAPIView。
- 例如，ListCreateAPIView 结合了 ListModelMixin 和 CreateModelMixin，用于处理列表查询和创建新资源的请求（通常对应 GET 和 POST 请求）。

示例 (使用 Generic Views):

“`python

views.py

from rest_framework import generics
from .models import Product
from .serializers import ProductSerializer

class ProductListCreate(generics.ListCreateAPIView):
queryset = Product.objects.all()
serializer_class = ProductSerializer
# 只需要指定 queryset 和 serializer_class，DRF 就自动处理 GET 和 POST 请求

class ProductRetrieveUpdateDestroy(generics.RetrieveUpdateDestroyAPIView):
queryset = Product.objects.all()
serializer_class = ProductSerializer
# 只需要指定 queryset 和 serializer_class，DRF 就自动处理 GET, PUT, PATCH, DELETE 请求
# 需要在 URL 中捕获主键，例如 /products//
“`

使用通用视图可以让你用极少的代码实现常见的数据操作 API 接口。

4. ViewSets 和 Routers（视图集和路由）

ViewSets 是 DRF 中更高级别的抽象，它将一组相关的视图逻辑（如列表、详情、创建、更新、删除）打包到一个类中，而不是像传统视图那样为每个操作定义一个独立的视图类。一个 ViewSet 可以响应多种不同的 HTTP 方法。

ViewSets 通常与 Routers 配合使用。Router 的作用是自动生成 URL 模式（URL patterns），将 HTTP 方法映射到 ViewSet 中的相应方法。这进一步简化了 URL 配置。

ViewSet: 最基础的视图集，不提供任何操作方法，需要手动定义 list(), create(), retrieve(), update(), partial_update(), destroy() 等方法。
ModelViewSet: 继承自 ViewSet 并混入了所有 Model Mixins (ListModelMixin, CreateModelMixin, RetrieveModelMixin, UpdateModelMixin, DestroyModelMixin)，提供了对模型数据的完整 CRUD 操作。这是处理模型数据的最常用 ViewSet。

示例 (使用 ViewSet 和 Router):

“`python

views.py

from rest_framework import viewsets
from .models import Product
from .serializers import ProductSerializer

class ProductViewSet(viewsets.ModelViewSet):
queryset = Product.objects.all()
serializer_class = ProductSerializer
# ModelViewSet 自动提供了列表、详情、创建、更新、删除等操作

urls.py

from django.urls import path, include
from rest_framework.routers import DefaultRouter
from .views import ProductViewSet

创建一个 DefaultRouter 实例

router = DefaultRouter()

注册 ProductViewSet，指定基础名称 ‘products’

这将自动生成 /products/ (列表/创建) 和 /products/{pk}/ (详情/更新/删除) 等 URL

router.register(r’products’, ProductViewSet)

URL 模式

urlpatterns = [
# … other url patterns
path(”, include(router.urls)), # 将路由器生成的 URL 包含到主 urlpatterns 中
]
“`

通过 ViewSets 和 Routers，你可以用非常精简的代码为模型创建一套完整的 RESTful API 端点。

5. Authentication（认证）

认证是确定客户端身份的过程。DRF 提供了一个灵活的认证系统，支持多种认证方式，并允许你轻松实现自定义认证方式。

DRF 的认证系统不限制你使用特定的用户模型或认证方式，你可以选择最适合你的应用的方案。常见的内置认证方式包括：

SessionAuthentication: 基于 Django Session 的认证，适合与浏览器会话一起使用（例如，在 Django Admin 或使用模板渲染的 Web 应用中）。
BasicAuthentication: HTTP Basic 认证，通过 Base64 编码的用户名和密码传输。不安全，不推荐用于生产环境，除非在 HTTPS 下用于内部服务或测试。
TokenAuthentication: 基于 Token 的认证，客户端在请求头中携带一个 Token。这是一种非常常见的 API 认证方式，适合移动应用和单页应用。

你可以通过在 settings.py 中设置 DEFAULT_AUTHENTICATION_CLASSES 来全局配置认证方式，或者在视图/视图集上使用 authentication_classes 属性进行局部配置。

示例 (配置 Token 认证):

首先，你需要安装 djangorestframework.authtoken 应用：

bash pip install djangorestframework # TokenAuthentication 已包含在内

将 rest_framework.authtoken 添加到 INSTALLED_APPS：

“`python

settings.py

INSTALLED_APPS = [
# …
‘rest_framework’,
‘rest_framework.authtoken’,
# …
]
“`

运行迁移以创建 Token 模型：

bash python manage.py migrate

现在，你可以通过 DRF 提供的视图或自己创建视图来为用户生成 Token。一个常见的方式是使用 DRF 内置的 obtain_auth_token 视图（需要配置 URLconf）：

“`python

urls.py

from django.urls import path
from rest_framework.authtoken import views

urlpatterns = [
# …
path(‘api-token-auth/’, views.obtain_auth_token)
]
“`

客户端向 /api-token-auth/ 发送 POST 请求，携带用户名和密码，成功后会返回一个 Token。之后，客户端可以在后续请求的 Authorization 头中携带此 Token（格式通常是 Token your_token_string）进行认证。

在视图/视图集中应用 Token 认证：

“`python

views.py

from rest_framework.authentication import TokenAuthentication
from rest_framework.permissions import IsAuthenticated
from rest_framework.views import APIView
from rest_framework.response import Response

class ProtectedView(APIView):
authentication_classes = [TokenAuthentication] # 指定认证类
permission_classes = [IsAuthenticated] # 指定权限类，确保用户已认证

def get(self, request):
    return Response({"message": "You are authenticated!", "user": request.user.username})

“`

6. Permissions（权限）

权限是在确定客户端身份后，进一步判断该客户端（已认证用户或匿名用户）是否有权执行某个操作（如查看、修改、删除）的过程。DRF 提供了灵活的权限系统。

DRF 提供了一些常用的权限类：

AllowAny: 允许所有用户访问（默认）。
IsAuthenticated: 只允许已认证用户访问。
IsAdminUser: 只允许管理员用户（is_staff=True）访问。
IsAuthenticatedOrReadOnly: 允许已认证用户进行完全操作（GET, POST, PUT, PATCH, DELETE），但允许未认证用户只进行安全操作（GET, HEAD, OPTIONS）。
DjangoModelPermissions: 基于 Django 模型权限的权限。
DjangoObjectPermissions: 基于 Django 对象权限的权限。

你也可以自定义权限类，通过实现 has_permission(self, request, view) 和/或 has_object_permission(self, request, view, obj) 方法来定义权限逻辑。

与认证类似，权限可以全局配置 (DEFAULT_PERMISSION_CLASSES) 或局部配置 (permission_classes 属性)。

示例 (全局配置和局部配置):

“`python

settings.py

REST_FRAMEWORK = {
‘DEFAULT_PERMISSION_CLASSES’: [
‘rest_framework.permissions.IsAuthenticated’, # 默认所有视图都需要认证
]
}

views.py

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

class PublicView(APIView):
permission_classes = [AllowAny] # 覆盖全局设置，允许任何人访问

def get(self, request):
    return Response({"message": "This is a public view."})

“`

7. Throttling（限流）

限流用于控制客户端在特定时间段内可以向 API 发送请求的速率。这有助于防止滥用和保护后端服务。

DRF 提供了一些内置的限流类：

AnonRateThrottle: 限制匿名用户的请求速率。
UserRateThrottle: 限制已认证用户的请求速率。
ScopedRateThrottle: 基于视图或视图集上的 throttle_scope 属性来限制速率。

你可以在 settings.py 中设置 DEFAULT_THROTTLE_CLASSES 和 DEFAULT_THROTTLE_RATES 来全局配置限流，或在视图/视图集上使用 throttle_classes 属性进行局部配置。

示例：

“`python

settings.py

REST_FRAMEWORK = {
‘DEFAULT_THROTTLE_CLASSES’: [
‘rest_framework.throttling.AnonRateThrottle’,
‘rest_framework.throttling.UserRateThrottle’
],
‘DEFAULT_THROTTLE_RATES’: {
‘anon’: ‘100/day’, # 匿名用户每天最多 100 个请求
‘user’: ‘1000/day’ # 已认证用户每天最多 1000 个请求
}
}

或者在视图/视图集局部配置

views.py

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

class LimitedView(APIView):
throttle_classes = [AnonRateThrottle] # 只对匿名用户进行限流

def get(self, request):
    return Response({"message": "This view is rate-limited."})

“`

8. Pagination（分页）

当返回大量数据时，分页是必要的，以避免一次性加载过多数据导致性能问题。DRF 提供了多种分页方式，并将分页逻辑抽象出来。

DRF 提供了一些内置的分页类：

PageNumberPagination: 基于页码的分页，客户端通过查询参数 page 和 page_size 来指定请求的页码和每页数量。
LimitOffsetPagination: 基于偏移量和限制数量的分页，客户端通过查询参数 limit 和 offset 来指定。
CursorPagination: 基于游标的分页，适用于大型数据集，可以提供更一致的排序和遍历，避免了基于偏移量可能出现的问题（如数据插入或删除导致的结果漂移）。

你可以在 settings.py 中设置 DEFAULT_PAGINATION_CLASS 和相关参数来全局配置分页，或在通用视图/视图集上使用 pagination_class 属性进行局部配置。

示例 (全局配置 PageNumberPagination):

“`python

settings.py

REST_FRAMEWORK = {
‘DEFAULT_PAGINATION_CLASS’: ‘rest_framework.pagination.PageNumberPagination’,
‘PAGE_SIZE’: 10 # 默认每页 10 条数据
}

在通用视图或 ViewSet 中自动应用分页

views.py

from rest_framework import generics
from .models import Product
from .serializers import ProductSerializer

class ProductList(generics.ListAPIView):
queryset = Product.objects.all()
serializer_class = ProductSerializer
# 由于settings中配置了默认分页，这里无需额外配置，会自动应用
# 如果想局部覆盖全局配置，可以设置 pagination_class = … 和 page_size = …
“`

当分页启用后，列表响应的数据结构会发生变化，通常包含当前页的 URL、下一页 URL、上一页 URL、总条数以及当前页的数据列表。

更深入的特性和实践

除了上述核心组件，DRF 还提供了许多其他有用的特性和实践建议：

Browsable API: DRF 最酷的特性之一是它的可浏览 Web API。当你在浏览器中访问 DRF 视图的 URL 时，如果你的认证和权限允许，你会看到一个漂亮的 HTML 页面，展示 API 的详细信息、允许你发送请求、查看响应，并且有表单用于创建/更新资源。这对于开发和调试非常方便。这是默认启用的，除非你修改了默认的渲染器设置。
Renderers 和 Parsers:
- Renderers (渲染器) 用于将原生 Python 数据（如序列化器的 .data）转换为发送给客户端的响应内容类型（如 JSON、HTML）。DRF 默认支持 JSON 和 HTML (用于 Browsable API)。你可以轻松添加对 XML、YAML 等其他格式的支持。
- Parsers (解析器) 用于解析客户端发送的请求体数据，将其转换为 request.data 中可用的原生 Python 数据。DRF 默认支持 JSON、表单数据 (FormParser) 和文件上传 (MultiPartParser)。
Versioning (版本控制): 对于长期维护的 API，版本控制是必要的。DRF 支持多种版本控制方案，如 URL Path Versioning (/v1/products/), Query Parameter Versioning (/products/?version=v1), Namespace Versioning 等。
Filtering 和 Ordering: DRF 提供了简单的机制来支持对列表数据的过滤和排序。你可以使用 django-filter 和 django-rest-framework-filters 等第三方库来实现更复杂的过滤逻辑。
Testing API: DRF 提供了一个 APIClient 类，方便你在测试中模拟请求和检查响应，使得 API 测试变得简单高效。
Customizing Behavior: DRF 的设计非常灵活，几乎所有组件都可以被继承和重写，以满足特定的需求。你可以自定义序列化器字段、视图逻辑、认证/权限/限流策略等。
Documentation: 为 API 提供良好的文档至关重要。虽然 DRF 本身不直接生成文档，但有许多优秀的第三方库可以与 DRF 集成，如 drf-yasg (基于 OpenAPI/Swagger) 和 coreapi / openapi (DRF 官方推荐)。它们可以自动生成 API 文档，甚至提供交互式文档界面。
Error Handling: DRF 提供了标准的异常处理机制。当发生 APIException 及其子类异常时（如认证失败、权限拒绝、验证错误），DRF 会返回适当的 HTTP 状态码和错误详情。你也可以自定义异常处理逻辑。

构建一个简单的 API 流程回顾

综合上述核心组件，构建一个使用 DRF 的 RESTful API 的典型流程如下：

定义模型 (Models): 如果涉及数据库操作，先定义 Django 模型。
创建序列化器 (Serializers): 根据模型或其他数据结构创建 Serializer 或 ModelSerializer，定义数据表示、字段和验证规则。
创建视图 (Views / ViewSets):
- 对于简单的 CRUD 操作，使用 ModelViewSet 和 Router 是最高效的方式。
- 对于需要更多定制的简单操作，使用通用视图 (generics.*APIView)。
- 对于完全定制的逻辑，使用 APIView。
配置 URL (URLs): 将视图或 ViewSet 映射到 URL 路径。如果使用 ViewSet，利用 Router 自动化此过程。
配置认证、权限、限流、分页 (Authentication, Permissions, Throttling, Pagination): 根据需要配置这些策略，可以全局设置，也可以在视图/视图集上局部设置。

总结与展望

Django REST Framework 是一个成熟、强大且极其灵活的工具，它基于 Django 的优势，为构建现代 Web API 提供了全方位的支持。从数据序列化到请求响应处理，从权限控制到自动化路由，DRF 极大地简化了 API 开发的复杂度，让开发者能够专注于业务逻辑的实现。

通过本文的介绍，你应该对 DRF 的核心概念、主要组件以及它们如何协同工作有了全面的认识。这只是一个起点，DRF 还有许多高级特性和更精细的配置选项等待你去探索。

要真正掌握 DRF，最好的方式是动手实践。尝试使用 DRF 构建一个简单的 API，比如一个博客 API 或一个待办事项列表 API，逐步熟悉各个组件的使用。阅读官方文档是深入学习 DRF 的最佳途径，它提供了详尽的解释和丰富的示例。

随着微服务、移动应用和单页应用（SPA）的普及，API 的重要性只会越来越高。掌握 DRF，将使你能够更高效地构建高质量的后端服务，连接不同的技术栈和应用场景。无论你是想为你的 Django 项目添加 API 能力，还是从零开始构建一个 API 服务，DRF 都将是你的得力助手。

希望这篇文章能为你打开 DRF 的大门，并激发你深入学习和使用的兴趣。祝你在 API 开发的旅程中取得成功！

认识 Django REST Framework：一篇全面介绍

为什么选择 Django REST Framework？

RESTful API 简介

安装与基本设置

DRF 的核心组件

1. Serializer（序列化器）

models.py

serializers.py

假设 product 是一个 Product 模型实例

{‘id’: 1, ‘name’: ‘Laptop’, ‘price’: ‘1200.00’, ‘description’: ‘Powerful laptop’, ‘in_stock’: True}

假设 products 是一个 Product QuerySet

假设 data 是接收到的请求数据（一个字典）

进行数据验证

2. Request 和 Response 对象

… other imports

3. Views（视图）

views.py

4. ViewSets 和 Routers（视图集和路由）

views.py

urls.py

创建一个 DefaultRouter 实例

注册 ProductViewSet，指定基础名称 ‘products’

这将自动生成 /products/ (列表/创建) 和 /products/{pk}/ (详情/更新/删除) 等 URL

URL 模式

5. Authentication（认证）

settings.py

urls.py

views.py

6. Permissions（权限）

settings.py

views.py

7. Throttling（限流）

settings.py

或者在视图/视图集局部配置

views.py

8. Pagination（分页）

settings.py

在通用视图或 ViewSet 中自动应用分页

views.py

更深入的特性和实践

构建一个简单的 API 流程回顾

总结与展望

发表评论 取消回复

发表评论取消回复