Restful接口详解

Restful是英文Representational State Transfer(表象性状态转变)或者表述性状态转移; Rest是web服务的一种架构风格,使用HTTP,URL,XML,JSON,HTML等广泛流行的标准和协议; 轻量级,跨平台,跨语言的架构设计, 是一种设计风格,不是一种标准, 是一种思想
Rest架构主要思想

1. 网络上的所有事物都被抽象为资源
2. 每个资源都有一个唯一的资源标识符
3. 同一个资源具有多种表现形式(xml,json等)
4. 对资源的各种操作不会改变资源标识符
5. 所有的操作都是无状态的
   符合REST原则的架构方式即可成为RESTFUL
   什么是RESTFul:
   对应的中文是rest式的; Restful web service是一种常见的rest的应用,是遵守了rest风格的web服务, rest式的web服务是一种ROA(The Resource-Oriented Architecture)面向资源的架构

为什么会出现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/1 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

幂等性
HTTP幂等性, 是指无论调用多少次都不会有不同的结果的HTTP方法.不管调用一次,十次, 上百次,结果都相同
例如: GET ,用于获取资源, 不管调用多少次, 结果都不会改变, 所以是幂等的.
只是查询数据, 不会影响到资源的变化, 因此认为他是幂等的
值得注意的是, 幂等性指的是所用于结果而非资源本身, 例如: HTTP GET方法, 可能每次得到不同的返回内容(例如系统时间), 但是并不会影响资源, 因此认为是幂等的.

SpringMVC实现了restful服务
SpringMVC原生态的支持了REST风格的架构设计
所涉及到的注解:
----@RequestMapping
----@PathVariable
----@ResponseBody
@RequestMapping(value = “{id}”, method = RequestMethod.GET)
@ResponseBody
public ResponseEntity queryUserById(@PathVariable(“id”) Long id) {
try {
User user = this.newUserService.queryUserById(id);
if (null == user) {
// 资源不存在，响应404
return ResponseEntity.status(HttpStatus.NOT_FOUND).body(null);
}
// 200
// return ResponseEntity.status(HttpStatus.OK).body(user);
return ResponseEntity.ok(user);
} catch (Exception e) {
e.printStackTrace();
}
// 500
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(null);
}

原文链接：https://www.jianshu.com/p/7893169a7c93