【REST详述及RESTful规范】

"RESTful是一种软件的架构风格、设计风格，为客户端和服务端的交互提供了一组设计原则和约束条件.
如果一个架构符合REST的约束条件和原则，那么我们将称它为RESTful架构.
@

目录

• Web服务交互
• 理解REST
  • 什么是资源？
  • 什么是URI、URL？
  • 统一资源接口
  • 资源的表述
  • 状态转移
  • 小结
• RESTful规范

---

Web服务交互

　　我们在浏览器中能看到的每个网站，都是一个web服务。那么我们在提供每个web服务的时候，都需要前后端交互，前后端交互就一定有一些实现方案，我们通常叫web服务交互方案。

　　目前主流的三种web服务交互方案：
　　1. REST（Respresentational State Transfer）表述性状态转移.
　　2. SOAP（Simple Object Access Protocol） 简单的对象访问协议.
　　3. XML-RPC（XML Remote Procedure Call）基于XML的远程过程调用.

XML-RPC是通过XML将调用函数封装，并使用HTTP协议作为传送机制。
后来在新的功能不断被引入下，这个标准慢慢演变成为今日的SOAP协定。

SOAP服务则是以本身所定义的操作集，来访问网络上的资源。
SOAP也是基于XML的，但是它不只限于HTTP协议的传输，包括TCP协议，UDP协议都可以传输。

REST是Roy Thomas Fielding博士于2000年在他的博士论文里提出来的。
REST相比SOAP更加简洁，性能和开发效率也有突出的优势。

我们今天主要说一下这个REST，现在越来越多的web服务开始采用REST风格设计和实现。
例如，amazon.com提供接近REST风格的Web服务进行图书查找；雅虎提供的Web服务也是REST风格的。

---

理解REST

如果我们想要理解restful，就得先理解Representational State Transfer这个词组的意思——表征性状态转移.
所谓的表征性状态转移，其实指的就是资源，通常我们称之为资源状态转移.

什么是资源？

任何事物，只要有被引用的必要，那么它就是一个资源.

我们在浏览器中看到的文本、图片、视频等等都是资源，这些都是实实在在存在的实体.

资源可以是一个实体，也可以是抽象概念，比如：

• 锦觅的个人信息
• 火神的琉璃净火
• 锦觅跟火神的关系

在网络中，我们要引用的资源，一定要有一个标识，在Web中的唯一标识就是URI.

URI我们不常听说，我们经常用的是URL，两者的区别如下.

什么是URI、URL？

URI 统一资源标志符
URL 统一资源定位符

没错，URI是给我们的资源进行标识的，URL是描述我们的资源地址的.

比如，我们每个人都有名字和身份证，名字可能会重复，但身份证是唯一的.

那么身份证号就可以是我们的URI，标识我们每个人，也可以说是标识我们每个人的资源.
我们可以通过身份证号找到嫦娥，也可以通过下面这种方式找到她...

嫦娥的住址：某某世界->银河系->猎户臂->太阳系->月亮...
这就是我们的URL.

我们通过这两种方式都可以找到我们的资源.

其实我们的URL可以说是URI的子集，通过定位的方式实现的URI.

这便是我们的资源定位，有了资源的地址后，我们是要去访问资源的.
那么我们如何访问资源呢？如下.

统一资源接口

我们通过URL去访问到资源，我们对资源会有很多不同的操作——增删改查.

以前我们可能会为了"增加"的功能，而设计一个新的URL，然后这个URL就只负责对数据的增加，还会为了更新和删除再分别设计一个URL.

现在我们不用了，我们只需一个URL，然后根据HTTP请求方式的不同，对资源进行不同的操作，这个就是统一资源接口.

我们一定要遵循HTTP请求方式的语义，也就是说POST请求就在新增数据等...

资源的表述

资源的表述其实就是资源的展现形式，我们客户端和服务端传输的都是资源的表述，而不是资源本身.

例如文本资源可以采用html、xml、json等格式，图片可以使用PNG或JPG展现出来.

那么客户端如何知道服务端提供哪种表述形式呢?

可以通过HTTP内容协商，客户端可以通过Accept头请求一种特定格式的表述，服务端则通过Content-Type告诉客户端资源的表述形式。

这些资源的表述呈现在页面上，就是我们说的资源状态.

状态转移

我们在看页面的时候，从当前资源的表述(也可以说状态或者表现层)会跳转到其他的资源状态。

服务端通过超媒体协议告诉客户端当前状态有哪些后续状态可以进入。

这些类似"下一页"之类的链接起的就是这种推进状态的作用——指引你如何从当前状态进入下一个可能的状态。

小结

总结下来，REST风格的特点如下：

1. 在Web中，只要有被引用的必要，都叫资源.
2. 每个URI代表一个资源，独一无二的.
3. 客户端通过HTTP的方法，对服务器端资源进行操作.
4. 客户端和服务器之间，传递这种资源的某种表现层.
5. 通过超链接的指引，实现"表现层状态转移".

---

RESTful规范

面向资源编程

每个URL代表一种资源，URL中尽量不要用动词，要用名词.

根据请求方式的不同，对资源进行不同的操作

GET/POST/PUT/DELETE/PATCH

在URL中体现版本

·

在URL中体现是否是API

·

在URL中的过滤条件

比如：https:/ /www.bootcss.com/v1/mycss?page=3

尽量使用HTTPS协议

比如：https:/ /www.bootcss.com/v1/mycss

响应时设置状态码

100 信息，服务器收到请求，需要请求者继续执行操作.

200 成功，操作被成功接收并处理.

300 重定向，需要进一步的操作以完成请求.

400 客户端错误，请求包含语法错误或无法完成请求.

500 服务器错误，服务器在处理请求的过程中发生了错误.

也可以是自定义的状态码.

返回值

get 返回查看的所有或单条数据

post 返回更新的某条数据

put/patch 返回更新的某条数据

delete 返回值为空

Hypermedia API

如果遇到需要跳转的情况，请携带跳转接口的URL.

is ok.

---

"