全国旗舰校区

不同学习城市 同样授课品质

北京

深圳

上海

广州

郑州

大连

武汉

成都

西安

杭州

青岛

重庆

长沙

哈尔滨

南京

太原

沈阳

合肥

贵阳

济南

下一个校区
就在你家门口
+
当前位置:首页  >  技术干货

如何理解RESTful API的幂等性?

发布时间:2022-09-22 15:24:29
发布人:wjy

  1. 什么是幂等性?

  HTTP 幂等方法,是指无论调用多少次都不会有不同结果的HTTP方法。不管你调用一次,还是调用一百次,一千次,结果都是相同的。 GET /tickets # 获取ticket列表 GET /tickets/12 # 查看某个具体的ticket POST /tickets # 新建一个ticket PUT /tickets/12 # 更新ticket 12 PATCH /tickets/12 # 更新ticket 12 DELETE /tickets/12 # 删除ticekt 12

  2. HTTP GET方法HTTP GET方法,用于获取资源,不管调用多少次接口,结果都不会改变,所以是幂等的。 GET /tickets # 获取ticket列表 GET /tickets/12 # 查看某个具体的ticket 只是查询数据,不会影响到资源的变化,因此我们认为它幂等。值得注意,幂等性指的是作用于结果而非资源本身。怎么理解呢?

  例如,这个HTTP GET方法可能会每次得到不同的返回内容,但并不影响资源。 可能你会问有这种情况么?当然有咯。

  例如,我们有一个接口获取当前时间,我们就应该设计成 GET /service_time # 获取服务器当前时间 它本身不会对资源本身产生影响,因此满足幂等性。

如何理解RESTful API的幂等性?

  3. HTTP POST方法HTTP POST方法是一个非幂等方法,因为调用多次,都将产生新的资源。 POST /tickets # 新建一个ticket因为它会对资源本身产生影响,每次调用都会有新的资源产生,因此不满足幂等性。

  4. HTTP PUT方法HTTP PUT方法是不是幂等的呢?

  我们来看下 PUT /tickets/12 # 更新ticket 12 因为它直接把实体部分的数据替换到服务器的资源,我们多次调用它,只会产生一次影响,但是有相同结果的 HTTP 方法,所以满足幂等性。

  5. HTTP PATCH方法HTTP PATCH方法是非幂等的。HTTP POST方法和HTTP PUT方法可能比较好理解,但是HTTP PATCH方法只是更新部分资源,怎么是非幂等的呢?

  因为,PATCH提供的实体则需要根据程序或其它协议的定义,解析后在服务器上执行,以此来修改服务器上的资源。换句话说,PATCH请求是会执行某个程序的,如果重复提交,程序可能执行多次,对服务器上的资源就可能造成额外的影响,这就可以解释它为什么是非幂等的了。 可能你还不能理解这点。我们举个例子PATCH /tickets/12 # 更新ticket 12 此时,我们服务端对方法的处理是,当调用一次方法,更新部分字段,将这条ticket记录的操作记录加一,这次,每次调用的资源是不是变了呢,所以它是有可能是非幂等的操作。

  6. HTTP DELETE方法HTTP DELETE方法用于删除资源,会将资源删除。 DELETE /tickets/12 # 删除ticekt 12 调用一次和多次对资源产生影响是相同的,所以也满足幂等性。

相关文章

图卷积网络和self-attention有什么区别?

图卷积网络和self-attention有什么区别?

2023-10-15
深度学习模型权重h5、weights、ckpt、pth有什么区别?

深度学习模型权重h5、weights、ckpt、pth有什么区别?

2023-10-15
机器学习中Inference和predict的区别是什么?

机器学习中Inference和predict的区别是什么?

2023-10-15
kd-tree和ball-tree在算法实现原理上有什么区别?

kd-tree和ball-tree在算法实现原理上有什么区别?

2023-10-15

最新文章

常见网络安全面试题:Windows常用的命令有哪些?

常见网络安全面试题:Windows常用的命令有哪些?

2023-10-09
常见网络安全面试题:根据设备告警如何展开排查?

常见网络安全面试题:根据设备告警如何展开排查?

2023-10-09
常见网络安全面试题:mysql加固呢?(数据库加固)

常见网络安全面试题:mysql加固呢?(数据库加固)

2023-10-09
常见网络安全面试题:windows和linux加固?(操作系统加固)

常见网络安全面试题:windows和linux加固?(操作系统加固)

2023-10-09
在线咨询 免费试学 教程领取