什么是 RESTful 风格?
创始人
2024-05-26 07:01:52
0

一、什么是 REST ?

REST即表述性状态传递(英文:Representational State Transfer,简称REST)是Roy Thomas Fielding博士在2000年他的博士论文中提出来的一种软件架构风格。它是一种针对网络应用的设计和开发方式,可以降低开发的复杂性,提高系统的可伸缩性。

  • Representation(资源的表述):资源的表述指的是资源在某个特定时刻的状态的描述,即资源的具体表现形式,它可以有多种格式,例如 HTML、XML、JSON、纯文本、图片、视频、音频等等。
  • State Transfer(状态转移):资源状态转移,简单点说就是,客户端与服务端进行交互时,资源从一种表现形式转换到另一种表现形式的过程。但是 HTTP 协议是一种无状态协议,它是无法保存任何状态的,因此如果客户端想要获取服务器上的某个资源,就必须通过某种手段让资源在服务器端发生“状态转化”。

二、什么是 RESTful 风格?

1、传统方式

在传统的项目开发中,我们通常都会将操作资源的动词写进 URL 中,而这些动词通常都是我们自行定义的,并没有一个统一的规范。哪怕是对同一资源的相同操作,不同的人所定义的 URL 也是各不相同的。比如获取用户信息:

  • http://localhost:8080/getUserById?id=1
  • http://localhost:8080/user/getById?id=1
  • http://localhost:8080/findUserById?id=1

2、RESTful 风格

(1)什么是RESTful ?

REST 指的是一组架构约束条件和原则。满足这些约束条件和原则的应用程序或设计就是 RESTful。

(2)如何设计 RESTful API ?

API(应用程序编程接口)是一组规则,用于定义应用程序或设备如何相互连接和通信。 REST API 是符合 REST(表述性状态转移)架构样式设计原则的 API。 因此,REST API 有时被称为 RESTful API。

RESTful提倡我们使用统一的风格来设计 URL,其规则如下:

1. URL(对应资源

  • URL 只用来标识和定位资源,不得包含任何与操作相关的动词,只包含名词即可,而且所用的名词往往与数据库的表名对应。
    示例:http://localhost:8080/biancheng/user

  • 当请求中需要携带参数时,RESTFul 允许我们将参数通过斜杠(/)拼接到 URL 中,将其作为 URL 的一部分发送到服务器中,而不再像以前一样使用问号(?)拼接键值对的方式来携带参数。
    示例:http://localhost:8080/biancheng/user/1

2. HTTP Method(对应状态转移

  • HTTP 协议中有四个表示操作方式的动词:GET、POST、PUT 和 DELETE,它们分别对应了四种与资源相关的基本操作: GET 用来获取资源, POST 用来新建资源, PUT 用来更新资源, DELETE 用来删除资源。客户端通过这四个动词,即可实现对服务器端资源状态转移的描述。
    示例:GET、POST、PUT 和 DELETE

RESTful 将对资源的操作都定义在HTTP Method 中,使得URL地址看起来更简洁。

3、传统方式 vs RESTful 风格

资源操作传统方式RESTful 风格
传统方式 URLHTTP 请求方式RESTful URLHTTP 请求方式
获取资源(Read)http://localhost:8080/biancheng/getUserById?id=1GEThttp://localhost:8080/biancheng/user/1GET
保存或新增资源(Create)http://localhost:8080/biancheng/saveUserPOSThttp://localhost:8080/biancheng/userPOST
修改或更新资源(Update)http://localhost:8080/biancheng/updateUserPOSThttp://localhost:8080/biancheng/userPUT
删除资源(Delete)http://localhost:8080/biancheng/deleteUser?id=1GEThttp://localhost:8080/biancheng/user/1DELETE

附录

参考:RESTful(REST风格)是什么
RESTful(REST风格)是什么

参考来源

  • RESTful(REST风格)是什么
  • RESTful_百度百科
  • 什么是 REST API? - 中国 | IBM

相关内容

热门资讯

厦门市监局通报牛约堡食安问题:... 7月2日,厦门市市场监督管理局发布情况通报称,该日,媒体曝光了“牛约堡”食品安全问题,思明区和湖里区...
林振洪:“让抗战精神镌刻在年轻... 转自:北京日报客户端69岁的密云区关心下一代工作委员会副主任林振洪迎面走来,步伐有力。这次采访,他为...
韩国总统李在明称不确定能否在下...   韩国总统李在明周四表示,首尔与华盛顿能否在特朗普政府对等关税宽限期下周结束之前达成贸易协议仍不明...
抗战影像记忆丨延安!延安! 来源:新华社 1938年,武汉。一个星光暗淡的夜晚,摄影家吴印咸乘车来到汉口郊外,在一条偏僻的马路边...
国际最新研究:古DNA为揭示早... 来源:中国新闻网 中新网北京7月3日电 (记者 孙自法)国际知名学术期刊《自然》北京时间7月2日夜间...
夸克技术团队曝光  1000万... 中经记者 李立 杭州报道在互联网大厂激烈争夺的“AI高考”赛道, 阿里巴巴AI旗舰应用夸克日前公布了...
“文化小大使”交流活动:架起海... 本文转自【新华社】2025年中国宋庆龄基金会“文化小大使”交流活动暨2026年活动发布仪式7月2日在...
第1现场 | 海军山东舰航母编... 新华社消息,在香港回归祖国28周年之际,由中国人民解放军海军航空母舰山东舰,导弹驱逐舰延安舰、湛江舰...
创新药再迎重大利好:两部委发布... 7月1日,国家医保局、国家卫健委两部门联合发布《支持创新药高质量发展的若干措施》(以下简称《若干措施...
西安机场可7天免费存充电宝 逾... 【#西安机场可7天免费存充电宝# 逾期将视为自弃处理】据中国民航局通知,6月28日起,禁止旅客携带没...