一、RESTful是个啥？
RESTful是一种软件架构风格、设计风格，只是提供了一组设计原则和约束条件。
二、对比传统方式
RESTful风格和传统方式主要体现在URI和请求方法上。
| 传统方式 | RESTful风格 | |
|---|---|---|
| 查询 | GET /user/query?name=zhangsan | GET /user?name=zhangsan |
| 详情 | GET /user/getInfo?id=1 | GET /user/1 |
| 创建 | POST /user/create | POST /user |
| 修改 | POST /user/update | PUT /user/1 |
| 删除 | GET /user/delete?id=1 | DELETE /user/1 |
1、用URI描述资源。
2、使用HTTP方法描述行为。使用HTTP状态码来表示不同的结果。
3、使用json作为数据交互格式。
GET，DELETE，PUT和POST的典型用法：
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）- 服务端当前无法处理请求
三、REST成熟度模型
原文https://martinfowler.com/articles/richardsonMaturityModel.html
将REST成熟度从低到高分为4级（level0-level3）：
1、Level 0：使用http作为传输方式。
2、Level 1：引入资源概念，每个资源都有对应的URI。
3、使用HTTP方法进行不同的操作，使用HTTP状态码来表示不同的结果。
4、使用超媒体。在资源的表达中包含了连接信息。
一般情况下，达成Level2就可以了。
