Django REST Framework（简称DRF）是一个强大且灵活的工具包，用于构建基于Django的RESTful API。它使得构建和管理API变得简单，并提供了许多内置功能，如身份验证，序列化，视图集，过滤器等。本文将介绍如何使用Django REST Framework构建RESTful API，并探索其丰富的功能。
安装和设置
首先，我们需要使用pip安装Django REST Framework。在终端中运行以下命令：
$ pip install djangorestframework
安装完成后，在你的Django项目的settings.py文件中添加rest_framework到INSTALLED_APPS列表中：
INSTALLED_APPS = [
...
'rest_framework',
]
接下来，在您的项目的根目录（与manage.py文件相同的目录）中，创建一个新的文件api.py。这将是我们构建API的地方。
构建API视图
在api.py文件中，我们将首先导入所需的模块和类：
from rest_framework.views import APIView
from rest_framework.response import Response
然后，我们可以定义我们的API视图。以下是一个简单的示例：
class HelloWorldAPI(APIView):
def get(self, request):
data = {'message': 'Hello, World!'}
return Response(data)
在上面的代码中，我们使用APIView类创建了一个名为HelloWorldAPI的API视图。这个视图有一个get方法，它返回一个简单的JSON响应。
配置URL路由
为了访问我们的API视图，我们需要配置URL路由。在您的项目的根目录（与manage.py文件相同的目录）中，打开urls.py文件，并添加以下代码：
from django.urls import path
from .api import HelloWorldAPI
urlpatterns = [
path('api/helloworld/', HelloWorldAPI.as_view(), name='hello_world_api'),
]
在上面的代码中，我们将HelloWorldAPI映射到URL路径api/helloworld/上。
测试API
现在，我们可以运行我们的Django应用，并使用任何HTTP客户端测试我们的API。你可以使用Postman，curl或浏览器。
访问http://localhost:8000/api/helloworld/，您应该能够看到以下JSON响应：
{
"message": "Hello, World!"
}
序列化数据
Django REST Framework提供了一个强大的序列化功能，用于操作和验证请求和响应的数据。让我们修改我们的API视图，以便接受和返回一个名为name的字符串：
from rest_framework import serializers
class HelloWorldSerializer(serializers.Serializer):
name = serializers.CharField(max_length=100)
class HelloWorldAPI(APIView):
def post(self, request):
serializer = HelloWorldSerializer(data=request.data)
if serializer.is_valid():
name = serializer.validated_data['name']
data = {'message': f'Hello, {name}!'}
return Response(data)
else:
return Response(serializer.errors, status=400)
在上面的代码中，我们定义了一个名为HelloWorldSerializer的序列化器，它具有一个name字段。在post方法中，我们验证传入的数据并返回一个个性化的问候响应。
JWT身份验证
Django REST Framework还提供了一些身份验证选项，并支持JSON Web Tokens（JWT）。让我们将JWT身份验证添加到我们的API视图。
首先，我们需要安装djangorestframework-simplejwt：
$ pip install djangorestframework-simplejwt
然后，在您的项目的settings.py文件中添加以下配置：
REST_FRAMEWORK = {
'DEFAULT_AUTHENTICATION_CLASSES': [
'rest_framework_simplejwt.authentication.JWTAuthentication',
],
}
最后，我们可以在我们的API视图中添加身份验证：
from rest_framework_simplejwt.tokens import RefreshToken
from rest_framework.permissions import IsAuthenticated
class HelloWorldAPI(APIView):
permission_classes = [IsAuthenticated]
def post(self, request):
# ...
# 同上述代码
def get(self, request):
user = request.user
data = {'message': f'Hello, {user.username}!'}
return Response(data)
在上面的代码中，我们首先导入JWT身份验证所需的类。然后，在我们的API视图中，我们使用permission_classes属性将访问限制为已验证的用户。我们还在get方法中使用request.user来获取当前用户的信息。
总结
使用Django REST Framework构建RESTful API是一种快速，简单和高效的方法。它提供了丰富的功能和内置的工具，如身份验证，序列化，视图集等。在本文中，我们学习了如何安装和设置DRF，并构建了一个基本的API视图。我们还了解了如何使用序列化器处理请求和响应的数据，并添加了JWT身份验证。希望这篇博客可以帮助你开始构建强大的RESTful API！
本文来自极简博客，作者：蓝色幻想，转载请注明原文链接：使用Django REST Framework构建RESTful API
