全国旗舰校区

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

北京

深圳

上海

广州

郑州

大连

武汉

成都

西安

杭州

青岛

重庆

长沙

哈尔滨

南京

太原

沈阳

合肥

贵阳

济南

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

如何理解RESTful API的幂等性?

发布时间:2022-08-03 11:40:00
发布人:qyf

如何理解 RESTful API 的幂等性

  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 # 获取服务器当前时间

  它本身不会对资源本身产生影响,因此满足幂等性。

  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

  调用一次和多次对资源产生影响是相同的,所以也满足幂等性。

  你是怎么理解 RESTful的?

  2000 年,Roy Thomas Fielding 博士在他那篇著名的博士论文《Architectural Styles and the Design of Network-based Software Architectures》中提出了几种软件应用的架构风格,REST 作为其中的一种架构风格,在这篇论文的第5章中进行了概括性的介绍。

  REST 是“REpresentational State Transfer”的缩写,可以翻译成“表现状态转换”,但是在绝大多数场合中我们只说 REST 或者 RESTful。Fielding 在论文中将 REST 定位为“分布式超媒体应用(Distributed Hypermedia System)”的架构风格,它在文中提到一个名为“HATEOAS(Hypermedia as the engine of application state)”的概念。

  我们利用一个面向最终用户的 Web 应用来对这个概念进行简单阐述:这里所谓的应用状态(Application State)表示 Web 应用的客户端的状态,简单起见可以理解为会话状态。资源在浏览器中以超媒体的形式呈现,通过点击超媒体中的链接可以获取其它相关的资源或者对当前资源进行相应的处理,获取的资源或者针对资源处理的响应同样以超媒体的形式再次呈现在浏览器上。由此可见,超媒体成为了驱动客户端会话状态的转换的引擎。

  借助于超媒体这种特殊的资源呈现方式,应用状态的转换体现为浏览器中呈现资源的转换。如果将超媒体进一步抽象成一般意义上的资源呈现(Representation )方式,那么应用状态变成了可被呈现的状态(REpresentational State)。应用状态之间的转换就成了可被呈现的状态装换(REpresentational State Transfer),这就是 REST。

  总结:REST 是一种很笼统的概念,它代表一种架构风格。

  更多关于“Java培训”的问题,欢迎咨询千锋教育在线名师。千锋已有十余年的培训经验,课程大纲更科学更专业,有针对零基础的就业班,有针对想提升技术的好程序员班,高品质课程助力你实现java程序员梦想。

相关文章

office是什么软件类型?

office是什么软件类型?

2023-10-14
Cloud-IDE 是什么?

Cloud-IDE 是什么?

2023-10-14
主机和端系统之间有什么不同?

主机和端系统之间有什么不同?

2023-10-14
进程和线程有什么联系和区别?

进程和线程有什么联系和区别?

2023-10-14

最新文章

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

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

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

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

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

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

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

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

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