理解RESTful

1 何为RESTful

　　RESTful架构，就是目前最流行的一种互联网软件架构。它结构清晰、符合标准、易于理解、扩展方便，因此正获得愈来愈多网站的采用。REST这个词，是Roy Thomas Fielding在他2000年的博士论文中提出的。REST 是Representational State Transfer的缩写，翻译是”表现层状态转化”。 能够总结为一句话：REST是全部Web应用都应该遵照的架构设计指导原则。面向资源是REST最明显的特征，对于同一个资源的一组不一样的操做。资源是服务器上一个可命名的抽象概念，资源是以名词为核心来组织的，首先关注的是名词。REST要求，必须经过统一的接口来对资源执行各类操做。对于每一个资源只能执行一组有限的操做。

 

2 接口规范

 

　　7个HTTP方法： GET/POST/PUT/DELETE/PATCH/HEAD/OPTIONS

　　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）- 服务端当前没法处理请求

 

　　POST

　　　　不安全且不幂等

　　　　使用服务端管理的（自动产生）的实例号建立资源

　　　　建立子资源

　　　　部分更新资源

　　　　若是没有被修改，则不过更新资源（乐观锁）

 

　　　　200（OK）- 若是现有资源已被更改

　　　　201（created）- 若是新资源被建立

　　　　202（accepted）- 已接受处理请求但还没有完成（异步处理）

　　　　301（Moved Permanently）- 资源的URI被更新

　　　　303（See Other）- 其余（如，负载均衡）

　　　　400（bad request）- 指代坏请求

　　　　404 （not found）- 资源不存在

　　　　406 （not acceptable）- 服务端不支持所需表示

　　　　409 （conflict）- 通用冲突

　　　　412 （Precondition Failed）- 前置条件失败（如执行条件更新时的冲突）

　　　　415 （unsupported media type）- 接受到的表示不受支持

　　　　500 （internal server error）- 通用错误响应

　　　　503 （Service Unavailable）- 服务当前没法处理请求

 

　　PUT

　　　　不安全但幂等

　　　　用客户端管理的实例号建立一个资源

　　　　经过替换的方式更新资源

　　　　若是未被修改，则更新资源（乐观锁）

 

　　　　200 （OK）- 若是已存在资源被更改

　　　　201 （created）- 若是新资源被建立

　　　　301（Moved Permanently）- 资源的URI已更改

　　　　303 （See Other）- 其余（如，负载均衡）

　　　　400 （bad request）- 指代坏请求

　　　　404 （not found）- 资源不存在

　　　　406 （not acceptable）- 服务端不支持所需表示

　　　　409 （conflict）- 通用冲突

　　　　412 （Precondition Failed）- 前置条件失败（如执行条件更新时的冲突）

　　　　415 （unsupported media type）- 接受到的表示不受支持

　　　　500 （internal server error）- 通用错误响应

　　　　503 （Service Unavailable）- 服务当前没法处理请求

 

　　DELETE

　　　　不安全但幂等

　　　　删除资源

 

　　　　200 （OK）- 资源已被删除

　　　　301 （Moved Permanently）- 资源的URI已更改

　　　　303 （See Other）- 其余，如负载均衡

　　　　400 （bad request）- 指代坏请求

　　　　404 （not found）- 资源不存在

　　　　409 （conflict）- 通用冲突

　　　　500 （internal server error）- 通用错误响应

　　　　503 （Service Unavailable）- 服务端当前没法处理请求