drf-day01

前后端分离开发模式

简单来说就是，前端只需要开发与用户交互的界面调用后端接口，后端开发前端交互需要的功能以及一些而后端相关并给前端提供接口。

前后端混合开发

后端人员要通过前端写好的html页面（模板），使用模板语法渲染模板：

• 图书管理系统
• bbs项目

前后端分离

后端人员只负责写接口（API）,使用postman接口测试工具测试

前端人员只负责写前端，写的过程使用mock数据

最后，前后端联调项目

API接口

通过网络，规定看求你后台信息交互规则的链接，也就是前后台信息交互的媒介。

Web API接口简单概括有下面四大特点

• url：长得像返回数据的url链接
  • https://api.map.baidu.com/place/v2/search
• 请求方式：get、post、put、patch、delete
  • 采用get方式请求上方接口
• 请求参数：json或xml格式的key-value类型数据
  • ak：6E823f587c95f0148c19993539b99295
  • region：上海
  • query：肯德基
  • output：json
• 响应结果：json或xml格式的数据
  • 上方请求参数的output参数值决定了响应数据的格式
  • 数据

接口测试工具postman

Postman是一款接口调试工具，是一款免费的可视化软件，同时支持各种操作系统平台，是测试接口的首选工具。

1. Postman可以直接从官网下载获得，然后进行傻瓜式（双击下载的.exe文件）安装。

2. 安装好之后直接跳过进入app即可：

   

• 简单的get请求

restful规范

REST全称是Representational State Transfer，中文意思是表述（编者注：通常译为表征性状态转移）。 它首次出现在2000年Roy Fielding的博士论文中。

RESTful是一种定义Web API接口的设计风格，尤其适用于前后端分离的应用模式中。

这种风格的理念认为后端开发任务就是提供数据的，对外提供的是数据资源的访问接口，所以在定义接口时，客户端访问的URL路径就表示这种要操作的数据资源。

数据的安全保障

• url链接一般都采用https协议进行传输

  注：采用https协议，可以提高数据交互过程中的安全性

接口特征表现

• 用api关键字标识接口url：

  • https://api.baidu.com
  • https://www.baidu.com/api

  注：看到api字眼，就代表该请求url链接是完成前后台数据交互的

多数据版本共存

• 在url链接中标识数据版本

  • https://api.baidu.com/v1
  • https://api.baidu.com/v2

  注：url链接中的v1、v2就是不同数据版本的体现（只有在一种数据资源有多版本情况下）

数据即是资源，均使用名词（可复数）

• 接口一般都是完成前后台数据的交互，交互的数据我们称之为资源
• 特殊的接口可以出现动词，因为这些接口一般没有一个明确的资源，或是动词就是接口的核心含义

资源操作由请求方式决定（method）

• 操作资源一般都会涉及到增删改查，我们提供请求方式来标识增删改查动作
  • 获取数据：get请求
  • 删除数据：delete请求
  • 新增数据：post请求
  • 修改数据：put，patch请求
  • 请求地址一样，通过请求方式决定对资源进行什么操作

过滤，通过在url上传参的形式传递搜索条件

• https://api.example.com/v1/zoos?limit=10：指定返回记录的数量
• https://api.example.com/v1/zoos?offset=10：指定返回记录的开始位置
• https://api.example.com/v1/zoos?page=2&per_page=100：指定第几页，以及每页的记录数
• https://api.example.com/v1/zoos?sortby=name&order=asc：指定返回结果按照哪个属性排序，以及排序顺序
• https://api.example.com/v1/zoos?animal_type_id=1：指定筛选条件

响应状态码

1. 正常响应

• 响应状态码2xx
  • 200：常规请求
  • 201：创建成功

2. 重定向响应

• 响应状态码3xx
  • 301：永久重定向
  • 302：暂时重定向

2. 客户端异常

• 响应状态码4xx
  • 403：请求无权限
  • 404：请求路径不存在
  • 405：请求方法不存在

3. 服务器异常

• 响应状态码5xx
  • 500：服务器异常

错误处理，应返回错误信息，error当做key

# 响应体中带错误信息
{
    error: "无权限操作"
}

返回结果，针对不同操作，服务器向用户返回的结果应该符合以下规范

GET /collection：返回资源对象的列表（数组）
GET /collection/resource：返回单个资源对象
POST /collection：返回新生成的资源对象
PUT /collection/resource：返回完整的资源对象
PATCH /collection/resource：返回完整的资源对象
DELETE /collection/resource：返回一个空文档

需要url请求的资源需要访问资源的请求链接

# Hypermedia API，RESTful API最好做到Hypermedia，即返回结果中提供链接，连向其他API方法，使得用户不查文档，也知道下一步应该做什么
{
  	"status": 0,
  	"msg": "ok",
  	"results":[
        {
            "name":"肯德基(罗餐厅)",
            "img": "https://image.baidu.com/kfc/001.png"
        }
      	...
		]
}

序列化和反序列化

api接口开发，最核心最常见的一个过程就是序列化，所谓序列化就是把数据转换格式，序列化可以分两个阶段：

• 序列化： 把我们识别的数据转换成指定的格式提供给别人

  例如：我们在django中获取到的数据默认是模型对象(queryset)，但是模型对象数据无法直接提供给前端或别的平台使用，所以我们需要把数据进行序列化，变成字符串或者json数据，提供给别人。

• 反序列化：把别人提供的数据转换/还原成我们需要的格式

django restframework快速使用

核心思想: 缩减编写api接口的代码

使用django这个web框架，开发前后端分离项目(模板渲染),只写接口

• 使用JsonResponse返回即可>>>原生django
• djangorestframework方便咱们快速写出符合restful规范的接口

写接口：总共就5个及这5个的变形

• 获取所有 get
• 获取单个 get
• 新增一条 post
• 修改一条 put/patch
• 删除一条 delete

快速实现这5个接口:

安装drf

pip3 install djangorestframework

cbv源码分析

# 视图层
from django.shortcuts import render, HttpResponse
from django.views import View
class CBVTest(View):
    # 通过调度(dispatch)分发请求
    def dispatch(self, request, *args, **kwargs):
        pass
        super().dispatch(request, *args, **kwargs)
        pass

    def get(self, request):
        return render(request, 'cbv.html')

    def post(self, request):
        return HttpResponse('cbv post method')

<!-- 模板层 -->
<form action="/cbv/" method="post">
    {% csrf_token %}
    <input type="text" name="usr">
    <button type="submit">提交</button>
</form>

# 路由层
from app import views
urlpatterns = [
    url(r'^cbv/', views.CBVTest.as_view()),
]