Django REST framework

最新推荐文章于 2023-11-10 17:30:30 发布

weight_loss

最新推荐文章于 2023-11-10 17:30:30 发布

阅读量187

点赞数

分类专栏：应用总结

应用总结专栏收录该内容

9 篇文章 0 订阅

订阅专栏

Django REST framework

最近在将Python投入至实际生产中,目前主要Web研发的模式是前后端分离，之前是使用Django写API，之后通过学习了解到DRF框架,今天就将使用Django REST framework的一些感受分享一下。首先说一下在开发Web应用中的两种应用模式.

Web应用模式

1 前后端不分离

首先用户在客户端输入网址，向服务器端发送request请求，服务器端接收到请求后，后台开发工程师从服务器端获取数据，然后把前端开发写好的页面拿过来，再结合自己获取的数据通过模板渲染，最后把要呈现的页面拼凑出来，然后服务器端response响应给客户端，客户端获取到页面中源代码，源代码是包含服务器端拼接好的数据的，数据是在服务器端渲染的.

这种应用模式比较适合纯网页应用，但是当后端对接App时，App可能并不需要后端返回一个HTML网页，而仅仅是数据本身，所以后端原本返回网页的接口不再适用于前端App应用，为了对接App后端还需再开发一套接口。

2 前后端分离

前后端分离的意思是，前后端只通过 JSON 来交流，组件化、工程化不需要依赖后端去实现。在开发阶段，前后端工程师约定好数据交互接口，实现并行开发和测试；在运行阶段前后端分离模式需要对web应用进行分离部署，前后端之前使用HTTP或者其他协议进行交互请求。前后端分离架构中，后端只需要负责按照约定的数据格式向前端提供可调用的服务即可。前后端之间通过HTTP请求进行交互，前端获取到数据后，进行页面的组装和渲染最终返回给浏览器。

在前后端分离的应用模式中，前端与后端的耦合度相对较低。

在前后端分离的应用模式中，我们通常将后端开发的每个视图都称为一个接口，或者API，前端通过访问接口来对数据进行增删改查。

在前后端分离的应用模式里，API接口如何定义？

认识RESTful

对于接口的请求方式与路径，每个后端开发人员可能都有自己的定义方式，风格迥异。目前普遍被采用的是API的RESTful设计风格。

1. 域名

应该尽量将API部署在专用域名之下。如果确定API很简单，不会有进一步扩展，可以考虑放在主域名下。

2. 版本（Versioning）

应该将API的版本号放入URL。

http://www.example.com/app/1.0/foo

另一种做法是，将版本号放在HTTP头信息中，但不如放入URL方便和直观。Github采用这种做法。

因为不同的版本，可以理解成同一种资源的不同表现形式，所以应该采用同一个URL。版本号可以在HTTP请求头信息的Accept字段中进行区分

Accept: vnd.example-com.foo+json; version=1.0

3. 路径（Endpoint）

路径又称"终点"（endpoint），表示API的具体网址，每个网址代表一种资源（resource）

(1) 资源作为网址，只能有名词，不能有动词，而且所用的名词往往与数据库的表名对应。

对于一个简洁结构，你应该始终用名词。此外，利用的HTTP方法可以分离网址中的资源名称的操作。

(2) API中的名词应该使用复数。无论子资源或者所有资源。

4. HTTP动词

对于资源的具体操作类型，由HTTP动词表示。

常用的HTTP动词有下面四个（括号里是对应的SQL命令）。

GET（SELECT）：从服务器取出资源（一项或多项）。
POST（CREATE）：在服务器新建一个资源。
PUT（UPDATE）：在服务器更新资源（客户端提供改变后的完整资源）。
DELETE（DELETE）：从服务器删除资源。

还有三个不常用的HTTP动词。

PATCH（UPDATE）：在服务器更新(更新)资源（客户端提供改变的属性）。
HEAD：获取资源的元数据。
OPTIONS：获取信息，关于资源的哪些属性是客户端可以改变的。

5. 过滤信息（Filtering）

如果记录数量很多，服务器不可能都将它们返回给用户。API应该提供参数，过滤返回结果。

下面是一些常见的参数。

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