Django Rest框架详解|极客教程

Django Rest框架详解

Django Rest框架是一个基于Django的Web API框架，让我们可以更容易地构建和发布Web API。它提供了一组工具和库，帮助我们快速构建RESTful API，并且还包含了许多强大的功能。

1. 为什么选择Django Rest框架

方便快捷：Django Rest框架提供了许多现成的功能和组件，让我们可以快速构建出一个完整的API。
强大的功能：Django Rest框架提供了许多功能，比如内置的认证、权限控制、序列化、过滤、分页等。
与Django无缝集成：Django Rest框架与Django完美结合，让我们可以很容易地在Django项目中添加API功能。
文档丰富：Django Rest框架拥有详细的文档，让我们可以很容易地学习和使用。

2. 安装和配置Django Rest框架

首先，我们需要先安装Django Rest框架。可以使用pip命令进行安装：

pip install djangorestframework

安装完成后，我们需要在Django项目的settings.py文件中进行配置，将Django Rest框架添加到INSTALLED_APPS中：

INSTALLED_APPS = [
    ...
    'rest_framework',
]

3. 创建序列化器

在Django Rest框架中，我们需要使用序列化器来定义API的输出格式。序列化器可以将数据库模型或其它数据结构序列化为JSON格式。

首先，我们需要定义一个数据模型：

from django.db import models

class Book(models.Model):
    title = models.CharField(max_length=100)
    author = models.CharField(max_length=100)
    publication_date = models.DateField()

然后，我们可以创建一个序列化器来序列化这个数据模型：

from rest_framework import serializers
from .models import Book

class BookSerializer(serializers.ModelSerializer):
    class Meta:
        model = Book
        fields = '__all__'

4. 创建API视图

接下来，我们需要创建API视图来展示我们的API。可以通过函数视图或类视图的方式来创建API视图。

使用函数视图创建API视图：

from rest_framework.decorators import api_view
from rest_framework.response import Response
from .models import Book
from .serializers import BookSerializer

@api_view(['GET'])
def book_list(request):
    books = Book.objects.all()
    serializer = BookSerializer(books, many=True)
    return Response(serializer.data)

使用类视图创建API视图：

from rest_framework.views import APIView
from rest_framework.response import Response
from .models import Book
from .serializers import BookSerializer

class BookList(APIView):
    def get(self, request):
        books = Book.objects.all()
        serializer = BookSerializer(books, many=True)
        return Response(serializer.data)

5. 添加API路由

最后，我们需要将API路由添加到Django项目中。可以使用Django Rest框架提供的DefaultRouter或者手动配置路由的方式。

使用DefaultRouter自动生成路由：

from rest_framework.routers import DefaultRouter
from .views import BookViewSet

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

手动配置路由：

from django.urls import path
from .views import book_list

urlpatterns = [
    path('books/', book_list),
]

结语

通过以上步骤，我们就可以在Django项目中使用Django Rest框架来构建一个RESTful API。Django Rest框架提供了丰富的功能和工具，让我们可以快速构建出一个完整的API，并且简化了很多工作。

Django Rest框架详解