1. 前言
在本篇中，我们将为大家介绍如何基于Python构建一个以Django Rest框架为特征的博客应用程序API服务，并且该API服务支持CRUD (Create-Read-Update-Delete)功能。
PS: API(应用程序编程接口)为开发人员提供了与应用程序数据库交互的接口。
2. Django项目配置
首先在本地为我们的代码创建一个新的目录。例如，本文将它放在一个叫做blog_api的文件夹里，但是你可以把它放在任何地方，然后配置我们的项目。
# Create the project directory mkdir blog_api cd blog_api # Create a virtual environment to isolate our package dependencies locally python3 -m venv env source env/bin/activate # On Windows use `env\Scripts\activate` # Install Django and Django REST framework into the virtual environment pip install django pip install djangorestframework # Set up a new project with a single application django-admin startproject blog_project cd blog_project django-admin startapp blog_api cd ..
经过上述的操作后，我们创建了名为env的虚拟隔离开发环境，并在此环境下面，创建了一个名为`blog_project`的Django项目，并且创建一个Django App ：`blog_api` 。因为添加了一个新的app，我们需要告诉Django。因此，请确保将blog_api添加到setting.py文件中的INSTALLED_APPS列表。
# blog_project/settings.py INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.staticfiles', 'blog_api',]
3. 定义数据模型、执行数据同步
定义数据模型，此处我们创建四个字段: title、content、created_at和updated_at。
# blog_api/models.py from django.db import models class Post(models.Model): title = models.CharField(max_length=50) content = models.TextField() created_at = models.DateTimeField(auto_now_add=True) updated_at = models.DateTimeField(auto_now=True) def __str__(self): return self.title
创建新的迁移文件并更新同步到数据库。
(env) $ python manage.py makemigrations (env) $ python manage.py migrate
4. 配置管理后台Admin
我们希望在Django的后台中管理我们的数据，因此，让我们将Post添加到下面。
# posts/admin.py from django.contrib import admin from . models import Post admin.site.register(Post)
然后创建一个超级管理员帐户。
(env) $ python manage.py createsuperuser
现在我们就可以启动django web服务了。
(env) $ python manage.py runserver
浏览器输入 localhost:8000/admin，并使用刚刚创建的账户登陆。
点击帖子旁边的“+ Add”按钮，输入一些新的内容，例如下图所示。
到此，我们已经完成了Django部分，由于我们本篇示例，是为了创建一个API服务，所以我们不需要创建模板和视图。相反，我们还需要继续添加Django Rest库来处理将模型数据转换为Rest API。
5. Django Rest Framework 安装、配置
DjangoRestFramework，简称为DRF，它是负责将数据库模型转换为RESTful API。这个过程有两个主要步骤:首先通过序列化器将数据转换成JSON，这样就可以通过internet发送数据，然后使用view来定义发送的数据。
1、在前面第二步中，我们已经安装好了安装Django Rest库，如果仍未安装，可输出下述命令安装。
(env) $ pip install djangorestframework
2、然后将它添加到我们的settings.py文件的INSTALLED_APPS部分。
# Application definition INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.staticfiles', 'blog_api', 'rest_framework', ]
3、紧接着，创建一个新的py文件，文件名为serializers.py。
(env) $ touch blog_api/serializers.py
请记住，序列化器用于将我们的数据转换成JSON格式，serializers.py文件代码如下所示。
from rest_framework import serializers from . import models class PostSerializer(serializers.ModelSerializer): class Meta: fields = ('id', 'title', 'content', 'created_at', 'updated_at',) model = models.Post
我们首先从DRF库导入序列化模块。接下来，我们创建一个序列化器类并在其中创建一个元类(Meta)。fields字段控制数据库数据的类型。在本例中，我们将暴露所有字段，包括id，这是Django的主键，由Django自动添加到所有数据库记录。
4、接下来，我们需要创建view。正如Django有基于类的视图一样，DRF也有我们可以使用的通用视图。例如，本示例中，我们定义一个列出所有博客文章和一个文章内容详细视图以及更新文章内容的视图，脚本如下所示。
from rest_framework import generics from . import models from . import serializers class PostList(generics.ListAPIView): queryset = models.Post.objects.all() serializer_class = serializers.PostSerializer class PostDetail(generics.RetrieveAPIView): queryset = models.Post.objects.all() serializer_class = serializers.PostSerializer class PostDetail(generics.RetrieveUpdateDestroyAPIView): queryset = models.Post.objects.all() serializer_class = serializers.PostSerializer
在脚本中，我们从DRF中导入基础视图类generics，以及我们的模型和序列化文件。然后我们创建三个view方法，前两个方法都是用于GET，后一个方面，用于POST。
5、在项目根目录中配置修改urls.py路由规则。
from django.contrib import admin from django.urls import include, path urlpatterns = [ path('admin/', admin.site.urls), path('api/', include('blog_api.urls')),]
我们为blog_api创建了一个名为api/的路径。接下来创建blog_api app的 urls.py文件。
(env) $ touch blog_api/urls.py
然后输入下面的代码。
from django.urls import path from . import views urlpatterns = [ path('', views.PostList.as_view()), path('<int:pk>/', views.PostDetail.as_view()),]
所有的博客url都将在 api/里。所以我们的PostList将在api/里，postDetail 则在api/#里，其中#表示条目的id。例如，第一篇博客文章的id为1，所以它的路径为api/1, api/2则为第二篇文章，等等。
6. Rest Api实战示例效果
1、首先启动服务器。
(env) $ python manage.py runserver
2、浏览器打开 http://127.0.0.1:8000/api/，如下所示。
api/端点以JSON格式显示本篇示例添加的2篇博客文章。
3、接着访问http://127.0.0.1:8000/api/2/，您将查看到第二篇文章的详细内容。
在详细视图中，您可以使用“Delete”按钮来删除内容，“Put”来更新内容，“Get”可以像以前一样获取它。例如，此外我们希望更新第二篇贴子的内容，在Title后面增加“狂师”二字，增加后点击PUT按钮，即可完成更新。
4、更新完成之后，重新访问查看api列表http://127.0.0.1:8000/api，如下所示，发现列表中的第二篇文章，已经是我们更新后的内容了。
当然，如果你喜欢用命令行来调用接口，也可以通过httpie工具在命令行终端获取：
http http://127.0.0.1:8000/api/
到此，本篇分享介绍完毕，正在读文的你，学会了吗？
