什么是 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日...
西北地区东部华北四川盆地等地多... 摘要:国内方面,昨日,云南、广西、台湾、辽宁、吉林等地出现较强降雨,南方高温天气持续。未来三天,台风...
伊朗与六国达成共识 据参考消息援引路透社7月4日报道,亚洲中西部七国领导人峰会4日达成共识,将推动贸易自由化、吸引更多外...
【企业】山东博汇工纸令包设备搬... (转自:华印纸箱彩盒)受限于现有令包装设备产能瓶颈,销售订单交付面临较大压力,需依赖人工包装作为补充...
孟姜塬村:鲜桃成熟时 开园待客...   果农脸上洋溢着丰收的喜悦,欢迎游客前来采摘。  鲜美的桃子备受游客青睐  硕大的桃子压弯了枝头 ...
280块石头铺平“穷山沟”的致...   鄂西北山区,湖北省襄阳市谷城县五山镇堰河村的一片竹林里,280块形态各异的石头铺镶其间。  “早...
退市前,两位副总裁被逮捕 作 者丨崔文静编 辑丨巫燕玲锦州港7月4日晚间公告,两位副总裁已被锦州市中级人民法院依法决定逮捕。与...
PD-1“四小龙”君实生物,五... 创新药已经走出谷底,且已经迎来阶段性的繁荣。据统计,今年4月初至今,创新药板块的累计涨幅超过了20%...
我国球团矿技术和装备的发展 钢铁冶金2025年07月03日 16:42上海随着我国钢铁行业结构调整优化的需求和绿色低碳高质量的要...
“大金砖合作”彰显更强“南方力... 来源:新新华社里约热内卢7月5日电 题:“大金砖合作”彰显更强“南方力量”新华社记者赵焱 陈威华 周...