详解Restful风格

详解Restful风格

一、Restful风格介绍

Restful是一种软件架构风格、设计风格，而不是标准，只是提供了一组设计原则和约束条件。主要用于客户端和服务器交互类的软件，基于这个风格设计的软件可以更简洁，更有层次，更易于实现缓存机制等。

二、设计原则

Restful风格的请求是使用“url+请求方式”表示一次请求目的。
HTTP 协议里面四个表示操作方式的动词如下：

GET：用于获取资源 

POST：用于新建资源 

PUT：用于更新资源 

DELETE：用于删除资源

举个例子：

/user/1 GET ： 得到 id = 1 的 user 

/user/1 DELETE： 删除 id = 1 的 user 

/user/1 PUT： 更新 id = 1 的 user 

/user POST： 新增 user

三、使用到的注解

1、@RequestMapping
使用位置：SpringMVC控制器方法定义上方
作用：设置当前控制器方法请求访问路径
属性：
value 请求访问路径
method http请求动作，标准动作（GET、POST、PUT、DELETE）

@RequestMapping(value = "/users", method = RequestMethod.GET)

2、@PathVariable
使用位置：SpringMVC控制器方法形参定义前面
作用：绑定路径参数与处理器方法形参间的关系，要求路径参数名与形参名一一对应

上述url地址/user/1中的1就是要获得的请求参数，在SpringMVC中可以使用占位符进行参数绑定。地址/user/1可以写成 /user/{id}，占位符{id}对应的就是1的值。在业务方法中我们可以使用@PathVariable注解进行占位符的匹配获取工作。

@RestController
@RequestMapping("/users") // 下面的每个控制器方法的请求路径都有前缀 /users
public class UserController
{
 @GetMapping("/{id}")
 public String getById(@PathVariable Integer id)
    {
        return "getById";
    }
}

3、@RequestBody @RequestParam @PathVariable

RequestParam：用于接收URL地址传参或表单传参
RequestBody：用于接收JSON数据
PathVariable：用于接收路径参数，使用 {参数名} 描述路径参数

后期开发中，发送请求参数超过1个时，以JSON格式为主，所以@RequestBody应用较广泛；
如果发送非JSON格式数据，选用 @RequestParam 接收请求参数；
当参数数量只有一个时，或为数字时，可以采用 @PathVariable接收请求路径变量，通常传递id值。