RESTful 初识

川长思鸟来 2022-08-18 12:20 134阅读 0赞

# RESTful DOC #

## 简介 ##

REST（Representational State Transfer，简称REST）描述了一个架构样式的网络系统，比如 web 应用程序,  
在目前主流的Web服务交互方案中，REST更加简单明了，  
无论是对URL的处理还是对Payload的编码，REST都倾向于用更加简单轻量的方法设计和实现。值得注意的是REST并没有一个明确的标准，而更像是一种设计的风格。

## 原则条件 ##

REST 指的是一组架构约束条件和原则。满足这些约束条件和原则的应用程序或设计就是 RESTful。  
Web 应用程序最重要的 REST 原则是，客户端和服务器之间的交互在请求之间是无状态的。从客户端到服务器的每个请求都必须包含理解请求所必需的信息。  
在服务器端，应用程序状态和功能可以分为各种资源。资源是一个有趣的概念实体，它向客户端公开。资源的例子有：应用程序对象、数据库记录、算法等等。  
每个资源都使用 URI (Universal Resource Identifier) 得到一个唯一的地址。所有资源都共享统一的接口，以便在客户端和服务器之间传输状态。使用的是标准的 HTTP 方法，比如 GET、PUT、POST 和 DELETE。

在传统的web架构中，关注点在于方法，而在 REST 样式的架构中，关注点在于资源 —— 将使用标准方法检索并操作信息片段（使用表示的形式），也就是面向资源的。  
在 REST 样式的 Web 服务中，每个资源都有一个地址。

资源本身都是方法操作的目标，方法对所有资源都是一样的，这些方法都是HTTP协议中标准得方法：

*  GET：请求获取URI所表示的资源。
 *  DELETE：请求服务器删除URI所标识的资源。
 *  POST：请求服务器新增URI的标识的资源。
 *  PUT：请求服务器更新URL所标识的资源。
 *  PATCH：请求服务器局部更新URL所标识的资源。
 *  HEAD： 请求服务器获取URL所标识的资源响应的头信息。
 *  OPTIONS：

## URI标识资源 ##

在RESTful架构样式中，URI应该只标识为一种资源，因此URI中应该只有名词，不该有动词，传统的URI中往往出现的动词是为了标识某种动作或行为，  
而在RESTful架构样式中，而是使用HTTP的标准方法来请求标识对资源请求动作或行为。

## 举例 ##

在RESTful架构中，每一个URI标识一种资源（面向资源），资源的名称往往与数据模型（Model）是一一对应的，也就是和数据库表是一一对应的，  
因此还是只能有名词而非动词：

<table> 
 <thead> 
  <tr> 
   <th>URL</th> 
   <th align="left">URI</th> 
   <th align="left">HTTP请求方法</th> 
   <th align="left">备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>https://api.example.com/employees/11</code></td> 
   <td align="left">/employees/11</td> 
   <td align="left">GET</td> 
   <td align="left">获取id为11的employee</td> 
  </tr> 
  <tr> 
   <td><code>https://api.example.com/employees/12</code></td> 
   <td align="left">/employees/12</td> 
   <td align="left">DELETE</td> 
   <td align="left">删除id为12的employee</td> 
  </tr> 
  <tr> 
   <td><code>https://api.example.com/employees/13</code></td> 
   <td align="left">/employees/13</td> 
   <td align="left">PUT</td> 
   <td align="left">修改id为13的employee</td> 
  </tr> 
  <tr> 
   <td><code>https://api.example.com/employees</code></td> 
   <td align="left">/employees</td> 
   <td align="left">POST</td> 
   <td align="left">新增employee</td> 
  </tr> 
 </tbody> 
</table>

参数处理请参考：[http://segmentfault.com/q/1010000002444186][http_segmentfault.com_q_1010000002444186]

## 总结 ##

即使用URI来标识资源（应该是名词而非动词），而是用HTTP标准的方法来标识对资源的动作或操作。

[http_segmentfault.com_q_1010000002444186]: http://segmentfault.com/q/1010000002444186