编辑“︁Django REST framework”︁

= Django REST framework =

'''Django REST framework'''（简称DRF）是一个基于[[Django]]框架构建的强大且灵活的工具包，用于开发[[Web API]]。它提供了构建[[RESTful API]]所需的各种组件，包括序列化、视图、认证、权限控制等机制。

== 主要特性 ==
Django REST framework的核心功能包括：
* 强大的序列化系统，支持ORM和非ORM数据源
* 可扩展的视图和视图集
* 内置的认证方案（[[OAuth]]、Token等）
* 自定义权限控制
* 可浏览的API界面
* 支持多种响应格式（JSON、XML等）

== 安装与配置 ==
要使用Django REST framework，首先需要安装：
<syntaxhighlight lang="bash">
pip install djangorestframework
</syntaxhighlight>

然后在Django项目的settings.py中添加：
<syntaxhighlight lang="python">
INSTALLED_APPS = [
    ...
    'rest_framework',
]
</syntaxhighlight>

== 基本使用示例 ==
以下是一个简单的API示例，展示如何创建图书模型的CRUD接口：

1. 首先定义模型：
<syntaxhighlight lang="python">
# models.py
from django.db import models

class Book(models.Model):
    title = models.CharField(max_length=100)
    author = models.CharField(max_length=100)
    published_date = models.DateField()
</syntaxhighlight>

2. 创建序列化器：
<syntaxhighlight lang="python">
# serializers.py
from rest_framework import serializers
from .models import Book

class BookSerializer(serializers.ModelSerializer):
    class Meta:
        model = Book
        fields = ['id', 'title', 'author', 'published_date']
</syntaxhighlight>

3. 编写视图：
<syntaxhighlight lang="python">
# views.py
from rest_framework import viewsets
from .models import Book
from .serializers import BookSerializer

class BookViewSet(viewsets.ModelViewSet):
    queryset = Book.objects.all()
    serializer_class = BookSerializer
</syntaxhighlight>

4. 配置URL路由：
<syntaxhighlight lang="python">
# urls.py
from django.urls import path, include
from rest_framework.routers import DefaultRouter
from .views import BookViewSet

router = DefaultRouter()
router.register(r'books', BookViewSet)

urlpatterns = [
    path('', include(router.urls)),
]
</syntaxhighlight>

== 认证与权限 ==
Django REST framework提供了多种认证方式：
* Token认证
* Session认证
* Basic认证
* OAuth/JWT认证

示例：限制API仅对认证用户开放
<syntaxhighlight lang="python">
REST_FRAMEWORK = {
    'DEFAULT_PERMISSION_CLASSES': [
        'rest_framework.permissions.IsAuthenticated',
    ]
}
</syntaxhighlight>

== 实际应用案例 ==
Django REST framework被许多知名公司和项目使用：
* [[Instagram]] - 用于构建内部API
* [[Mozilla]] - 部分Web服务的API实现
* [[Eventbrite]] - 活动管理平台的API
* [[Red Hat]] - 部分管理接口

== 性能优化 ==
对于高流量API，可以考虑以下优化策略：
* 使用分页限制响应大小
* 实现缓存策略
* 优化数据库查询
* 使用[[Django Debug Toolbar]]分析性能瓶颈

== 生态系统扩展 ==
DRF有丰富的第三方扩展：
* [[django-filter]] - 添加过滤功能
* [[drf-yasg]] - 生成Swagger文档
* [[djangorestframework-simplejwt]] - JWT认证支持

== 参见 ==
* [[Django]]
* [[REST]]
* [[API设计]]
* [[GraphQL]]

== 参考资料 ==
* 官方文档：https://www.django-rest-framework.org/
* GitHub仓库：https://github.com/encode/django-rest-framework

[[Category:Web框架]]
[[Category:Django]]
[[Category:API]]