1.DRF框架简介
Django REST framework 框架是一个用于构建Web API 的强大而又灵活的工具。
通常简称为DRF框架 或 REST framework。
DRF框架是建立在Django框架基础之上,由Tom Christie大牛二次开发的开源项目。
在序列化与反序列化时,虽然操作的数据不尽相同,但是执行的过程却是相似的,也就是说这部分代码是可以复用简化编写的。
在开发REST API的视图中,虽然每个视图具体操作的数据不同,但增、删、改、查的实现流程基本套路化,所以这部分代码也是可以复用简化编写的:
增:校验请求数据 -> 执行反序列化过程 -> 保存数据库 -> 将保存的对象序列化并返回
删:判断要删除的数据是否存在 -> 执行数据库删除
改:判断要修改的数据是否存在 -> 校验请求的数据 -> 执行反序列化过程 -> 保存数据库 -> 将保存的对象序列化并返回
查:查询数据库 -> 将数据序列化并返回
Django REST framework可以帮助我们简化上述两部分的代码编写,大大提高REST API的开发速度。
2.DRF特点
1.提供了定义序列化器Serializer的方法,可以快速根据 Django ORM 或者其它库自动序列化/反序列化;
2.提供了丰富的类视图、Mixin扩展类,简化视图的编写;
3.丰富的定制层级:函数视图、类视图、视图集合到自动生成 API,满足各种需要;
4.多种身份认证和权限认证方式的支持;
5.内置了限流系统;
6.直观的 API web 界面;
7.可扩展性,插件丰富
3.环境安装与配置
DRF是以Django扩展应用的方式提供的,所以我们可以直接利用已有的Django环境而无需从新创建。(若没有Django环境,需要先创建环境安装Django
)
- 安装DRF
pip install djangorestframework
- 添加rest_framework应用
我们利用在Django框架学习中创建的demo工程,在settings.py的INSTALLED_APPS中添加’rest_framework’。
INSTALLED_APPS = [
...
'rest_framework',
]
接下来就可以使用DRF进行开发了。
4.DRF牛刀小试
我们仍以在学习Django框架时使用的图书英雄为案例,使用Django REST framework快速实现图书的REST API。
1. 创建序列化器
在books应用中新建serializers.py用于保存该应用的序列化器。
创建一个BookInfoSerializer用于序列化与反序列化。
from rest_framework import serializers
from books.models import BookInfo
class BookInfoSerializer(serializers.ModelSerializer):
"""图书数据序列化器"""
class Meta:
model = BookInfo
fields = '__all__'
model 指明该序列化器处理的数据字段从模型类BookInfo参考生成
fields 指明该序列化器包含模型类中的哪些字段,'all’指明包含所有字段
2. 编写视图
在books应用的views.py中创建视图BookInfoViewSet,这是一个视图集合。
from rest_framework.viewsets import ModelViewSet
from .serializers import BookInfoSerializer
from .models import BookInfo
class BookInfoViewSet(ModelViewSet):
queryset = BookInfo.objects.all()
serializer_class = BookInfoSerializer
queryset 指明该视图集在查询数据时使用的查询集
serializer_class 指明该视图在进行序列化或反序列化时使用的序列化器
3. 定义路由
在books应用的urls.py中定义路由信息。
from . import views
from rest_framework.routers import DefaultRouter
urlpatterns = [
]
router = DefaultRouter() # 可以处理视图的路由器
router.register(r'books', views.BookInfoViewSet) # 向路由器中注册视图集
urlpatterns += router.urls # 将路由器中的所以路由信息追到到django的路由列表中
4. 运行测试
在浏览器中输入网址127.0.0.1:8000,可以看到DRF提供的API Web浏览页面:
![在这里插入图片描述](https://img-blog.csdnimg.cn/20210404153927624.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDMyNzYzNA==,size_16,color_FFFFFF,t_70)
1)点击链接127.0.0.1:8000/books/ 可以访问获取所有数据的接口,呈现如下页面:![在这里插入图片描述](https://img-blog.csdnimg.cn/20210404154047983.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDMyNzYzNA==,size_16,color_FFFFFF,t_70)
2)在页面底下表单部分填写图书信息,可以访问添加新图书的接口,保存新书:
![在这里插入图片描述](https://img-blog.csdnimg.cn/20210404154258878.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDMyNzYzNA==,size_16,color_FFFFFF,t_70)
点击POST后,返回如下页面信息:
![在这里插入图片描述](https://img-blog.csdnimg.cn/2021040415432631.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDMyNzYzNA==,size_16,color_FFFFFF,t_70)
查看数据库表成功写入:
![在这里插入图片描述](https://img-blog.csdnimg.cn/2021040415451998.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDMyNzYzNA==,size_16,color_FFFFFF,t_70)
3)在浏览器中输入网址127.0.0.1:8000/books/8/,可以访问获取单一图书信息的接口(id为8的图书),呈现如下页面:
![在这里插入图片描述](https://img-blog.csdnimg.cn/20210404154631618.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDMyNzYzNA==,size_16,color_FFFFFF,t_70)
4)在页面底部表单中填写图书信息,可以访问修改图书的接口:![在这里插入图片描述](https://img-blog.csdnimg.cn/20210404154940843.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDMyNzYzNA==,size_16,color_FFFFFF,t_70)
点击PUT,返回如下页面信息:
![在这里插入图片描述](https://img-blog.csdnimg.cn/20210404155008713.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDMyNzYzNA==,size_16,color_FFFFFF,t_70)
数据库表也成功修改:
![在这里插入图片描述](https://img-blog.csdnimg.cn/20210404155042495.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDMyNzYzNA==,size_16,color_FFFFFF,t_70)
5)点击DELETE按钮,可以访问删除图书的接口(如删除id为1的图书):
![在这里插入图片描述](https://img-blog.csdnimg.cn/20210404155231845.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDMyNzYzNA==,size_16,color_FFFFFF,t_70)
![在这里插入图片描述](https://img-blog.csdnimg.cn/20210404155325990.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDMyNzYzNA==,size_16,color_FFFFFF,t_70)
再点delete,返回如下页面:
![在这里插入图片描述](https://img-blog.csdnimg.cn/20210404155359416.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDMyNzYzNA==,size_16,color_FFFFFF,t_70)
数据表成功删除id为1的图书:
![在这里插入图片描述](https://img-blog.csdnimg.cn/2021040415544982.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDMyNzYzNA==,size_16,color_FFFFFF,t_70)
看到现在,是不是发现DRF框架很强大!