RESTful架构

1 何为RESTful

RESTful架构是目前最流行的一种互联网软件架构
是Roy Thomas Fielding在他2000年的博士论文中提出的
是Representational State Transfer的缩写，翻译过来是”表现层状态转化”
是所有Web应用都应该遵守的架构设计指导原则
7个HTTP方法：GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONS

2 接口规范

幂等性：不论你请求多少次，资源的状态是一样的。
2.1 GET
安全且幂等
获取表示
变更时获取表示（缓存）
适合查询类的接口使用
2.2 POST
不安全且不幂等
使用服务端管理的（自动产生）的实例号创建资源
创建子资源
部分更新资源
如果没有被修改，则不过更新资源（乐观锁）
适合数据提交类的接口使用
2.3 PUT
不安全但幂等
用客户端管理的实例号创建一个资源
通过替换的方式更新资源
如果未被修改，则更新资源（乐观锁）
适合更新数据的接口使用
2.4 DELETE
不安全但幂等
删除资源
适合删除数据的接口使用
请求返回响应码：

==200== （OK）				- 如果现有资源已被更改
201 （created）				- 如果新资源被创建
202 （accepted）			- 已接受处理请求但尚未完成（异步处理）
301 （Moved Permanently）	- 资源的URI被更新
303 （See Other）			- 其他（如，负载均衡）
==400== （bad request）		- 指代坏请求
==401==						- 未认证
==404== （not found）		- 资源不存在
406 （not acceptable）		- 服务端不支持所需表示
409 （conflict）			- 通用冲突
412（Precondition Failed）	- 前置条件失败（如执行条件更新时的冲突）
415 （unsupported media type）- 接受到的表示不受支持
==500== （internal server error）- 通用错误响应**通常是后台问题
503 （Service Unavailable）	-服务当前无法处理请求