当前位置：首页 > news >正文

什么是 RESTful 风格？

news 2025/9/10 23:13:54

一、什么是 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 风格
资源操作	传统方式 URL	HTTP 请求方式	RESTful URL	HTTP 请求方式
获取资源（Read）	http://localhost:8080/biancheng/getUserById?id=1	GET	http://localhost:8080/biancheng/user/1	GET
保存或新增资源（Create）	http://localhost:8080/biancheng/saveUser	POST	http://localhost:8080/biancheng/user	POST
修改或更新资源（Update）	http://localhost:8080/biancheng/updateUser	POST	http://localhost:8080/biancheng/user	PUT
删除资源（Delete）	http://localhost:8080/biancheng/deleteUser?id=1	GET	http://localhost:8080/biancheng/user/1	DELETE