Spring 指南（了解REST）

了解REST

REST（Representational State Transfer）由Roy Fielding于2000年在他的博士论文中引入和定义，REST是用于设计分布式系统的架构风格，它不是标准，而是一组约束，例如无状态，具备客户端/服务器关系和统一接口，REST与HTTP并不严格相关，但最常与它相关联。

REST原则

• 资源公开易于理解的目录结构URI。
• 表示传输JSON或XML以表示数据对象和属性。
• 消息显式使用HTTP方法（例如，GET、POST、PUT和DELETE）。
• 无状态交互在请求之间不在服务器上存储客户端上下文，状态依赖性限制和限制可伸缩性，客户端保持会话状态。

HTTP方法

使用HTTP方法将CRUD（建立、检索、更新、删除）操做映射到HTTP请求。

GET

检索信息，GET请求必须是安全且幂等的，这意味着不管使用相同参数重复多少次，结果都是相同的，它们可能有反作用，但用户不指望它们，所以它们对系统的操做不是相当重要的，请求也能够是部分的或有条件的。

检索ID为1的地址：

GET /addresses/1

POST

请求URI上的资源对提供的实体执行某些操做，POST一般用于建立新实体，但也可用于更新实体。

建立一个新地址：

POST /addresses

PUT

将实体存储在URI中，PUT能够建立新实体或更新现有实体，PUT请求是幂等的，幂等性是PUT与POST请求的指望之间的主要区别。

修改ID为1的地址：

PUT /addresses/1

注意：PUT替换现有实体，若是仅提供数据元素的子集，则其他数据元素将替换为空或 null。

PATCH

仅更新URI上实体的指定字段，PATCH请求既不安全也不是幂等（RFC 5789），这是由于PATCH操做没法确保整个资源已更新。

PATCH /addresses/1

DELETE

请求删除资源，可是，没必要当即删除资源，它多是异步或长时间运行的请求。

删除ID为1的地址：

DELETE /addresses/1

HTTP状态码

状态码代表HTTP请求的结果。

• 1XX — 信息
• 2XX — 成功
• 3XX — 重定向
• 4XX — 客户端错误
• 5XX — 服务器错误

媒体类型

Accept和Content-Type HTTP头可用于描述HTTP请求中发送或请求的内容，若是客户端正在请求JSON格式的响应，则能够将Accept设置为application/json，相反，在发送数据时，将Content-Type设置为application/xml会告诉客户端请求中发送的数据是XML。