API接口引入

最新推荐文章于 2024-10-08 12:37:10 发布

youjian42

最新推荐文章于 2024-10-08 12:37:10 发布

阅读量296

点赞数 3

分类专栏： drf学习文章标签： python django

本文链接：https://blog.csdn.net/youjian42/article/details/138076535

版权

drf学习专栏收录该内容

23 篇文章 1 订阅

订阅专栏

介绍：

在学完以上的django架构后，我们做了一个项目：BBS，这是一个前后端混合的项目。那么，什么叫前后端混合呢，我认为前后端混合就是前端和后端相结合的项目，彼此分不开。那么，我们现在就要学前后端分离了，它就是通过后端提供的API接口，来实施前后端分离。

意思就是，我们后端只需要做出一个个API接口，通过和前端进行交互。这样的好处就是允许不同的软件系统进行交互。🙋‍♀️🌰：如果说我写了一个登录用的API，我们只需要开放接口，浏览器端、客户端都可以使用接口，这大大提高了开发的效率。

API接口的组成

我们已经知道API接口的作用了，那么API接口应该是由什么组成的呢

1 url地址
2 请求方式 get post delete put 
3 请求参数
    -地址栏中的参数：127.0.0.1:8000/index?name=lqz&age=19
    -请求体：编码格式
4 响应结果：json或xml格式的数据

restful规范

当然，我们在写API接口的时候也是有规范的，规范如下：

数据的安全保障

url链接一般都采用https协议进行传输
注：采用https协议，可以提高数据交互过程中的安全性

url地址中带接口标识

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

url中带版本标识

-接口有版本
https://api.baidu.com/v1/login
https://api.baidu.com/v2/login

数据是资源，均使用名词

-以后所有接口路径中，尽量不出现动词
-接口一般都是完成前后台数据的交互，交互的数据我们称之为资源
https://api.baidu.com/v1/users
https://api.baidu.com/v1/books
https://api.baidu.com/v1/books/3

请求方式决定如何操作资源

https://api.baidu.com/books   - get请求：获取所有书
https://api.baidu.com/books/1 - get请求：获取主键为1的书
https://api.baidu.com/books   - post请求：新增一本书
https://api.baidu.com/books/1 - put请求：整体修改主键为1的书
https://api.baidu.com/books/1 - delete请求：删除主键为1的书

url中带搜索条件

https://api.example.com/v1/goods?name=鸡公煲：指定返回搜索的数据

响应中带状态码

-http响应状态码
        	-1xx ：请求正在处理 --》客户端看不到
            -2xx ：正常响应---》经常看到  200：请求成功  201：创建成功
            -3xx ：重定向---》偶尔看到  301 和 302
            -4xx ：客户端异常---》403：   404 
            -5xx： 服务端错误  500
        -http状态码有非常多，暂时先不用记，后面再说：
        https://www.sohu.com/a/278045231_120014184
		
        -自定制状态码
        	-mysql--》连接连不上--》有个数字：错误码  有个错误描述
            -自己定制：
            	1000
                0
                1
                1001

响应中带信息描述

-message
-msg
{code:1000,msg:成功}

针对不同操作符合以下规范

GET /collection：返回资源对象的列表（数组） 
    {code:100,msg:成功，results:[{},{},{}]}

GET /collection/resource：返回单个资源对象
    {code:100,msg:成功，result:{}}

POST /collection：返回新生成的资源对象

PUT /collection/resource：返回完整的资源对象

DELETE /collection/resource：返回一个空文档 
{code:100,msg:删除成功}

返回数据中带链接

序列化与反序列化

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

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

python后端：把python的对象【字典，列表，对象】---》转成json/xml格式字符串过程称之为序列化

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

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

例如：前端js提供过来的json/xml数据，对于python而言就是字符串，我们需要进行反序列化换成模型类对象，这样我们才能把数据保存到数据库中

js 如何把对象序列化成字符串：【JSON.stringify()】，把字符串饭序列化成对象：【JSON.parse()】

CBV源码分析

# 1 在路由中：path('index/',IndexView.as_view())

# 2 请求来了---》路由匹配成功--》执行 IndexView.as_view()(request)
	-看View类的as_view的返回结果[可以加括号执行]---》猜：函数内存地址
    
# 3 View类的as_view
    def as_view(cls, **initkwargs):
        def view(request, *args, **kwargs):
            self = cls(**initkwargs) # cls--》IndexView
            return self.dispatch(request, *args, **kwargs)
        return view
# 4 IndexView.as_view() 本质就是 --》view--》内存函数view

# 5 IndexView.as_view()(request)---》view(request)
# 6 本质 执行 self.dispatch--》self 是对象--》谁的对象？视图类的对象IndexView类的对象
	return self.dispatch(request, *args, **kwargs)

# 7 IndexView没有dispatch--》View类中的dispatch
	# request 当次请求的requets
    def dispatch(self, request, *args, **kwargs):
        #1 取出请求方式，转成小写，判断在不在列表中  get请求在
        #2 self.http_method_names 
        if request.method.lower() in self.http_method_names:
            # 3 反射：去 self IndexView类的对象中通过字符串get找属性或方法
            # 找到了get方法，赋值给了handler
            handler = getattr(self, request.method.lower())
        else:
            handler = self.http_method_not_allowed
            # 4 执行handler--》本质是get(request)
            # 执行了IndexView类中的get方法--》把request传进去了
        return handler(request, *args, **kwargs)
    
  

# 8 总结：
	路由匹配成功---》会根据请求方式执行视图类中跟请求方式同名的方法