7、SpringMVC之RESTful概述
7.1、简介
-
RESTful 也称为REST(英文:Representational State Transfer)即表现层状态传递,它是一种软件架构风格或设计风格;
-
REST 是 Roy Fielding 博士( HTTP 规范的主要编写者之一)在其2000年的博士论文中提出来的;
-
其作用是,降低开发的复杂性、提高系统的可伸缩性;
-
通过基于 REST 的 API 公开系统资源是一种灵活的方法,可以为不同种类的应用程序提供以标准方式格式化的数据;
-
Ajax 与 REST 之间的完美配合增加了当今人们对 REST 的注意力。
7.2、传统风格与RESTful风格
-
RESTful 风格提倡 URL 地址使用统一的风格设计,各单词之间用斜杠分开;
-
RESTful 风格不使用问号键值对的方式携带请求参数,而是将要发送给服务器的数据作为 URL 地址的一部分;
-
RESTful 风格中不存在动词形式的路径,如updateUser表示修改用户,是一个动词,要改为名词user;
-
RESTful 风格中的路径只存在资源名称,增删改查的操作则是通过 HTTP 的请求方式来体现;
-
HTTP 协议里面,有四个表示操作方式的动词:GET、POST、PUT、DELETE;
-
它们分别对应四种基本操作:GET 用来获取资源,POST 用来新建资源,PUT 用来更新资源,DELETE用来删除资源。
操作 | 传统风格 | REST风格 |
---|---|---|
新增操作 | saveUser | user-->post请求方式 |
删除操作 | deleteUser?id=1 | user/1-->delete请求方式 |
修改操作 | updateUser | user-->put请求方式 |
查询操作 | getUserById?id=1 | user/1-->get请求方式 |
7.3、GET请求示例(不带参数)
7.3.1、页面请求示例
<a th:href="@{/user}">测试查询所有的用户信息</a>
7.3.2、控制器方法示例
@RequestMapping(value = "/user",method = RequestMethod.GET)
public String getAllUser(){
System.out.println("查询所有的用户信息-->/user-->GET");
return "success";
}
7.3.3、测试效果
7.4、GET请求示例(带参数)
7.4.1、页面请求示例
<a th:href="@{/user/1}">测试查询id为1的用户信息</a>
7.4.2、控制器方法示例
@RequestMapping(value = "/user/{id}",method = RequestMethod.GET)
public String getUserById(@PathVariable("id") Integer id){
System.out.println("根据id查询用户信息-->/user/"+id+"-->GET");
return "success";
}
7.4.3、测试效果
7.5、POST请求示例
7.5.1、页面请求示例
<form th:action="@{/user}" method="post">
<input type="submit" value="测试新增用户信息">
</form>
7.5.2、控制器方法示例
@RequestMapping(value = "/user",method = RequestMethod.POST)
public String insertUser(){
System.out.println("新增用户信息-->/user-->POST");
return "success";
}
7.5.3、测试效果
7.6、配置转换请求方式的过滤器
-
实际上,浏览器只支持发送 GET 和 POST 方式的请求;
-
SpringMVC 提供的 HiddenHttpMethodFilter 可以将 POST 请求转换为 DELETE 或 PUT 请求;
-
使用 HiddenHttpMethodFilter 将 POST 请求转换为 DELETE 或 PUT 请求,须满足两个条件:
a、当前请求的请求方式必须为post
b、当前请求必须传输请求参数_method -
满足以上条件,HiddenHttpMethodFilter 过滤器就会将当前请求的请求方式转换为请求参数_method的值,
因此请求参数_method的值才是最终的请求方式。
注意:HiddenHttpMethodFilter过滤器的顺序,要在CharacterEncodingFilter过滤器的后面
<!--配置处理请求方式的过滤器-->
<filter>
<filter-name>HiddenHttpMethodFilter</filter-name>
<filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>HiddenHttpMethodFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
7.7、PUT请求示例
7.7.1、页面请求示例
<form th:action="@{/user}" method="post">
<input type="hidden" name="_method" value="put">
<input type="submit" value="测试修改用户信息">
</form>
7.7.2、控制器方法示例
@RequestMapping(value = "/user",method = RequestMethod.PUT)
public String updateUser(){
System.out.println("修改用户信息-->/user-->PUT");
return "success";
}
7.7.3、测试效果
7.8、DELETE请求示例
7.8.1、页面请求示例
<form th:action="@{/user/2}" method="post">
<input type="hidden" name="_method" value="delete">
<input type="submit" value="测试删除id为2的用户信息">
</form>
7.8.2、控制器方法示例
@RequestMapping(value = "/user/{id}",method = RequestMethod.DELETE)
public String deleteUser(@PathVariable("id") Integer id){
System.out.println("根据id删除用户信息-->/user/"+id+"-->DELETE");
return "success";
}
7.8.3、测试效果
7.9、结合请求方式的派生注解
对于处理指定请求方式的控制器方法,SpringMVC中提供了@RequestMapping的派生注解
-
处理get请求的派生注解-->@GetMapping
-
处理post请求的派生注解-->@PostMapping
-
处理put请求的派生注解-->@PutMapping
-
处理delete请求的派生注解-->@DeleteMapping