如何理解 RESTful 的幂等性
来源:http://blog.720ui.com/2016/restful_idempotent/
理解RESTful的幂等性,并且设计符合幂等规范的高质量RESTful API。
怎么理解幂等性
HTTP幂等方法,是指无论调用多少次都不会有不同结果的 HTTP 方法。不管你调用一次,还是调用一百次,一千次,结果都是相同的。
还是以之前的博文的例子为例。
GET /tickets # 获取ticket列表GET /tickets/12 # 查看某个具体的ticketPOST /tickets # 新建一个ticketPUT /tickets/12 # 更新ticket 12PATCH /tickets/12 # 更新ticket 12DELETE /tickets/12 # 删除ticekt 12
HTTP GET方法
HTTP GET方法,用于获取资源,不管调用多少次接口,结果都不会改变,所以是幂等的。
GET /tickets # 获取ticket列表GET /tickets/12 # 查看某个具体的ticket
只是查询数据,不会影响到资源的变化,因此我们认为它幂等。
值得注意,幂等性指的是作用于结果而非资源本身。怎么理解呢?例如,这个HTTP GET方法可能会每次得到不同的返回内容,但并不影响资源。
可能你会问有这种情况么?当然有咯。例如,我们有一个接口获取当前时间,我们就应该设计成
GET /service_time # 获取服务器当前时间
它本身不会对资源本身产生影响,因此满足幂等性。
HTTP POST方法
HTTP POST方法是一个非幂等方法,因为调用多次,都将产生新的资源。
POST /tickets # 新建一个ticket
因为它会对资源本身产生影响,每次调用都会有新的资源产生,因此不满足幂等性。
HTTP PUT方法
HTTP PUT方法是不是幂等的呢?我们来看下
PUT /tickets/12 # 更新ticket 12
因为它直接把实体部分的数据替换到服务器的资源,我们多次调用它,只会产生一次影响,但是有相同结果的 HTTP 方法,所以满足幂等性。
HTTP PATCH方法
HTTP PATCH方法是非幂等的。HTTP POST方法和HTTP PUT方法可能比较好理解,但是HTTP PATCH方法只是更新部分资源,怎么是非幂等的呢?
因为,PATCH提供的实体则需要根据程序或其它协议的定义,解析后在服务器上执行,以此来修改服务器上的资源。换句话说,PATCH请求是会执行某个程序的,如果重复提交,程序可能执行多次,对服务器上的资源就可能造成额外的影响,这就可以解释它为什么是非幂等的了。
可能你还不能理解这点。我们举个例子
PATCH /tickets/12 # 更新ticket 12
此时,我们服务端对方法的处理是,当调用一次方法,更新部分字段,将这条ticket记录的操作记录加一,这次,每次调用的资源是不是变了呢,所以它是有可能是非幂等的操作。
HTTP DELETE方法
HTTP DELETE方法用于删除资源,会将资源删除。
DELETE /tickets/12 # 删除ticekt 12
调用一次和多次对资源产生影响是相同的,所以也满足幂等性。
如何设计符合幂等性的高质量RESTful API
HTTP GET方法 vs HTTP POST方法
也许,你会想起一个面试题。HTTP请求的GET与POST方式有什么区别?你可能会回答到:GET方式通过URL提交数据,数据在URL中可以看到;POST方式,数据放置在HTML HEADER内提交。但是,我们现在从RESTful的资源角度来看待问题,HTTP GET方法是幂等的,所以它适合作为查询操作,HTTP POST方法是非幂等的,所以用来表示新增操作。
但是,也有例外,我们有的时候可能需要把查询方法改造成HTTP POST方法。比如,超长(1k)的GET URL使用POST方法来替代,因为GET受到URL长度的限制。虽然,它不符合幂等性,但是它是一种折中的方案。
HTTP POST方法 vs HTTP PUT方法
对于HTTP POST方法和TTP PUT方法,我们一般的理解是POST表示创建资源,PUT表示更新资源。当然,这个是正确的理解。
但是,实际上,两个方法都用于创建资源,更为本质的差别是在幂等性。HTTP POST方法是非幂等,所以用来表示创建资源,HTTP PUT方法是幂等的,因此表示更新资源更加贴切。
HTTP PUT方法 vs HTTP PATCH方法
此时,你看会有另外一个问题。HTTP PUT方法和HTTP PATCH方法,都是用来表述更新资源,它们之间有什么区别呢?我们一般的理解是PUT表示更新全部资源,PATCH表示更新部分资源。首先,这个是我们遵守的第一准则。根据上面的描述,PATCH方法是非幂等的,因此我们在设计我们服务端的RESTful API的时候,也需要考虑。如果,我们想要明确的告诉调用者我们的资源是幂等的,我的设计更倾向于使用 HTTP PUT 方法。
特别推荐一个分享架构+算法的优质内容,还没关注的小伙伴,可以长按关注一下:
长按订阅更多精彩▼如有收获,点个在看,诚挚感谢
如何理解 RESTful 的幂等性相关推荐
- 如何理解RESTful的幂等性
理解RESTful的幂等性,并且设计符合幂等规范的高质量RESTful API. 怎么理解幂等性 HTTP幂等方法,是指无论调用多少次都不会有不同结果的 HTTP 方法.不管你调用一次,还是调用一百次 ...
- [转] 理解RESTful架构
FROM:http://www.ruanyifeng.com/blog/2011/09/restful.html 越来越多的人开始意识到,网站即软件,而且是一种新型的软件. 这种"互联网软件 ...
- 理解RESTful架构
越来越多的人开始意识到,网站即软件,而且是一种新型的软件. 这种"互联网软件"采用客户端/服务器模式,建立在分布式体系上,通过互联网通信,具有高延时(high latency).高 ...
- 我是如何根据豆瓣api来理解Restful API设计的
1.什么是REST REST全称是Representational State Transfer,表述状态转移的意思.它是在Roy Fielding博士论文首次提出.REST本身没有创造新的技术.组件 ...
- [转载] 理解RESTful架构
原文: http://www.ruanyifeng.com/blog/2011/09/restful.html 理解RESTful架构 作者: 阮一峰 日期: 2011年9月12日 越来越多的人开始意 ...
- 理解RESTful架构【转】
越来越多的人开始意识到,网站即软件,而且是一种新型的软件. 这种"互联网软件"采用客户端/服务器模式,建立在分布式体系上,通过互联网通信,具有高延时(high latency).高 ...
- 转: 理解RESTful架构
转自: http://www.ruanyifeng.com/blog/2011/09/restful.html 作者: 阮一峰 日期: 2011年9月12日 越来越多的人开始意识到,网站即软件,而且是 ...
- 理解 RESTful
风格 ⇒ 标准 ⇒ 协议 ⇒ 实现 Representational State Transfer,是一种软件架构风格,既然是风格,就非标准或协议,而是定义了一组设计原则和约束条件.具有如下特点: 适 ...
- 理解restful协议
原文 越来越多的人开始意识到,网站即软件,而且是一种新型的软件. 这种"互联网软件"采用客户端/服务器模式,建立在分布式体系上,通过互联网通信,具有高延时(high latency ...
最新文章
- mybatis查询如何返回ListMap类型数据
- request.getAttribute()和 request.getParameter()有何区别?
- Markdown中常用的转义字符
- Python中字典对象实现原理
- 春春幼儿园堆积木大赛_春云边车
- 10 条真心有趣的 Linux 命令
- 线性插值改变图像尺寸_图像分割--gt;上采样的那些事
- 手机模板区块(HTML、CSS)
- qt 不允许 dllimport 静态数据成员 的定义_C++类和对象的定义
- Windows系统字体和系统应用字体
- 二级路由添加网络打印机的方法
- 蓝桥杯试题 基础练习 十六进制转八进制
- 《问佛》——仓央嘉措
- 编译orge1.7.0
- 和数研究院4周年庆,初心不改,笃行致远!
- Elastix2.4安装、中继、 呼出、呼入、IVR等设置、忘记密码、端口映射
- kaggle phone verify 收不到手机验证码(2021.06亲测可行)
- 典型的多层神经网络模型,神经网络多传感器融合
- 【IoT】从马斯克造火箭到产品开发,快速失败很重要
- Alpha、Beta、RC、GA等版本的区别
热门文章
- Linux 中 rsync 备份数据使用实例
- .ne中的控制器循环出来的数据如何显示在视图上_Web程序设计-ASP.NET MVC4数据库操作实例...
- 通过Sequentail网络容器创建LeNet-5
- Educational Codeforces Round 114 (Rated for Div. 2) (A ~ F)全题解
- 解题报告:AcWing 1165. 单词环(01分数规划、hash、经验优化)
- 蓝桥杯-本质上升序列-java
- 动态加载子节点_微信小游戏开发之场景切换和常驻节点传递数据
- 不存在从void转换到sqlist的适当构造函数_拷贝构造函数与赋值构造函数
- java里面有控制器吗_java怎么运行控制器里的类 java控制台输入类以及
- 【Spark Summit East 2017】Spark SQL:Tungsten之后另一个可以达到16倍速度的利器