drf使用

drf快速使用

• web开发模式
• api接口
• api接口测试工具
• restful规范
• 序列化与反序列化
• drf快速使用

# 参考资料：前期：1.http://www.liuqingzheng.top/index2.html
  过期之后使用：2.https://www.cnblogs.com/liuqingzheng
    V:306334678

web开发模式

1.百分之九十的软件都是web模式软件，只要通过http与websocket协议去访问的都是web软件，eg:微信，迅雷等等，它们都是web后端，python不仅仅是开发网站，只要是后端开发的都能使用python像mysql就是cs架构，它的底层就是基于tcp协议传输。应用层就是基于http协议传输的。

# web开发模式分为两大类
1.前后端混合开发：又要写前端:js,css,html+模板语法（dtl）,又要写后端：django
2.前后端分离开发：后端人员只写后端，一点前端都不碰，对外提供接口:(django,flask,fastapi,springboot,gin,beengo);
    前端人员只写前端，模板语法不知道写(vue,react)
    
# java,go,python,rust,nodejs都只是个工具
    

前后端混合开发示意图：

前端先给后端发送一个http请求，先是进行路由匹配，匹配成功之后进入后端查询数据库，然后拿出模板，渲染完之后把模板字符串返回给前端，前端只有html,css跟js，就是在后端渲染完了之后返回给前端浏览器，

前后端分离开发示意图：

前端先获取静态页面，这个静态页面里面没有东西，页面一加载完，马上向后端发送http请求，然后后端去数据库那数据，拿到json格式数据，然后返回给前端，前端JS拿到之后转成JS格式对象，然后dom操作将数据渲染。

api接口

# api接口就是前后端信息交互的媒介
我们写的路由对应的视图函数，返回的json数据格式，这个东西称之为api接口，必须是json格式数据

# 为了在团队内部形成共识、防止个人习惯差异引起的混乱，我们需要找到一种大家都觉得很好的接口实现规范，而且这种规范能够让后端写的接口，用途一目了然，减少双方之间的合作成本，写接口要遵循restful规范

# web api接口和一般的url链接还是有区别的，web api接口简单概括有以下四大特点
1.url：像返回数据的url链接
eg:https://api.map.baidu.com/place/v2/search
2.请求方式：get、post、put、patch、delete
采用get方式请求上方接口
3.请求参数：json或xml格式的key-value类型数据
eg: ak：6E823f587c95f0148c19993539b99295
	region：上海
	query：肯德基
	output：json
4.响应结果：json或xml格式的数据
上方请求参数的output参数值决定了响应数据的格式

# xml格式
https://api.map.baidu.com/place/v2/search?ak=6E823f587c95f0148c19993539b99295&region=%E4%B8%8A%E6%B5%B7&query=%E8%82%AF%E5%BE%B7%E5%9F%BA&output=xml
#json格式
https://api.map.baidu.com/place/v2/search?ak=6E823f587c95f0148c19993539b99295&region=%E4%B8%8A%E6%B5%B7&query=%E8%82%AF%E5%BE%B7%E5%9F%BA&output=json
{
    "status":0,
  	"message":"ok",
    "results":[
        {
            "name":"肯德基(罗餐厅)",
            "location":{
                "lat":31.415354,
                "lng":121.357339
            },
            "address":"月罗路2380号",
            "province":"上海市",
            "city":"上海市",
            "area":"宝山区",
            "street_id":"339ed41ae1d6dc320a5cb37c",
            "telephone":"(021)56761006",
            "detail":1,
            "uid":"339ed41ae1d6dc320a5cb37c"
        }
      	...
		]
}

# 别人提供的一些资源，以api接口的形式给你，你直接访问就可以拿到，接口的概念很大，api接口只针对与http请求返回xml,json数据的这种接口 

api接口测试工具

postman是一款接口调试工具，是一款免费的可视化软件，同时支持各种操作系统平台。
下载地址：官网：https://www.getpostman.com/downloads/
 # 接口测试工具用法基本一致，以postman为例
 
# form-data:提交上传文件【POST中取】
# urlencoded:form表单或者ajax默认的【POST中取】
# json:只能使用ajax提交，必须指定contentType:application/json编码提交数据【request.body中取】

# django中，如果使用form-data或者urlencoded编码，提交的数据直接从'POST'中取出来
# 如果是json格式编码，从'POST'取不出来，只能从request.body取出来，json格式要转换一下才能用

