前言
在当今互联网开发中，前后端分离架构和Restful风格API成为主流。本文将深入探讨前后端分离、Restful风格、接口文档的概念，并重点介绍DRF（Django-Rest-Framework）的使用，包括APIView处理请求与响应的方法，以及序列化的重要性。
一、基本概念
1. 什么是前后端分离
传统的不分离：
用户在浏览器上发送请求，服务器端接收到请求，根据 Header 中的 token 进行用户鉴权，从数据库取出数据，处理后将结果数据填入 HTML 模板，返回给浏览器，浏览器将 HTML 展现给用户，不分离的核心就是模版，比如 Django 直接将返回数据到模版，通过模版表单将数据返回至后端
前后端不分离的特点：
- 业务耦合较强
- 职责划分不明确
- 开发成本较高
- 服务器压力较大
- 可提高 SEO 速度，提高搜索引擎收录检索速度
现在的前后端分离：
数据渲染的工作在客户端浏览器，不需要服务端完成，服务端专注于提供数据。那么这就要求Django框架不需要返回一个模版页面，而是返回一套JSON数据，而由于JSON可以在多种语言中支持，是一种交互、兼容非常合适的语言格式，所以现在后台常返回的数据都为JSON格式的，这个过程也称作序列化
前后端分离的特点：
- 部署解耦
- 业务划分清晰，职责更为明确
- 开发成本较低，一套后台可以支持多套前端渲染
- SEO 优化较差，需要引入一些页面静态化手段
2. 什么是restful风格
在前后端分离的应用模式里，API接口如何定义？是否存在一种统一的定义方式，被广大开发人员接受认可的方式呢？
restful风格–指的是前后端交互的接口的格式定义
RestFul 规范建议：
1. 域名要有标识：
Restful 风格建议，Api 服务器的域名要尽量在专用域名之下
例如：百度面向用户的站点地址为
https://baidu.com那么，其后端接口地址可以为：
https://api.baidu.com或https://baidu.com/api/2.路由中体现接口版本号
例如：
http://openapi.tuling123.com/openapi/api/v23. url 建议名词复数
例如：
/goods/ 获取所有商品
/infos/
/addresses/
path("news/", NewsView.as_well())
path("news/<int:id>", NewsView.as_well())4.使用合理的请求方式
例如：
对应操作，应该返回操作后的资源结果，比如获取数据，那就应该使用GET请求方式
如果是更新数据，那么建议使用PUT或PATCH方法
- GET：获取数据
- POST：提交数据，创建数据
- PUT：提交数据，更新数据
- DELETE：删除数据
还有三个不常用的HTTP动词:
- PATCH：在服务器更新(更新)资源
- HEAD：获取资源的元数据
- OPTIONS：获取信息，关于资源的哪些属性是客户端可以改变的
提供参数过滤数据：
如果数据较多，返回所有数据是不现实的，那么可以让API提供参数，进行结果返回
?limit=10：指定返回记录的数量
?offset=10：指定返回记录的开始位置。
?page=2&per_page=100：指定第几页，以及每页的记录数。
?sortby=name&order=asc：指定返回结果按照哪个属性排序，以及排序顺序。
?animal_type_id=1：指定筛选条件5.使用合理的状态码：(示例如下)
200 OK - [GET] # 服务器成功返回用户请求的数据 201 CREATED - [POST/PUT/PATCH] # 用户新建或修改数据成功。 204 NO CONTENT - [DELETE] # 用户删除数据成功。 202 Accepted - [*] # 表示一个请求已经进入后台排队（异步任务） ---------------------------------------------------- 400 INVALID REQUEST - [POST/PUT/PATCH] # 用户发出的请求有错误，服务器没有进行新建或修改数据的操作 401 Unauthorized - [*] # 表示用户没有权限（令牌、用户名、密码错误）。 403 Forbidden - [*] # 表示用户得到授权（与 401 错误相对），但是访问是被禁止的。 404 NOT FOUND - [*] # 用户发出的请求针对的是不存在的记录，服务器没有进行操作，该操作是幂等的。 405 请求方式错误 406 Not Acceptable - [GET] # 用户请求的格式不可得（比如用户请求 JSON 格式，但是只有 XML 格式）。 410 Gone -[GET] # 用户请求的资源被永久删除，且不会再得到的。 422 Unprocesable entity - [POST/PUT/PATCH] # 当创建一个对象时，发生一个验证错误。 --------------------------------------------------- 500 INTERNAL SERVER ERROR - [*] # 服务器发生错误，用户将无法判断发出的请求是否成功
3. 什么是接口及接口文档
API，全称是Application Programming Interface，即应用程序编程接口，我们日常中习惯简称为“接口”。比如我们要实现一个手机注册的功能，那么相应地后台工程师就需要提供一个手机注册的接口，前端开发人员在调用接口实现功能的时候，只需按照既定的规则进行请求即可，不需要去理解该功能的实现逻辑。有了这么一个机制，就使得开发人员间的协作变得非常简洁、高效。
所以，可以简单地理解为“接口决定了功能”。
接口文档又称为API文档，一般是由后台开发人员所编写的，用来描述系统所提供接口信息的文档。 大家都根据这个接口文档进行开发，并需要一直维护和遵守。
4. 如何阅读接口文档
API接口文档一般分为接口描述、接口地址、请求方法、请求参数、响应内容、错误代码、实例几个部分：
接口描述：简单描述接口的逻辑和作用。例如说明这是一个发送消息的接口、查询天气的接口；
接口地址：这个地址表示的是网络地址，即url，我们需要调用接口url，获取响应内容；
请求方法：常见的请求方法为GET和POST；
请求参数：用来传递信息的变量。即需要请求的字段名的名称和规则：都是哪些字段，字段的类型是什么，是否必填字段等等；
响应内容：接口返回的字段名称和规则；
错误代码：对接口的错误用代码进行归类，以便能快速找到错误原因，解决问题；
实例：实际调用时的响应的内容。
二、DRF工程-django-restful-framework
1. DRF工程搭建
安装DRF框架
pip install djangorestframework -i https://pypi.tuna.tsinghua.edu.cn/simple
配置 settings.py
INSTALLED_APPS = [ ... 'rest_framework', ]
2. DRF官方文档导读
这个框架封装了很多很多复用的功能：
- 将请求的数据转换为模型类对象
- 操作数据库
- 将模型类对象转换为响应的数据如JSON格式
视图封装：DRF统一封装了请求的数据为request.data以及返回数据的Response方法序列化器：DRF提供了序列化器可以统一便捷的进行序列化及反序列化工作认证：对用户登陆进行身份验证权限：对用户权限进行认证，超级用户、普通用户、匿名用户啥的限流：对访问的用户流量进行限制，减轻接口的访问压力过滤：可以对列表数据进行字段过滤，并可以通过添加django-fitlter扩展来增强支持排序：来帮助我们快速指明数据按照指定字段进行排序分页：可以对数据集进行分页处理异常处理：DRF提供了异常处理，我们可以自定义异常处理函数接口文档生成：DRF还可以自动生成接口文档
三、APIView
APIView是Django REST framework中的一个类，用于处理HTTP请求并返回HTTP响应。APIView提供了一种基于类的视图的方式，可以更方便地编写RESTful API。APIView可以处理GET、POST、PUT、DELETE等HTTP请求，并根据请求的类型调用对应的方法，如get()、post()、put()、delete()等。通过APIView，开发者可以更加灵活地定义API的行为和逻辑。
django框架和drf框架对比：
| django框架 | django-drf框架 |
| HttpRequest | Request |
| HttpResponse | Response |
| 查询参数： request.GET | request.query_params |
| 路径参数：路由转换器 | 路由转换器 |
| 请求头： request.META | request.headers |
| 请求体-表单： request.POST | request.data |
| 请求体-非表单：request.body | request.data |
| 解析上传文件： request.FILES | request.data |
| 类视图： View | APIView |
| JsonResponse | Response |
| render | Response |
1. APIView处理Request
DRF将request.POST、request.FILES,request.body的数据统一封装到了data属性中，其中包含了
- 解析之后的文件、非文件数据
- 对POST、PUT、PATCH请求方式解析后的数据
- 表单类型数据、JSON类型数据
# app/views.py from rest_framework.views import APIView class ExampleView(APIView): def post(self, request): data = request.data # json/form 提交的数据 return Response({'received data': request.data})
DRF为了更准确的表示这是从连接里取得数据，从而把request.GET的名字更换为了request.query_params，其余操作与request.GET一样，这里只是拼写更换
# app/views.py from rest_framework.views import APIView class ExampleView(APIView): def get(self, request): data = request.query_params # get 的连接传参 return Response({'received data': request.query_params})
2. 视图的Response及json处理
目前在DRF中，我们所使用最多的就是Response这个方法，经常使用已经序列化好的数据结合Response返回
Response(data=None, status=None, template_name=None, headers=None, exception=False, content_type=None) ''' data: 需要返回的数据 status: 状态码 headers: 头部信息 content-type: 返回数据 MIME 类型,一般不要多余设置，drf 会自动根据数据进行设置 '''
需要注意的是，在Response函数的第一个参数位置上，这个data不能是复杂结构的数据，比如ORM查询到的数据，ORM的数据需要提取出来成为Python的数据类型或者使用序列化方式将其加工才可以使用Response进行返回
3. 常见状态码及Response的状态码处理
200 OK - [GET] # 服务器成功返回用户请求的数据 201 CREATED - [POST/PUT/PATCH] # 用户新建或修改数据成功。 202 Accepted - [*] # 表示一个请求已经进入后台排队（异步任务） 204 NO CONTENT - [DELETE] # 用户删除数据成功。
四、序列化
1. 什么是json
这一种在各个编程语言中流通的数据格式，可以在不同的编程语言中的进行数据传递和交互
也就是用JSON传输数据可以让不同语言之间可以跨越语言不同的鸿沟，虽然 python 无法和 js 进行通信，但是通过JSON，就可以让两者进行数据通信，所以现在常见的接口返回的数据都是JSON格式
2. 什么是序列化
序列化：就是把模型层的数据返回为JSON数据集—>将模型类对象转换为响应的数据如JSON格式
反序列化：就是把前端发来的JSON数据，类字典数据，变为模型层的数据—> 前端json数据–转换成 模型对象
3.QuerySet如何进行Json处理
QuerySet对象是Django-ORM中查询数据返回的类似列表的多数据集合
详细介绍QuerySet 的一篇文章：Django ORM的QuerySet：解锁数据库交互的魔法钥匙
返回QuerySet的过滤器方法有:
all : 返回全部数据的QuerySet filter : 返回满足条件的QuerySet exclude : 返回条件之外的QuerySet
对QuerySet进行手动处理：
# 序列化 #query_set<[object, obj2]> book_set = Book.objects.all() books = [] # 遍历 每一个 模型对象 for book in book_set: books.append({ 'id': book.id, 'btitle': book.btitle, 'price': book.price, 'bread': book.bread, 'bcomment': book.bcomment })
反序列化：django将前端传递的
json格式的字符串数据接收并转换为模型对象，这个过程称之为反序列化
对获取的json数据，手动进行反序列化：
#获取前端传递数据 json_dict = request.data json_dict = { "btitle":"光年"， "price":18.8, "bread":20, "bcomment":200 } # 模型对象，将获取的json格式数据插入 obj = Book() obj.btitle = json_dict['btitle'] obj.price = json_dict['price'] obj.bread = json_dict['bread'] obj.bcomment = json_dict['bcomment'] ojb.save()
4.DRF中的序列化器
DRF中，给我们提供了一个实现序列化的组件，也叫序列化器，就是
serializers。
serializers序列化组件：
- 序列化过程：可以把我们用ORM产生的
QuerySet对象转换成json格式数据； - 反序列化过程：可以实现数据校验功能，并把客户端发送过来的数据(
前端json格式字符串)，经过request.data以后变成字典，再把字典转成模型，存到数据库；
序列化器特点：
1、将复杂的数据结构与python对象之间进行转换；
2、可以根据输入和输出数据的需要进行多级嵌套。
3、改变序列化输出数据的格式可以通过指定字段的
source来源，使用SerializerMethodField自定义方法以及使用嵌套序列化器。4、支持可以自定义验证和转换方法：反序列化时需要对客户端发送的数据进行验证。可以通过自定义
validate方法进行字段或对象级别的验证，还可以使用自定义的validators或DRF自带的验证器。5、当使用嵌套序列化器后，多个关联模型同时的创建和更新的行为并不明确，需要显示地重写create和update方法。
普通序列化器（Serializer）代码示例：
class BookSerializer(serializers.Serializer): btitle = serializers.CharField(max_length=20, label='图书名称') price = serializers.DecimalField(max_digits=7, decimal_places=2, label='单价') bread = serializers.IntegerField(default=0, required=False, label='阅读量') bcomment = serializers.IntegerField(default=0, required=False, label='评论量') img = serializers.ImageField(label='封面图片', required=False)
