Restful :

web服务交互:

  我们在浏览器中能看到的每个网站, 都是一个web服务. 那么我们在提供每个web服务的时候, 都需要前后端交互. 前后端交互就一定有一些实现方案, 我们通常叫web服务交互方案.

  目前主流的三种web服务交互方案:

    REST(Representational State Transfer) 表述性状态转移

    SOAP(Simple Object Access Protocol) 简单的对象访问协议

    XML-RPC(XML Remote Procedure Call) 基于XML的远程过程调用

  XML-RPC是通过XML将调用函数封装, 并使用HTTP协议作为传送机制.

  后来在新的功能不断被引入下, 这个标准慢慢演变后才能为今日的SOAP协定.

  SOAP服务则是以本身所定的操作集, 来访问网络上的资源.

  SOAP也是基于XML的,但是它不只限于HTTP协议的传输,包括TCP协议,UDP协议都可以传输。

  REST是Roy Thomas Fielding博士于2000年在他的博士论文里提出来的。

  REST相比SOAP更加简洁,性能和开发效率也有突出的优势。

  我们今天主要说一下这个REST,现在越来越多的web服务开始采用REST风格设计和实现。

  例如,amazon.com提供接近REST风格的Web服务进行图书查找;雅虎提供的Web服务也是REST风格的。

  我们接下来要学的框架也是遵循REST风格的,那么我们来看下它到底是个什么样的风格,

  了解了它是什么后,我们看下它的优点是什么,我们为什么用它。


理解REST :

如果我们想要理解restful, 就要理解Representational State Transfer这个词组的意思: 表征性状态转移.

所谓的表征性, 其实指的就是资源. 通常称为资源状态转移.

什么是资源:

  任何事物, 只要有被引用的必要, 它就是一个资源.

  我们在浏览器中看到的文本, 视频, 图片等都是资源. 这些都是实实在在存在的实体.

  资源可以是一个实体, 也可以是抽象概念.

  比如说:

    某个人的个人信息

    某个人的手机号

    某个人和另外一个人的潜在关系.

  在网络中, 我们要引用资源, 资源一定要有一个标识, 在web中的唯一标识就是URI.

什么是URI, URL:

  URI 统一资源标识符

  URL 统一资源定位符

  URI是给我们的资源进行标识的, URL是描述我们资源地址的.

  比如每个人都有名字和身份证, 名字可以重复, 但是身份证号是唯一的.

  那么身份证号就相当于我们的URI, 标识我们每一个人, 也可以说标识我们每一个资源.

  我们可以通过身份证号确定一个人, 但是想要找到这个人的具体位置就要通过具体的定位方式.

  这个就是我们的URL, 我们通过这两种方式都可以找到我们的资源,

  其实URL可以说是URI的子集, 通过定位的方式实现的URI.

统一资源接口:

  现在我们可以通过URL去访问到资源, 那么我们队资源会有很多不同的操作, 增删查改

  以前我们可能会为了这个增加一个URL, 然后这个URL就是对数据进行增加的,

  还会为了更新和删除分别设计一个URL, 现在不需要了, 只有一个URL,

  然后根据HTTP请求方式的不同, 对资源进行不同的操作, 这个就是统一资源接口.

资源的表述:

  资源的表述其实就是资源的展现形式, 我们客户端和服务端传输的都是资源的表述, 而不是资源本身.

  例如文本资源可以采用html, xml, json等格式, 图片可以使用PNG或JPG展现出来.

  那么客户端是怎么知道服务端提供哪种表述形式的呢?

  可以通过HTTP内容协商, 客户端可以通过Accept头请求一种特定格式的表述, 服务端通过Content-Type告诉客户端资源的表述形式.

  这些资源的表述呈现在页面上, 就是我们说的资源状态.

状态转移:

  我们在看页面的时候,从当前资源的表述(也可以说状态或者表现层)会跳转到其他的资源状态。

  服务端通过超媒体告诉客户端当前状态有哪些后续状态可以进入。

  这些类似"下一页"之类的链接起的就是这种推进状态的作用——指引你如何从当前状态进入下一个可能的状态。

总结:

  可以得知REST风格的特点如下:

  (1)在web中,只要有被引用的必要都叫资源。

  (2)每个URI代表一个资源,独一无二的。

  (3)客户端通过HTTP的方法,对服务器端资源进行操作;

  (4)客户端和服务器之间,传递这种资源的某种表现层;

  (5)通过超链接的指引,实现"表现层状态转移"。


 

RESTful :

如果一个架构符合REST的约束条件和原则, 我们就称它为RESTful架构.

一种软件的架构风格, 设计风格, 为客户端和服务端的交互提供一组设计原则和约束条件.


restful规范 :

1. 面向资源编程:

  每一URL代表一种资源, URL中尽量不要用动词, 多用名词

2. 根据method不同, 进行不同的操作:

  GET/POST/PUT/DELETE/PATCH

3. 在URL中体现版本:

  https://www.bootcss.com/v1/mycss

  https://v1.bootcss.com/mycss

4. 在URL中体现是否是API:

  https://www.bootcss.com/api/mycss

  https://api.bootcss.com/mycss

5. 在URL中guolv条件

  https://www.bootcss.com/v1/mycss?page=3

6. 尽量使用HTTPS:

  https://www.bootcss.com/v1/mycss

