【REST详述及RESTful规范】

目录

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

"RESTful是一种软件的架构风格、设计风格，为客户端和服务端的交互提供了一组设计原则和约束条件.
若是一个架构符合REST的约束条件和原则，那么咱们将称它为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. *** "