Django是一个强大的Python Web框架，而Django REST framework（以下简称DRF）则是Django的一个扩展，用于构建Web API服务。DRF提供了一系列工具和库，能够帮助我们快速构建出符合RESTful架构风格的API服务。
什么是Web API？
Web API是一种通过HTTP协议访问的接口，用于处理数据的请求和响应。通过Web API，我们可以实现客户端和服务器之间的数据传输和交互。
为什么选择Django REST framework？
- DRF提供了一套简单明了的序列化模型，将数据转换为JSON格式，方便前后端之间的数据交互。
- DRF支持多种认证方式，比如基于Token、Session和OAuth的认证机制，保证API的安全性。
- DRF支持许多开箱即用的功能，比如分页、筛选、排序等，方便开发者快速构建API服务。
- DRF提供了一套强大的视图和路由系统，使我们能够简单地定义API的endpoint，并对其进行自定义配置。
构建Web API服务
1. 创建Django项目
首先，我们需要在本地创建一个Django项目：
$ django-admin startproject myproject
$ cd myproject
2. 安装Django REST framework
在项目根目录下创建一个虚拟环境，并激活该环境：
$ python -m venv venv
$ source venv/bin/activate
然后，使用pip安装DRF：
(venv) $ pip install djangorestframework
3. 配置Django项目
在Django的settings.py文件中，添加以下内容：
INSTALLED_APPS = [
...
'rest_framework',
]
REST_FRAMEWORK = {
'DEFAULT_AUTHENTICATION_CLASSES': [
'rest_framework.authentication.TokenAuthentication',
'rest_framework.authentication.SessionAuthentication',
],
'DEFAULT_PERMISSION_CLASSES': [
'rest_framework.permissions.IsAuthenticated',
],
}
上述配置中，我们启用了TokenAuthentication和SessionAuthentication两种认证方式，并设置了默认的权限验证为IsAuthenticated。
4. 创建数据模型
在Django项目的models.py文件中，定义一个数据模型，用于存储API中的数据：
from django.db import models
class Product(models.Model):
name = models.CharField(max_length=100)
price = models.DecimalField(max_digits=8, decimal_places=2)
description = models.TextField()
def __str__(self):
return self.name
5. 定义序列化器
在Django项目的serializers.py文件中，定义一个序列化器，用于将数据模型序列化为JSON格式：
from rest_framework import serializers
from .models import Product
class ProductSerializer(serializers.ModelSerializer):
class Meta:
model = Product
fields = '__all__'
我们使用了DRF提供的ModelSerializer，它能够自动根据数据模型生成序列化器。
6. 定义视图
在Django项目的views.py文件中，定义一个视图类，用于处理具体的API请求和响应：
from rest_framework import viewsets
from .models import Product
from .serializers import ProductSerializer
class ProductViewSet(viewsets.ModelViewSet):
queryset = Product.objects.all()
serializer_class = ProductSerializer
我们使用了DRF提供的ModelViewSet，它封装了常用的CRUD操作，同时简化了我们对API视图的配置。
7. 定义URL路由
在Django项目的urls.py文件中，定义API的URL路由：
from django.urls import include, path
from rest_framework import routers
from .views import ProductViewSet
router = routers.DefaultRouter()
router.register(r'products', ProductViewSet)
urlpatterns = [
path('', include(router.urls)),
]
8. 运行Django项目
最后，运行Django项目并启动API服务：
(venv) $ python manage.py runserver
现在，我们可以通过访问http://localhost:8000/products/来访问我们的API了。同时，DRF还为我们提供了一些其他的功能，比如分页、筛选和排序等，我们可以在API请求中添加相应的参数来使用这些功能。
总结
通过使用Django REST framework，我们可以非常方便地构建出一个RESTful风格的Web API服务。DRF提供了丰富的功能和工具，能够大大简化API的开发和维护工作。希望通过本篇博客，你能够对利用DRF构建Web API服务有一个初步的了解。
本文来自极简博客，作者：狂野之心，转载请注明原文链接：利用Django REST framework构建Web API服务