7. 响应时设置状态码:

  1. 信息, 服务器收到请求, 需要请求者继续执行操作

  2. 成功, 操作被成功接收并处理

  3. 重定向, 需要进一步的操作以完成请求

  4. 客户端错误, 请求包含语法错误或无法完成请求

  5. 服务器错误, 服务器在处理请求的过程中发生了错误

8. 返回值:

  GET请求: 返回查到所有或单条数据

  POST请求: 返回新增的数据

  PUT请求: 返回更新的数据

  PATCH请求: 局部更新, 返回更新的整条数据

  DELETE请求: 返回值为空

9. 返回错误信息:

  返回值携带错误信息

10. Hypermedia API

  如果遇到需要跳转的情况 携带跳转接口的URL

ret = {
code: 1000,
data:{
id:1,
name:'小强',
depart_id:http://www.baidu.com/api/v1/depart/8/
}
}

转载于:https://www.cnblogs.com/dong-/p/9966477.html

Django RESTful规范相关推荐

  1. Django框架深入了解_01(Django请求生命周期、开发模式、cbv源码分析、restful规范、跨域、drf的安装及源码初识)

    阅读目录 一.Django请求生命周期: 二.WEB开发模式: 三.cbv源码分析: 四.认识RESTful 补充知识:跨域 五.基于原生django开发restful的接口 六.drf安装.使用.A ...

  2. Django之 RESTful规范

    RESTful 规范 一.什么是RESTful REST与技术无关,代表的是一种软件架构风格,REST是Representational State Transfer的简称,中文翻译为"表征 ...

  3. django restful 请求_利用 Django REST framework 构建 RESTful Web API

    利用 Django REST framework 构建 RESTful Web API 终于到了动手操作的环节啦,这一节,我们以师生管理系统为例,带领大家搭建一套 framework Web API. ...

  4. restful规范和APIView

    django生命周期 1.先进入wsgi协议的web服务器2.进入django的中间件3.路由4.视图5.取模板,取数据,用数据渲染模板6.返回模板的字符串7.在wsgi中封装后发送给浏览器 开发模式 ...

  5. 【接口文档】Django restful framework中自动生成API文档

    Django restful framework中自动生成API文档 一.Swagger概述 1.引言 当接口开发完成,紧接着需要编写接口文档.传统的接口文档使用Word编写,or一些接口文档管理平台 ...

  6. Drf从入门到精通一(API接口、Postman、Restful规范、序列化、快速使用drf、CBV源码分析)

    文章目录 一.前后端开发模式 二.API接口 三.接口测试工具Postman 四.Restful规范 五.序列化反序列化 六.DjangoRestFramework快速使用 七.CBV源码分析 一.前 ...

  7. REST-Framework: RESTful规范

    目录 一 什么是RESTful 二  RESTful API设计 三 基于原生的Django实现 一 什么是RESTful REST与技术无关,代表的是一种软件架构风格,REST是Representa ...

  8. 在django restful framework中设置django model的property

    众所周知,在django的model中,可以某些字段设置@property和setter deleter getter,这样就可以在存入数据的时候进行一些操作,具体原理请参见廖雪峰大神的博客https ...

  9. django restful 请求_Django编写RESTful API(二):请求和响应

    前言 在上一篇文章,已经实现了访问指定URL就返回了指定的数据,这也体现了RESTful API的一个理念,每个URL表明着一个资源.固然咱们还知道RESTful API的另外一个特性就是,发送不一样 ...

最新文章

  1. 破一个行业ERP的感想
  2. Theano - 循环
  3. 隐藏esp_?吉利帝豪GL到店实拍,7.78万起,配鹰眼LED大灯+ESP,家用首选
  4. 湘潭大学计算机学院调剂,湘潭大学2018年硕士研究生调剂信息公告
  5. android 获取图片主色调
  6. P1616 疯狂的采药(洛谷,动态规划递推,完全背包)
  7. ocx控件 postmessage消息会消失_APP控件之二——弹框
  8. 金属,塑料,傻傻分不清楚
  9. 微信小程序怎么绑定服务器,微信小程序页面表单如何跟图片一起上传服务器
  10. Linux内核网络协议栈3-创建socket(1)
  11. python购物信息整合教程_python实现简单购物商城
  12. source insight 使用技巧
  13. win7 做服务器开网站,win7下创建Web服务器
  14. C/C++[PAT B1009]说反话
  15. matlab求t分布的p值,在R中如何求给定分布和统计量的p-value
  16. matlab描点连线及坐标轴里外颜色改变
  17. 图像处理基础操作一(几何变换、平滑处理、形态学操作)
  18. C++ 中的线程库和 lamber 表达式
  19. matlab 平面旋转,请问划分网格时所谓“网格平面旋转”是什么意思?
  20. 再来看一下培根的<论读书>吧!

热门文章

  1. pythonxml格式化_使用Python生成XML的方法实例
  2. CCF CSP202012-2期末预测之最佳阈值
  3. 删除桌面图标的小箭头
  4. 买了社保,再买农村医保是不是多余?
  5. 请问!退休年龄到了,社保没交够,现在职,公司还可以继续交吗?
  6. 二婚不领证吃亏的是谁?
  7. 毕业十年,你的收入是怎样的?
  8. 古代的酒到底多少度,为何古人动不动喝好几坛都不会醉呢?
  9. 选什么专业?找什么样的工作?教你四个维度
  10. 32位和64位操作系统,二者有何区别?是否64位更快?