任务二:springmvc进阶
课程任务主要内容:
- ajax异步交互
- RESTful
- 文件上传
- 异常处理
- 拦截器
一 ajax异步交互
Springmvc默认用MappingJackson2HttpMessageConverter对json数据进行转换,需要加入jackson的包;同时使用 <mvc:annotation-driven />
项目提示:在上个阶段的springmvc_quickstart项目中继续编写
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.9.8</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-core</artifactId>
<version>2.9.8</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-annotations</artifactId>
<version>2.9.0</version>
</dependency>
1.1 @RequestBody
该注解用于Controller的方法的形参声明,当使用ajax提交并指定contentType为json形式时,通过HttpMessageConverter接口转换为对应的POJO对象。
创建ajax.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<script src="${pageContext.request.contextPath}/js/jquery-3.5.1.js"></script>
<%--ajax异步交互--%>
<button id="btn1">ajax异步提交</button>
<script>
$("#btn1").click(function () {
let url = '${pageContext.request.contextPath}/user/ajaxRequest';
let data = '[{"id":1,"username":"张三"},{"id":2,"username":"李四"}]';
$.ajax({
type: 'POST',
url: url,
data : data,
contentType : 'application/json;charset=utf-8',
success: function (resp) {
alert(JSON.stringify(resp));
}
})
})
</script>
</body>
</html>
@RequestMapping(value = "/ajaxRequest")
public void ajaxRequest(@RequestBody List<User>list) {
System.out.println(list);
}
1.2 @ResponseBody
该注解用于将Controller的方法返回的对象,通过HttpMessageConverter接口转换为指定格式的数据如:json,xml等,通过Response响应给客户端。
/*
@RequestMapping
produces = "application/json;charset=utf-8"
响应返回数据的mime类型和编码,默认为 json
*/
@RequestMapping(value = "/ajaxRequest")
@ResponseBody
public List<User> ajaxRequest(@RequestBody List<User> list) {
System.out.println(list);
return list;
}
二 RESTful
2.1 什么是RESTful
Restful是一种软件架构风格、设计风格,而不是标准,只是提供了一组设计原则和约束条件。主要用于客户端和服务器交互类的软件,基于这个风格设计的软件可以更简洁,更有层次,更易于实现缓存机制等。
Restful风格的请求是使用“url+请求方式”表示一次请求目的的,HTTP 协议里面四个表示操作方式的动词如下:
- GET:读取(Read)
- POST:新建(Create)
- PUT:更新(Update)
- DELETE:删除(Delete)
客户端请求 | 原来风格URL地址 | RESTful风格URL地址 |
---|---|---|
查询所有 | /user/findAll | GET /user |
根据ID查询 | /user/findById?id=1 | GET /user/{1} |
新增 | /user/save | POST /user |
修改 | /user/update | PUT /user |
删除 | /user/delete?id=1 | DELETE /user/{1} |
如果要进行测试修改和删除操作,那么下载postman来模拟
2.2 代码实现
@PathVariable
用来接收RESTful风格请求地址中占位符的值
@RestController
RESTful风格多用于前后端分离项目开发,前端通过ajax与服务器进行异步交互,我们处理器通常返回的是json数据所以使用@RestController来替代@Controller和@ResponseBody两个注解。
@RestController //组合主键:组合@Controller + @ResponseBody
@RequestMapping("/restful")
public class RestfulController {
/*
根据id进行查询
localhost:8080/项目名/restful/user/2 + get请求方式 404 findById:2
*/
@GetMapping("/user/{id}") // @RequestMapping(value = "/user/{id}",method = RequestMethod.GET)
public String findById(@PathVariable Integer id){
// 调用service方法完成对id为2的这条记录的查询
// 问题:findById方法中怎么才能获取restful编程风格中url里面占位符的值
return "findById: "+ id ;
}
/*
新增方法
*/
@PostMapping("/user") // @RequestMapping(value = "/user",method = RequestMethod.POST)
public String post(){
// 新增
return "post";
}
/*
更新方法
*/
@PutMapping("/user")
public String put(){
// 更新操作
return "put";
}
/*
删除方法
*/
@DeleteMapping("/user/{id}")
public String delete(@PathVariable Integer id){
return "delete" + id;
}
}
三 文件上传
3.1 文件上传三要素
- 表单项 type=“file”
- 表单的提交方式 method=“POST”
- 表单的enctype属性是多部分表单形式 enctype=“multipart/form-data"
3.2 文件上传原理
- 当form表单修改为多部分表单时,request.getParameter()将失效。
- 当form表单的enctype取值为 application/x-www-form-urlencoded 时,
- form表单的正文内容格式是: name=value&name=value
- 当form表单的enctype取值为 mutilpart/form-data 时,请求正文内容就变成多部分形式:
3.3 单文件上传
步骤分析
- 导入fileupload和io坐标
- 配置文件上传解析器
- 编写文件上传代码
1)导入fileupload和io坐标
<!--导入fileupload和io坐标-->
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.3.3</version>
</dependency>
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>2.6</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>compile</scope>
</dependency>
2)配置文件上传解析器
spring-mvc.xml
<!--配置文件上传解析器-->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<!-- 设定文件上传的最大值为5MB,5*1024*1024 -->
<property name="maxUploadSize" value="5242880"></property>
<!-- 设定文件上传时写入内存的最大值,如果小于这个参数不会生成临时文件,默认为10240 -->
<property name="maxInMemorySize" value="40960"></property>
</bean>
3)编写文件上传代码
创建fileupload.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<%--编写一个满足文件上传三要素的表单
1.表单的提交方式必须是post
2.表单的enctype属性必须要修改成multipart/form-data
3.表单中必须要有文件上传项
--%>
<form action="${pageContext.request.contextPath}/fileupload" method="post" enctype="multipart/form-data">
名称:<input type="text" name="username"> <br>
文件:<input type="file" name="filePic"> <br>
<input type="submit" value="单文件上传">
</form>
</body>
</html>
controller.FileUploadController.java
@Controller
public class FileUploadController {
/*
单文件上传
*/
@RequestMapping("/fileupload")
public String fileUpload(String username, MultipartFile filePic) throws IOException {
//获取表单的提交参数,完成文件上传
System.out.println(username);
// 获取原始的文件上传名 a.txt abc
String originalFilename = filePic.getOriginalFilename();
filePic.transferTo(new File("D:/upload/"+originalFilename));
return "success";
}
}
3.4 多文件上传
fileupload.jsp
<%--实现多文件上传--%>
<form action="${pageContext.request.contextPath}/filesupload" method="post" enctype="multipart/form-data">
名称:<input type="text" name="username"> <br>
文件1:<input type="file" name="filePic"> <br>
文件2:<input type="file" name="filePic"> <br>
<input type="submit" value="多文件上传">
</form>
controller.FileUploadController.java
/*
多文件上传
*/
@RequestMapping("/filesupload")
public String filesUpload(String username, MultipartFile[] filePic) throws IOException {
//获取表单的提交参数,完成文件上传
System.out.println(username);
// 获取原始的文件上传名 a.txt abc
for (MultipartFile multipartFile : filePic) {
String originalFilename = multipartFile.getOriginalFilename();
multipartFile.transferTo(new File("D:/upload/"+originalFilename));
}
return "success";
}
四 异常处理
4.1 异常处理的思路
在Java中,对于异常的处理一般有两种方式:
- 一种是当前方法捕获处理(try-catch),这种处理方式会造成业务代码和异常处理代码的耦合。
- 另一种是自己不处理,而是抛给调用者处理(throws),调用者再抛给它的调用者,也就是一直向上抛。
在这种方法的基础上,衍生出了SpringMVC的异常处理机制。
系统的dao、service、controller出现都通过throws Exception向上抛出,最后由springmvc前端控制器交由异常处理器进行异常处理,如下图:
4.2 自定义异常处理器
步骤分析
- 创建异常处理器类实现HandlerExceptionResolver
- 配置异常处理器
- 编写异常页面
- 测试异常跳转
1)创建异常处理器类实现HandlerExceptionResolver
exception/GlobalExceptionResolver.java
public class GlobalExceptionResolver implements HandlerExceptionResolver {
/*
Exception e:实际抛出的异常对象
*/
@Override
public ModelAndView resolveException(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, Object handler, Exception e) {
//具体的异常处理 产生异常后,跳转到一个最终的异常页面
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("error",e.getMessage());
modelAndView.setViewName("error");
return modelAndView;
}
}
2)配置异常处理器
方法一:
注解的方式:
@Component
public class GlobalExecptionResovler implements HandlerExceptionResolver {}
方法二:
XML配置的方式:
<bean id="globalExecptionResovler" class="com.lagou.exception.GlobalExecptionResovler">
</bean>
3)编写异常页面
WEB-INF/pages/error.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>error</title>
</head>
<body>
<h3>这是一个最终异常的显示页面</h3>
<p>${error}</p>
</body>
</html>
4)测试异常跳转
com.lagou.controller.ExceptionController
@Controller
public class ExceptionController {
@RequestMapping("/testException")
public String testException(){
int i=1/0;
return "success";
}
}
4.3 web的处理异常机制
新建:
404.jsp和500.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
您请求的资源已经被删除
</body>
</html>
web.xml
<!--处理404异常-->
<error-page>
<error-code>404</error-code>
<location>/404.jsp</location>
</error-page>
<!--处理500异常-->
<error-page>
<error-code>500</error-code>
<location>/500.jsp</location>
</error-page>
五 拦截器
5.1 拦截器(interceptor)的作用
Spring MVC 的拦截器类似于 Servlet 开发中的过滤器 Filter,用于对处理器进行预处理和后处理。
将拦截器按一定的顺序联结成一条链,这条链称为拦截器链(InterceptorChain)。在访问被拦截的方法或字段时,拦截器链中的拦截器就会按其之前定义的顺序被调用。拦截器也是AOP思想的具体实现。
5.2 拦截器和过滤器区别
关于interceptor和filter的区别,如图所示:
5.3 快速入门
步骤分析
- 创建拦截器类实现HandlerInterceptor接口
- 配置拦截器
- 测试拦截器的拦截效果
1)创建拦截器类实现HandlerInterceptor接口
com.lagou.interceptor.MyInterceptor1
public class MyInterceptor1 implements HandlerInterceptor {
/*
preHandle: 在目标方法执行之前 进行拦截 return false:不放行
*/
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
System.out.println("preHandle....1");
return true;
}
/*
postHandle: 在目标方法执行之后,视图对象返回之前,执行的方法
*/
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
System.out.println("postHandle....1");
}
/*
afterCompletion:在流程都执行完成后,执行的方法
*/
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
System.out.println("afterCompletion....1");
}
}
2)配置拦截器
spring-mvc.xml
<!--配置拦截器-->
<mvc:interceptors>
<mvc:interceptor>
<mvc:mapping path="/**"/><!--对所有controller类中所有方法都进行拦截-->
<bean class="com.lagou.interceptor.MyInterceptor1"></bean>
</mvc:interceptor>
</mvc:interceptors>
3)测试拦截器的拦截效果
编写Controller,发请求到controller,跳转页面
com.lagou.controller.TargetController
@Controller
public class TargetController {
@RequestMapping("/target")
public String targetMethod(){
System.out.println("目标方法执行了...");
return "success";
}
}
编写jsp页面
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<h3>success... </h3>
<% System.out.println("视图执行了....");%>
</body>
</html>
输出打印效果:
preHandle
目标方法执行了...
postHandle...
视图执行了....
afterCompletion...
5.4 拦截器链
开发中拦截器可以单独使用,也可以同时使用多个拦截器形成一条拦截器链。开发步骤和单个拦截器是一样的,只不过注册的时候注册多个,注意这里注册的顺序就代表拦截器执行的顺序。
同上,再编写一个MyHandlerInterceptor2操作,测试执行顺序:
<!--配置拦截器-->
<mvc:interceptors>
<mvc:interceptor>
<mvc:mapping path="/**"/> <!--对所有controller类里面的所有方法都进行拦截-->
<bean class="com.lagou.interceptor.MyInterceptor1"></bean>
</mvc:interceptor>
<mvc:interceptor>
<mvc:mapping path="/**"/> <!--对所有controller类里面的所有方法都进行拦截-->
<bean class="com.lagou.interceptor.MyInterceptor2"></bean>
</mvc:interceptor>
</mvc:interceptors>
执行效果:
preHandle...1
preHandle...2
目标方法执行了...
postHandle....2
postHandle...1
视图执行了....
afterCompletion....2
afterCompletion...1
5.5 知识小结
拦截器中的方法说明如下:
拦截器问题:假设三个拦截器只有第二个拦截器的preHandle方法返回False,其余都是True,那么会产生:
<mvc:interceptors>
<mvc:interceptor>
<mvc:mapping path="/**/>
<bean class="com.lagou.ssm.interception.Inteceptor1/>
</mvc:interceptor>
<mvc:interceptor>
<bean class="com.lagou.ssm.interception.Inteceptor2/>
</mvc:interceptor>
<mvc:interceptor>
<bean class="com.lagou.ssm.interception.Inteceptor3/>
</mvc:interceptor>
</mvc:interceptors>
输出结果:
preHandle…1
preHandle…2
afterCompletion…1
执行顺序:
方法执行前1——方法执行前2——页面渲染后1