restful 表述性状态转移

Representational State Transfer，简称REST，表述性状态转移

一种软件架构风格，不是标准

1.简介，rest使用http协议

表述性状态转移是一组架构约束条件和原则。满足这些约束条件和原则的应用程序或设计就是RESTful。需要注意的是，REST是设计风格而不是标准。REST通常基于使用HTTP，URI，资源标识符就是URI(Uniform Resource Identifier)，和XML(标准通用标记语言下的一个子集)以及HTML(标准通用标记语言下的一个应用)这些现有的广泛流行的协议和标准。

REST本身并没有创造新的技术、组件或服务，而隐藏在RESTful背后的理念就是使用Web的现有特征和能力， 更好地使用现有Web标准中的一些准则和约束。虽然REST本身受Web技术的影响很深， 但是理论上REST架构风格并不是绑定在HTTP上，只不过目前HTTP是唯一与REST相关的实例。 所以我们这里描述的REST也是通过HTTP实现的REST。

class Resource { Resource(URI u); Response get(); Response post(Request r); Response put(Request r); Response delete(); }

2. 要理解RESTful架构，需要理解Representational State Transfer这个词组到底是什么意思，它的每一个词都有些什么涵义。

下面我们结合REST原则，围绕资源展开讨论，从资源的定义、获取、表述、关联、状态变迁等角度，列举一些关键概念并加以解释。

资源与URI 统一资源接口 资源的表述 资源的链接 状态的转移

2. 1 资源与URI

资源：

只要被引用，那就可以叫做资源，不管是json，字符串，图片，Word还是视频文件，也不管你是XML(标准通用标记语言下的一个子集)格式、txt文件格式还是其它文件格式。 例如人的名字，性别，电话号码，酒窖的name，ID ，酒窖和酒位的关系啊等都是资源

URI 资源是要被调用的，那这些资源肯定要有一个表示，而且必须唯一，这个表示可以是一个资源的路径也可以是资源的名称，如果信息没有被URI标记，那就不能算是真正的资源，因为你不能调用 例如：github上面的每个项目的ssh或者是http资源路径，他们都是唯一的

URI的设计： 1. 使用/表示资源的层级关系 api/admin/cellar/:id 2. 使用？进行过滤资源 /git/git/pulls?state=closed 用来表示git项目中已经关闭的推入请求 3. 用.或者；表示同级资源

2.2 统一资源接口

不论什么资源，都应该使用相同的接口进行资源的访问，接口应该使用标准的http方法，如get post 等，并遵循这些方法的语义。 例如：name的操作，接口都应该统一，URI中只应该包含资源的名称 GET/admin/name POST/admin/name PUT/admin/name DELETE/admin/name 全部通过 URI对资源进行唯一的标识。URL是一种具体的URI，它不仅唯一标识资源，而且还提供了定位该资源的信息。 GET 安全且幂等 获取表示 变更时获取表示（缓存） 200（OK） - 表示已在响应中发出 204（无内容） - 资源有空表示 301（Moved Permanently） - 资源的URI已被更新 303（See Other） - 其他（如，负载均衡） 304（not modified）- 资源未更改（缓存） 400 （bad request）- 指代坏请求（如，参数错误） 404 （not found）- 资源不存在 406 （not acceptable）- 服务端不支持所需表示 500 （internal server error）- 通用错误响应 503 （Service Unavailable）- 服务端当前无法处理请求

2.3资源的表述

上面提到，客户端可以通过http的方法获取资源，具体来说，应该是资源的表述，是资源在外界的具体呈现，例如123.img这个表述就是对一个图片资源的表述，

我感觉，REST除了给我们带来了一个崭新的架构以外，还有一个重要的贡献是在开发系统过程中的一种新的思维方式:通过url来设计系统的结构。根据REST，每个url都代表一个resource，而整个系统就是由这些resource组成的。因此，如果url是设计良好的，那么系统的结构就也应该是设计良好的

.factory('Cellars', ['$resource', '$http', '$window','Settings', function ($resource, $http, Settings) { var Server = Settings.httpServer; return $resource('api/admin/cellar/:id', { id: '@cellarid' }, { }) }])

OK，既然url有这样的好处，那我们就着重讨论一下如何设计url。网络应用通常都是有hierarchy的，像棵大树。我们通常希望url也能反映出资源的层次性。比如对于一个藏酒资源应用:/api/admin/表示进入管理者权限，/cellar/:id表示id为N的酒窖，这都比较直观。

angular.module('starter.iotservices', []) .factory('Cellars', ['$resource', '$http', '$window','Settings', function ($resource, $http, Settings) { var Server = Settings.httpServer; return $resource('api/admin/cellar/:id', { id: '@cellarid' }, { }) }]) .factory('Areas', ['$resource', '$http', '$window', 'Settings', function ($resource, $http, Settings) { var Server = Settings.httpServer; return $resource('api/admin/area?name=:name', { name: '@cellarname' }, { }); }])

2.4 状态转移

应用状态和资源状态

客户端就是应用，服务器数据库就是资源 客户端的应用发送实际请求，这时候应用状态改变，服务器接收到这个请求，服务器中资源状态改变。