前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >Python利用Django 构建Rest Api: 快速入门教程

Python利用Django 构建Rest Api: 快速入门教程

作者头像
测试开发技术
发布2020-01-17 17:46:32
5.3K0
发布2020-01-17 17:46:32
举报
文章被收录于专栏:测试开发技术

阅读全文大概需要 9分钟。

1. 前言

在本篇中,我们将为大家介绍如何基于Python构建一个以Django Rest框架为特征的博客应用程序API服务,并且该API服务支持CRUD (Create-Read-Update-Delete)功能。

PS: API(应用程序编程接口)为开发人员提供了与应用程序数据库交互的接口。

2. Django项目配置

首先在本地为我们的代码创建一个新的目录。例如,本文将它放在一个叫做blog_api的文件夹里,但是你可以把它放在任何地方,然后配置我们的项目。

代码语言:javascript
复制
# 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列表。

代码语言:javascript
复制
# 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。

代码语言:javascript
复制
# 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

创建新的迁移文件并更新同步到数据库。

代码语言:javascript
复制
(env) $ python manage.py makemigrations
(env) $ python manage.py migrate

4. 配置管理后台Admin

我们希望在Django的后台中管理我们的数据,因此,让我们将Post添加到下面。

代码语言:javascript
复制
# posts/admin.py
from django.contrib import admin
from . models import Post
admin.site.register(Post)

然后创建一个超级管理员帐户。

代码语言:javascript
复制
(env) $ python manage.py createsuperuser

现在我们就可以启动django web服务了。

代码语言:javascript
复制
(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库,如果仍未安装,可输出下述命令安装。

代码语言:javascript
复制
(env) $  pip install djangorestframework

2、然后将它添加到我们的settings.py文件的INSTALLED_APPS部分。

代码语言:javascript
复制
# 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。

代码语言:javascript
复制
(env) $ touch blog_api/serializers.py

请记住,序列化器用于将我们的数据转换成JSON格式,serializers.py文件代码如下所示。

代码语言:javascript
复制
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也有我们可以使用的通用视图。例如,本示例中,我们定义一个列出所有博客文章和一个文章内容详细视图以及更新文章内容的视图,脚本如下所示。

代码语言:javascript
复制
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路由规则。

代码语言:javascript
复制
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文件。

代码语言:javascript
复制
(env) $ touch blog_api/urls.py

然后输入下面的代码。

代码语言:javascript
复制
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则为第二篇文章,等等。

5. Rest Api实战示例效果

1、首先启动服务器。

代码语言:javascript
复制
(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工具在命令行终端获取:

代码语言:javascript
复制
http http://127.0.0.1:8000/api/

到此,本篇分享介绍完毕,正在读文的你,学会了吗

希望这篇文章能帮到你!更多干货文章请关注我们

如有疑问,请文末留言,最后,公号「测试开发技术」后台回复Python, 免费领取Python学习教程。

END

本文参与 腾讯云自媒体同步曝光计划,分享自微信公众号。
原始发表:2019-12-25,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 测试开发技术 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 1. 前言
  • 2. Django项目配置
  • 3. 定义数据模型、执行数据同步
  • 4. 配置管理后台Admin
  • 5. Django Rest Framework 安装、配置
  • 5. Rest Api实战示例效果
相关产品与服务
文件存储
文件存储(Cloud File Storage,CFS)为您提供安全可靠、可扩展的共享文件存储服务。文件存储可与腾讯云服务器、容器服务、批量计算等服务搭配使用,为多个计算节点提供容量和性能可弹性扩展的高性能共享存储。腾讯云文件存储的管理界面简单、易使用,可实现对现有应用的无缝集成;按实际用量付费,为您节约成本,简化 IT 运维工作。
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档