Spring MVC 进阶：Ajax、RESTful、文件上传与异常处理
springmvc进阶
一 ajax异步交互
- Springmvc默认用MappingJackson2HttpMessageConverter对json数据进行转换，需要加入jackson的包；同时使用 <mvc:annotation-driven />
<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对象。
1.2 @ResponseBody
- 该注解用于将Controller的方法返回的对象，通过HttpMessageConverter接口转换为指定格式的数据如：json,xml等，通过Response响应给客户端。
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>
/*
ajax异步交互
*/
@RequestMapping("/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} |
2.2 代码实现
@PathVariable
- 用来接收RESTful风格请求地址中占位符的值
package com.myproject.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.ResponseBody;
@Controller
@RequestMapping("/restful")
public class RestfulController {
/*
根据id进行查询
localhost:8080/项目路径/restful/user/2 + get请求方式
*/
@RequestMapping(value = "/user/{id}", method = RequestMethod.GET)
@ResponseBody
public String findById(@PathVariable Integer id) {
// 调用service方法完成对id为2的这条记录的查询
// findById 方法中怎么才能获取restful编程风格中url里面占位符的值
return "findById: " + id;
}
}
@RestController
- RESTful风格多用于前后端分离项目开发，前端通过ajax与服务器进行异步交互，我们处理器通常返回的是json数据所以使用@RestController来替代@Controller和@ResponseBody两个注解。
package com.myproject.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;
@RestController // 组合主键：组合@Controller + @ResponseBody
@RequestMapping("/restful")
public class RestfulController {
/*
根据id进行查询
localhost:8080/项目路径/restful/user/2 + get请求方式
*/
@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 单文件上传
步骤分析
1. 导入fileupload和io坐标
2. 配置文件上传解析器
3. 编写文件上传代码
1）导入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>
2）配置文件上传解析器
<!--配置文件上传解析器-->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<!--设置文件上传的最大值为5M 5*1024*1024-->
<property name="maxUploadSize" value="5242880"/>
<!--设定文件上传时写入内存的最大值，如果小于这个参数不会生成临时文件，默认为10240-->
<property name="maxInMemorySize" value="4096" />
</bean>
3）编写文件上传代码
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<%--
编写一个满足文件上传三要素的表单
1. 表单的提交方式必须是post
2. 表单的enctype属性必须要修改成muptipart/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>
package com.myproject.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.multipart.MultipartFile;
import java.io.File;
import java.io.IOException;
@Controller
public class FileUploadController {
/*
单文件上传
*/
@RequestMapping("/fileUpload")
public String fileUpload(String username, MultipartFile filePic) throws IOException {
// 获取表单的提交参数，完成文件上传
System.out.println(username);
// 获取原始的文件名称
String originalFilename = filePic.getOriginalFilename();
// 保存文件
filePic.transferTo(new File("C:/upload" + originalFilename));
return "success";
}
}
3.4 多文件上传
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<%--
编写一个满足文件上传三要素的表单
1. 表单的提交方式必须是post
2. 表单的enctype属性必须要修改成muptipart/form-data
3. 表单中必须要有文件上传项
--%>
<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>
</body>
</html>
package com.myproject.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.multipart.MultipartFile;
import java.io.File;
import java.io.IOException;
@Controller
public class FileUploadController {
/*
多文件上传
*/
@RequestMapping("/filesupload")
public String filesUpload(String username, MultipartFile[] filePics) throws IOException {
// 获取表单的提交参数，完成文件上传
System.out.println(username);
// 获取原始的文件名称
for (MultipartFile filePic : filePics) {
String originalFilename = filePic.getOriginalFilename();
filePic.transferTo(new File("C:/upload" + originalFilename));
}
return "success";
}
}
四 异常处理
4.1 异常处理的思路
在Java中，对于异常的处理一般有两种方式:
- 一种是当前方法捕获处理（try-catch），这种处理方式会造成业务代码和异常处理代码的耦合。
- 另一种是自己不处理，而是抛给调用者处理（throws），调用者再抛给它的调用者，也就是一直向上抛。
在这种方法的基础上，衍生出了SpringMVC的异常处理机制。
- 系统的dao、service、controller出现都通过throws Exception向上抛出，最后由springmvc前端控制器交由异常处理器进行异常处理，如下图：
4.2 自定义异常处理器
步骤分析
1. 创建异常处理器类实现HandlerExceptionResolver
2. 配置异常处理器
3. 编写异常页面
4. 测试异常跳转
1）创建异常处理器类实现HandlerExceptionResolver
package com.myproject.exception;
import org.springframework.web.servlet.HandlerExceptionResolver;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
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 {}
<bean id="globalExecptionResovler"
class="com.myproject.exception.GlobalExecptionResovler"></bean>
3）编写异常页面
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>error</title>
</head>
<body>
<h3>这是一个最终异常的显示页面</h3>
<p>${error}</p>
</body>
</html>
4）测试异常跳转
package com.myproject.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class ExceptionController {
@RequestMapping("/testException")
public String testException() {
int i = 1 / 0;
return "success";
}
}
4.3 web的处理异常机制
- 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>
- 404.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
你请求的资源被删除！
</body>
</html>
- 500.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
网络故障，请稍后再试！
</body>
</html>
五 拦截器
5.1 拦截器（interceptor）的作用
-
Spring MVC 的拦截器类似于 Servlet 开发中的过滤器 Filter，用于对处理器进行预处理和后处理。
-
将拦截器按一定的顺序联结成一条链，这条链称为拦截器链（InterceptorChain）。在访问被拦截的方法或字段时，拦截器链中的拦截器就会按其之前定义的顺序被调用。拦截器也是AOP思想的具体实现。
5.2 拦截器和过滤器区别
- 关于interceptor和filter的区别，如图所示：
5.3 快速入门
步骤分析
1. 创建拦截器类实现HandlerInterceptor接口
2. 配置拦截器
3. 测试拦截器的拦截效果
1) 创建拦截器类实现HandlerInterceptor接口
package com.myproject.interceptor;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class MyInterceptor1 implements HandlerInterceptor {
/*
preHandle：在目标方法执行之前，进行拦截
*/
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
System.out.println("preHandle...");
return true;
}
/*
postHandle: 在目标方法执行之后，视图对象返回之前，执行的方法
*/
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
System.out.println("postHandle...");
}
/*
afterCompletion: 在流程都执行完成之后，执行的方法
*/
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
System.out.println("afterCompletion...");
}
}
2）配置拦截器
<!--配置拦截器-->
<mvc:interceptors>
<mvc:interceptor>
<mvc:mapping path="/**"/> <!--对所有controller类里面的所有方法都进行拦截-->
<bean class="com.myproject.interceptor.MyInterceptor1" />
</mvc:interceptor>
</mvc:interceptors>
3）测试拦截器的拦截效果
- 编写Controller,发请求到controller,跳转页面
package com.myproject.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@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>success</title>
</head>
<body>
<h3>spring请求成功！${username}</h3>
<% System.out.println("视图执行了。。。"); %>
</body>
</html>
5.4 拦截器链
-
开发中拦截器可以单独使用，也可以同时使用多个拦截器形成一条拦截器链。开发步骤和单个拦截器是一样的，只不过注册的时候注册多个，注意这里注册的顺序就代表拦截器执行的顺序。
-
同上，再编写一个MyHandlerInterceptor2操作，测试执行顺序：
1) 创建拦截器类实现HandlerInterceptor接口
package com.myproject.interceptor;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class MyInterceptor1 implements HandlerInterceptor {
/*
preHandle：在目标方法执行之前，进行拦截
*/
@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");
}
}
package com.myproject.interceptor;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class MyInterceptor2 implements HandlerInterceptor {
/*
preHandle：在目标方法执行之前，进行拦截
*/
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
System.out.println("preHandle...2");
return true;
}
/*
postHandle: 在目标方法执行之后，视图对象返回之前，执行的方法
*/
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
System.out.println("postHandle...2");
}
/*
afterCompletion: 在流程都执行完成之后，执行的方法
*/
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
System.out.println("afterCompletion...2");
}
}
2）配置拦截器链
<!--配置拦截器链-->
<mvc:interceptors>
<mvc:interceptor>
<mvc:mapping path="/**"/> <!--对所有controller类里面的所有方法都进行拦截-->
<bean class="com.myproject.interceptor.MyInterceptor1" />
</mvc:interceptor>
<mvc:interceptor>
<mvc:mapping path="/**"/> <!--对所有controller类里面的所有方法都进行拦截-->
<bean class="com.myproject.interceptor.MyInterceptor2" />
</mvc:interceptor>
</mvc:interceptors>
3）测试拦截器的拦截效果
package com.myproject.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class TargetController {
@RequestMapping("/target")
public String targetMethod() {
System.out.println("目标方法执行了。。。");
return "success";
}
}
扫一扫
2387
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
