设计风格之REST

一.简介

REST简介

REST 是英文 representational state transfer(表象性状态转变)或者表述性状态转

移;Rest 是 web 服务的一种架构风格;使用 HTTP,URI,XML,JSON,HTML 等广泛流行的标准和协

议;轻量级,跨平台,跨语言的架构设计。

它是一种设计风格,不是一种标准,是一种思想。

Rest 架构的主要原则

1. 网络上的所有事物都被抽象为资源
2. 每个资源都有一个唯一的资源标识符
3. 同一个资源具有多种表现形式(xml,json 等)
4. 对资源的各种操作不会改变资源标识符

Restful简介

对应的中文是 rest 式的;Restful web service 是一种常见的 rest 的应用,是遵守了 rest 风格的web 服务;rest 式的 web 服务是一种 ROA(The Resource-Oriented Architecture)(面向资源的架构).

REST 指的是一组架构约束条件和原则。满足这些约束条件和原则的应用程序或设计就是 RESTful。

在 Restful 之前的操作：
http://127.0.0.1/user/query/1 GET 根据用户 id 查询用户数据
http://127.0.0.1/user/save POST 新增用户
http://127.0.0.1/user/update POST 修改用户信息
http://127.0.0.1/user/delete GET/POST 删除用户信息

RESTful 用法：
http://127.0.0.1/user/1 GET 根据用户 id 查询用户数据
http://127.0.0.1/user POST 新增用户
http://127.0.0.1/user PUT 修改用户信息
http://127.0.0.1/user DELETE 删除用户信息

最开始每次请求的接口或者地址,都在做描述,例如查询的时候用了 query,新增的时候用了 save，其实完全没有这个必要。

我使用了 get 请求,就是查询.使用 post 请求,就是新增的请求,我的意图很明显,完全没有必要做描述,这就是为什么有了 restful。

RESTful API简介

RESTful API 是一套互联网应用程序的 API 设计理论。

RESTful API 的返回结果应该符合以下规范

• GET /collection：返回资源对象的列表（数组）
• GET /collection/resource：返回单个资源对象
• POST /collection：返回新生成的资源对象
• PUT /collection/resource：返回完整的资源对象
• PATCH /collection/resource：返回完整的资源对象
• DELETE /collection/resource：返回一个空文档

二.restful使用

HTTP 请求在 RESTful Web 服务中的典型应用