# postman就是一个替代浏览器,发送http请求的工具，因为使用浏览器不能方式post强求，只能用代码写ajax发请求，通过postman可以发送任意请求

collections可以导入导出

RESTful规范

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

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

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

# 10条规范
1.使用https数据交互，http=http+tsl/ssl(tsl/ssl相当于是加密协议)，比http进行数据交互的时候更安全，交互用json格式，很轻易被截获，明文显示给别人，数据不安全。
2.接口地址中带api标识
eg:https://api.baidu.com/books    域名中
   https://www.baidu.com/api	  地址中
3.接口地址中标识版本标识
eg:https://api.baidu.com/v1
   https://api.weibo.com/2/statuses/user_timeline.json
  因为同一款软件版本不同，如果把原来的接口改了，老的版本就用不了了，所以新写一个接口
4.数据即是资源，均使用名词，不要出现动词
eg:删除图书接口
    正确写法：https://api.baidu.com/v1/books
    错误写法：https://api.baidu.com/v1/delete-books
 新增图书：https://api.baidu.com/v1/books
5.资源操作由请求方决定
eg:
    新增图书：https://api.baidu.com/v1/books    post
    删除图书：https://api.baidu.com/v1/books    delete
    修改图书：https://api.baidu.com/v1/books    put
    获取图书：https://api.baidu.com/v1/books    get
 6.地址(url)中带搜索条件
eg:
    https://api.example.com/v1/zoos?animal_type_id=1：指定筛选条件
    https://api.baidu.com/v1/books?name=红楼梦
 7.响应状态码
http的响应状态码
	1xx   请求正在处理
    2xx   成功  200 请求成功    201 创建成功
    3xx   重定向  301 和 302 ---》问301和302的区别？一个是临时重定向一个是永久重定向
    4xx   客户端错误 403 和 404  403：没有权限   404：地址不存在
    5xx   服务端错误 
      响应中带状态码
      	{code:100}
  8.响应中带错误信息
	{code:999，msg：登陆失败}
  9.针对不同操作，服务器向用户返回的结果应该符合以下规范
	 GET /collection：返回资源对象的列表（数组） 
    	eg:		-[{name:红楼梦，price：12},{name:西游记，price：12}]
      GET /collection/resource：返回单个资源对象
      	eg:	-{name:西游记，price：12}
      POST /collection：返回新生成的资源对象
      	eg:	-{name:西厢记，price：12}
      PUT /collection/resource：返回完整的资源对象
      	eg:	-{name:西游记，price：12}
      PATCH /collection/resource：返回完整的资源对象
      	eg:	-{name:西游记，price：12}
      DELETE /collection/resource：返回一个空文档
  10.响应中带链接地址

序列化与反序列化

# 序列化： 把我们识别的数据转换成指定的格式提供给别人
python后端能识别的：python的对象，字典，列表
  	前端：字符串，json格式字符串
    把我们能识别的格式---》转成别人能识别的格式给他
		例如：我们在django中获取到的数据默认是模型对象，但是模型对象数据无法直接提供给前端或别的平台使用，所以我们需要把数据进行序列化，变成字符串或者json数据，提供给别人。

# 反序列化：把别人提供的数据转换/还原成我们需要的格式。
		前端：字符串，json格式字符串 提交给我们
  	python后端：把josn格式字符串转成我们能够识别的格式：字典，对象，qs对象
		例如：前端js提供过来的json数据，对于python而言就是字符串，我们需要进行反序列化换成模型类对象，这样我们才能把数据保存到数据库中。
    
    
 # 前后端分离开发中---》站在后端开发的角度
	序列化----》read（别人读我的数据）---》出---》后端给前端
  	反序列化---》wite(别人给我数据--》存到数据库)---》进---》前端给后端

drf快速使用

# djangorestframework 的缩写，它是djagno的一个app（第三方插件），只能用在django框架上
# 可以帮助我们快速的写出符合restful规范的接口

# drf和django的版本有一定的对应关系
	-django  4.x
  -drf    版本
  -如果是django 2.2.2  drf最新可能不支持（稍微降一下drf版本）

# django 2.2.2(公司用2多)   drf 最新   
	-python 3.8 
	-django 2.2.2
  -drf :3.12.4
# 安装
# 方式一
pip3 install djangorestframework 
# 方式二：
在pycharm中点点点



# 快速使用---》以后见到的所有接口，都是这5个和变形
	-增加图书：
  -获取一本图书
  -获取所有图书
  -删除一本图书
  -修改一本图书