关于RESTFUL的理解

1、什么是REST 

REST全称是Representtatinal State Transfer,中文意思是表述性状态转移。如果一个架构符合REST的约束条件和原则,我们就称它为RESTful架构。这个架构并没有什么新的技术,其实就是对现有的web标准的一个更好的总结。但是理论上REST架构风格并不是绑定在HTTP上,只不过目前HTTP是唯一与REST相关的实例。所谓的表述性状态转移,其实就是指的资源——任何事物,只要有被引用的必要,它就是一个资源。资源可以是实体(例如手机号码),也可以只是一个抽象概念(例如价值)。

资源有几个方面需要知道:资源与URI,统一资源接口,资源的表述,资源的链接,状态的转移

实际生活中什么是资源呢?比方说某用户的手机号码,某用户的个人信息这些实体信息,或者某手机号码的潜在价值也是可以被称作是资源,要是想让一个资源可以被识别,需要有一个唯一的标识,在web中这个唯一标识就是URI。URI既可以看成是资源的地址,也可以看成是资源的名称。如果某些信息没有使用URI来表示,那它就不能算是一个资源,只能算是资源的一些信息而已。URI的设计应该遵循可寻址性原则,具有自描述性,需要在形式上给人以直觉上的关联

URI的设计也是要符合相关的规则:1、使用_或-来让URI可读性更好。2、使用/来表示资源的层级关系。3、使用?用来过滤资源。4、,或;可以用来表示同级资源的关系

统一资源接口:RESTFul架构应该遵循统一接口原则,统一接口包含了一直受限的预定义的操作,不论什么样的资源,都是通过使用相同的接口进行资源的访问。接口应该使用标准的HTTP方法如GET,PUT和POST,并遵循这些方法的语义。统一资源接口要求使用标准的HTTP方法对资源进行操作,所以URI只应该来表示资源的名称,而不应该包括资源的操作。简单的说,URI不应该使用动作来描述,例如下面是一些不符合统一接口要求的URI:

GET/getUser/1

资源的表述:上面说的是通过HTTP方法可以获得资源,但是实际上,客户端获得的只是资源的表述而已。资源在外界的具体呈现,可以有多种表述(或称为表现、表示)形式,在客户端和服务端之间传送的也是资源的表述,而不是资源本身。例如文本资源可以采用html、xml、json等格式,图片可以使用PNG或JPG展现出来。资源的表述包括数据和描述数据的元数据。例如,HTTP头“Content-Type”就是这样一个元数据属性。

那么客户端怎么知道服务端提供的是那种表述形式呢?答案就是可以通过HTTP内容写上,客户端可以通过Accept头请求一种特定格式的表述,服务端则通过Content-Type高速客户端资源的表述形式。下面以github为例,请求某组织资源的json格式的表述形式;

Request

GET https://api.github.com/orgs/github HTTP/1.1

Accept:application/json

Response

HTTP/1.1 200 OK

Content-Type:application/json;charset=utf-8

{

"login":"github",

"id":1,

"url":"https://api.github.com/orgs/github",

"avatar_url":"https://github.com/images/error/octocat_happy.gif",

"name":"github",

"company":"Github",

"blog":"https://github.com/blog",

"location":"San Francisco",

"email":"octocat@github.com",

"public_repos":2,

"public_gists":1

"followers":20,

"following":0,

"html_url":"https://github.com/octocat",

"created_at":"2008-01-14T04:33:35Z",

"type":"Organization"

}

假如github也能够支持xml格式的表述格式,那么结果就是下面这样

#request

GET https://api.github.com/orgs/github HTTP/1.1

Accept:text/html

#response

HTTP/1.1 200 OK

Content-Type:text/xml;charset=utf-8

还是建议使用上面描述的内容协商的方式来区分表述格式

当服务器不支持所请求的表述格式,它应该返回一个HTTP406响应,表示拒绝处理该请求

资源的链接:就是在表述格式里面加入链接来引导客户端,增强资源的连通性。例子如下:

#Request

GET https://api.github.com/orgs/github/repos HTP/1.1

Accpet:application/json

#Response

HTTP/1.1 Status:200 OK

Link:<https://api.github.com/orgs/github/repos?page=2>;rel="next"

  <https://api.github.com/orgs/github/repos?page=3>;rel="last"

Content-Type:application/json;charset=utf-8

[{

  "id":129669,

  "owner":{

    "login":"octocat",

    "id":1,

    "avatar_url":"https://github.com/images/error/octocat_happ.gif",

    "gravatar_id":"somehexcode",

    "url":"https://api.github.com/users/octocat"

 

  }

}]

状态的转移:REST原则中的无状态通信原则,并不是说客户端应用不能有状态,而是指服务端不应该保存客户端的状态。实际上,状态应该区分应用状态和资源状态,客户端负责维护应用状态,而服务端维护资源状态。而两者之间的交互是无状态的。可以通过“会话”改变这个状态。“会话”状态不是作为资源状态保存在服务端的,而是被客户端作为应用状态进行跟踪的。客户端应用状态在服务端提供的超媒体的指引下发生变迁。服务端通过超媒体告诉客户端当前状态有哪些后续状态可进入。这些类似下一页之类的链接起的就是这种推进状态的作用-----指引你如何从当前状态进入下一个可能的状态

 

posted on 2017-04-13 17:10  黑加仑妞  阅读(148)  评论(0编辑  收藏  举报