SpringMVC——REST风格

1.REST风格是什么？

Restful是一种软件架构风格、设计风格，通过url路径的方式和请求方式的配合进行参数传递以及完成不同的CRUD操作，使不同的请求方式和不同的操作进行了一个匹配统一。

2.REST请求方法设定

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

请求方式	请求目的
GET	用于获取资源
POST	用于新建资源
PUT	用于更新资源
DELETE	用于删除资源

例如：* /users/1 GET ： 得到 id = 1 的 user* /users/1 DELETE： 删除 id = 1 的 user* /users/1 PUT： 更新 id = 1 的 user* /users POST： 新增 user

3.REST入门案例

(1)没有参数传递时
不使用Restful风格编写的controller

@RequestMapping("/save")@ResponseBodypublic String save1(){System.out.println("save running......");return "save";}

使用Restful风格编写的controller
这里直接指出了只有post的请求时才是执行保存用户的操作

@RequestMapping(value = "/users", method = RequestMethod.POST)@ResponseBodypublic String save2(){System.out.println("save running......");return "save";}

(2)有普通参数传递时
不使用Restful风格编写的controller

@RequestMapping(value = "/findById")@ResponseBodypublic String findById(Integer id){System.out.println("findById running......" + id);return "findById";}

注意此时在浏览器地址栏我们需要输入的内容是
http://localhost:8080/test/findById?id=1

使用Restful风格编写的controller
这里直接指出了只有get的请求时才是执行查找用户的操作

@RequestMapping(value = "/users/{id}", method = RequestMethod.GET)@ResponseBodypublic String findById(@PathVariable Integer id){System.out.println("findById running......" + id);return "findById";}

注意此时在浏览器地址栏我们需要输入的内容是
http://localhost:8080/test/findById/1

(3)有json格式的字符串参数传递需要封装对象时
这里我用了一个表单提交post的请求且不使用REST时

@RequestMapping(value = "/users")@ResponseBodypublic String save(User user) throws JsonProcessingException {System.out.println(user);ObjectMapper mapper = new ObjectMapper();return mapper.writeValueAsString(user);}

这里我采用的是ajax异步请求传递一个json格式的字符串，并采用POST的提交方式。
ajax的异步请求代码如下：

<%@ page contentType="text/html;charset=UTF-8" language="java" isELIgnored="false" %>
<html>
<head><title>Title</title><script src="${pageContext.request.contextPath}/js/jquery-3.3.1.js"></script><script>// 定义方法var user = {username:"zs", age:12};function fun(){$.ajax({url:"users",contentType:"application/json",type:"POST",data:JSON.stringify(user),success:function (data) {alert(data);},// 相应成功后的回调函数error:function () {alert("出错了。。。");},dataType:"text"})}</script>
</head>
<body><input type="button" οnclick="fun()" value="提交">
</body>
</html>

对应的controller如下：

@RequestMapping(value = "/users", method = RequestMethod.POST)@ResponseBodypublic String save(@RequestBody User user) throws JsonProcessingException {System.out.println(user);ObjectMapper mapper = new ObjectMapper();return mapper.writeValueAsString(user);}

4.Restful开发中的注解介绍

名称：@PathVariable
类型：形参注解
位置：SpringMVC控制器方法形参定义前面
作用：绑定路径参数与处理器方法形参间的关系，要求路径名与形参名一一对应
范例：

@RequestMapping(value = "/users/{id}", method = RequestMethod.GET)@ResponseBodypublic String findById(@PathVariable Integer id){System.out.println("findById running......" + id);return "findById";}

名称：@RestController
类型：类注解
位置：基于SpringMVCESTful来发控制器类定义上方
作用：设置当前控制器类为RESTful风格，等同于@Controller与@ResponseBody两个注解的组合功能。
范例：

@RestController
public class UserController{}

名称：@GetMapping @PostMapping @PutMapping @DeleteMapping
类型：方法注解
位置：基于SpringMVCESTful来发控制器方法定义上方
作用：设置当前控制器方法请求访问路径与请求动作，每种对应一个请求动作，例如@GetMapping对应GET请求
属性：value（默认）：请求访问路径
范例：

@RestController
@RequestMapping("/users")
public class UserController {@GetMapping("/{id}")public String findById(@PathVariable Integer id){System.out.println("findById running......" + id);return "findById";}
}