如何使用 Django REST framework 构建 API？

推荐答案

使用 Django REST framework (DRF) 构建 API 的步骤如下：

1. 安装 Django REST framework
   首先，确保你已经安装了 Django 和 DRF。可以通过以下命令安装 DRF：

   pip install djangorestframework

2. 配置 Django 项目
   在 settings.py 中添加 rest_framework 到 INSTALLED_APPS：

   INSTALLED_APPS = [
       ...
       'rest_framework',
   ]

3. 创建模型
   在 models.py 中定义你的数据模型：

   // www.javascriptcn.com code example
   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()
   
       def __str__(self):
           return self.title

4. 创建序列化器
   在 serializers.py 中创建序列化器，用于将模型实例转换为 JSON 格式：

   from rest_framework import serializers
   from .models import Book
   
   class BookSerializer(serializers.ModelSerializer):
       class Meta:
           model = Book
           fields = ['id', 'title', 'author', 'published_date']

5. 创建视图
   在 views.py 中创建视图，处理 API 请求：

   from rest_framework import generics
   from .models import Book
   from .serializers import BookSerializer
   
   class BookListCreateView(generics.ListCreateAPIView):
       queryset = Book.objects.all()
       serializer_class = BookSerializer

6. 配置 URL
   在 urls.py 中配置 URL 路由：

   from django.urls import path
   from .views import BookListCreateView
   
   urlpatterns = [
       path('books/', BookListCreateView.as_view(), name='book-list-create'),
   ]

7. 运行服务器
   启动 Django 开发服务器，访问 http://127.0.0.1:8000/books/ 即可查看 API 接口。

本题详细解读

1. 安装 Django REST framework

Django REST framework 是一个强大的工具，用于构建 Web API。它提供了许多内置功能，如序列化、视图、认证等，使得构建 API 变得更加简单。

2. 配置 Django 项目

将 rest_framework 添加到 INSTALLED_APPS 中，以便 Django 能够识别并使用 DRF 的功能。

3. 创建模型

模型是 Django 中用于定义数据库表结构的类。在这个例子中，我们创建了一个 Book 模型，包含书名、作者和出版日期等字段。

4. 创建序列化器

序列化器用于将模型实例转换为 JSON 格式，以便在 API 中返回。ModelSerializer 是 DRF 提供的一个便捷类，可以自动生成序列化器字段。

5. 创建视图

视图是处理 API 请求的核心部分。ListCreateAPIView 是一个通用视图类，提供了列出所有对象和创建新对象的功能。

6. 配置 URL

URL 配置将请求路由到相应的视图。在这个例子中，我们将 /books/ 路径映射到 BookListCreateView 视图。

7. 运行服务器

启动 Django 开发服务器后，你可以通过浏览器或工具（如 Postman）访问 API 接口，查看返回的 JSON 数据。

通过以上步骤，你可以快速构建一个简单的 RESTful API，并使用 Django REST framework 提供的强大功能来处理数据。