多尔多 发表于 2024-2-7 18:52:53

Django知识笔记1

本文从分析现在流行的前后端分离Web应用模式说起,然后介绍如何设计REST API,通过使用Django来实现一个REST API为例,明确后端开发REST API要做的最核心工作,然后介绍Django REST framework能帮助我们简化开发REST API的工作。
Web应用模式
在开发Web应用中,有两种应用模式:
前后端不分离
前后端分离
1 前后端不分离
在前后端不分离的应用模式中,前端页面看到的效果都是由后端控制,由后端渲染页面或重定向,也就是后端需要控制前端的展示,前端与后端的耦合度很高。
这种应用模式比较适合纯网页应用,但是当后端对接App时,App可能并不需要后端返回一个HTML网页,而仅仅是数据本身,所以后端原本返回网页的接口不再适用于前端App应用,为了对接App后端还需再开发一套接口。
HTTP动词

对于资源的具体操作类型,由HTTP动词表示。
常用的HTTP动词有下面四个(括号里是对应的SQL命令)。

[*]GET(SELECT):从服务器取出资源(一项或多项)。
[*]POST(CREATE):在服务器新建一个资源。
[*]PUT(UPDATE):在服务器更新资源(客户端提供改变后的完整资源)。
[*]DELETE(DELETE):从服务器删除资源。
还有三个不常用的HTTP动词。

[*]PATCH(UPDATE):在服务器更新(更新)资源(客户端提供改变的属性)。
[*]HEAD:资源的元数据。
[*]OPTIONS:信息,关于资源的哪些属性是客户端可以改变的。
下面是一些例子。
过滤信息(Filtering)

如果记录数量很多,服务器不可能都将它们返回给用户。API应该提供参数,过滤返回结果。
下面是一些常见的参数。

?limit=10:指定返回记录的数量
?offset=10:指定返回记录的开始位置。
?page=2&per_page=100:指定第几页,以及每页的记录数。
?sortby=name&order=asc:指定返回结果按照哪个属性排序,以及排序顺序。
?animal_type_id=1:指定筛选条件参数的设计允许存在冗余,即允许API路径和URL参数偶尔有重复。比如,GET /zoos/ID/animals 与 GET
/animals?zoo_id=ID 的含义是相同的。
状态码(Status Codes)

服务器向用户返回的状态码和提示信息,常见的有以下一些(方括号中是该状态码对应的HTTP动词)。


[*]200 OK - :服务器成功返回用户请求的数据
[*]201 CREATED - :用户新建或修改数据成功。
[*]202 Accepted -
[*]:表示一个请求已经进入后台排队(异步任务)
[*]204 NO CONTENT - :用户删除数据成功。
[*]400 INVALID REQUEST - :用户发出的请求有错误,服务器没有进行新建或修改数据的操作
[*]401 Unauthorized -
[*]:表示用户没有权限(令牌、用户名、密码错误)。
[*]403 Forbidden -
[*] 表示用户得到授权(与401错误相对),但是访问是被禁止的。
[*]404 NOT FOUND -
[*]:用户发出的请求针对的是不存在的记录,服务器没有进行操作,该操作是幂等的。
[*]406 Not Acceptable - :用户请求的格式不可得(比如用户请求JSON格式,但是只有XML格式)。
[*]410 Gone -:用户请求的资源被永久删除,且不会再得到的。
[*]422 Unprocesable entity - 当创建一个对象时,发生一个验证错误。
[*]500 INTERNAL SERVER ERROR -
[*]:服务器发生错误,用户将无法判断发出的请求是否成功。
期待下期

来源:https://www.cnblogs.com/yinuo112/p/18011117
免责声明:由于采集信息均来自互联网,如果侵犯了您的权益,请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容,谢谢合作!
页: [1]
查看完整版本: Django知识笔记1