SpringMVC学习笔记
- 一、SpringMVC简介
- 1、什么是MVC
- 2、什么是SpringMVC
- 3、SpringMVC的特点
- 二、HelloWorld
- 1、开发环境
- 2、创建maven工程
- a>添加web模块
- b>打包方式：war
- c>引入依赖
- 3、配置web.xml(注册前端控制器)
- a>默认配置方式
- b>扩展配置方式（推荐使用）
- 4、创建请求控制器
- 5、创建springMVC的配置文件
- 6、测试HelloWorld
- a>实现对首页的访问
- b>通过超链接跳转到指定页面
- 7、总结
- 三、@RequestMapping注解
- 1、@RequestMapping注解的功能
- 2、@RequestMapping注解的位置
- 3、@RequestMapping注解的value属性
- 4、@RequestMapping注解的method属性
- 5、@RequestMapping注解的params属性（了解）
- 6、@RequestMapping注解的headers属性（了解）
- 7、SpringMVC支持ant风格的路径
- 8、SpringMVC支持路径中的占位符（重点）
- 四、SpringMVC获取请求参数
- 1、通过ServletAPI获取
- 2、通过控制器方法的形参获取请求参数
- 3、@RequestParam
- 4、@RequestHeader
- 5、@CookieValue
- 6、通过POJO获取请求参数
- 7、解决获取请求参数的乱码问题
- 五、域对象共享数据
- 1、使用ServletAPI向request域对象共享数据
- 2、使用ModelAndView向request域对象共享数据(推荐使用)
- 3、使用Model向request域对象共享数据
- 4、使用map向request域对象共享数据
- 5、使用ModelMap向request域对象共享数据
- 6、Model、ModelMap、Map的关系
- 7、向session域共享数据
- 8、向application域共享数据
- 六、SpringMVC的视图
- 1、ThymeleafView
- 2、转发视图
- 3、重定向视图
- 4、视图控制器view-controller
- 5. 视图解析器InternalResourceViewResolver（了解）
- 七、RESTful
- 1、RESTful简介
- a>资源（内容）
- b>资源的表述（什么样的内容）
- c>状态转移（什么样的操作行为）
- 2、RESTful的实现
- 八、RESTful案例
- 1、准备工作
- 2、功能清单
- 3、具体功能：访问首页
- a>配置view-controller
- b>创建页面
- 4、具体功能：查询所有员工数据
- a>控制器方法
- b>创建employee_list.html
- 5、具体功能：删除
- a>创建处理delete请求方式的表单
- b>删除超链接绑定点击事件
- c>控制器方法
- 6、具体功能：跳转到添加数据页面
- b>配置view-controller
- c>创建employee_add.html
- 7、具体功能：执行保存
- a>控制器方法
- 8、具体功能：跳转到更新数据页面
- a>修改超链接
- b>控制器方法
- c>创建employee_update.html
- 9、具体功能：执行更新
- a>控制器方法
- 1、@RequestBody
- 2、RequestEntity
- 3、@ResponseBody
- 4、SpringMVC处理json
- 1、RESTful简介
- 5、SpringMVC处理ajax
- 6、@RestController注解
- 7、ResponseEntity
- 1、文件下载
- 2、文件上传
- 1、拦截器的配置
- 2、拦截器的三个抽象方法
- 3、多个拦截器的执行顺序
- 1、基于配置的异常处理
- 2、基于注解的异常处理
- 1、创建初始化类，代替web.xml
- 2、创建SpringConfig配置类，代替spring的配置文件
- 3、创建WebConfig配置类，代替SpringMVC的配置文件
- 4、测试功能
- 1、SpringMVC常用组件
- 2、DispatcherServlet初始化过程
- a>初始化WebApplicationContext（initWebApplicationContext()方法）
- b>创建WebApplicationContext
- c>DispatcherServlet初始化策略
- 3、DispatcherServlet调用组件处理请求
- a>processRequest()
- b>doService()
- c>doDispatch()
- d>processDispatchResult()
- 4、SpringMVC的执行流程
尚硅谷SpringMVC笔记基础上做的
一、SpringMVC简介
1、什么是MVC
MVC是一种软件架构的思想，将软件按照模型、视图、控制器来划分
M：Model，模型层，指工程中的JavaBean，作用是处理数据
JavaBean分为两类：
- 一类称为实体类Bean：专门存储业务数据的，如 Student、User 等
- 一类称为业务处理 Bean：指 Service 或 Dao 对象，专门用于处理业务逻辑和数据访问。
V：View，视图层，指工程中的html或jsp等页面，作用是与用户进行交互，展示数据
C：Controller，控制层，指工程中的servlet，作用是接收请求和响应浏览器
MVC的工作流程：
用户通过视图层发送请求到服务器，在服务器中请求被Controller接收，Controller调用相应的Model层处理请求，处理完毕将结果返回到Controller，Controller再根据请求处理的结果找到相应的View视图，渲染数据后最终响应给浏览器
2、什么是SpringMVC
SpringMVC是Spring的一个后续产品，是Spring的一个子项目
SpringMVC 是 Spring 为表述层开发提供的一整套完备的解决方案。在表述层框架历经 Strust、WebWork、Strust2 等诸多产品的历代更迭之后，目前业界普遍选择了 SpringMVC 作为 Java EE 项目表述层开发的首选方案。
注：三层架构分为表述层（或表示层）、业务逻辑层、数据访问层，表述层表示前台页面和后台servlet
3、SpringMVC的特点
- Spring 家族原生产品，与 IOC 容器等基础设施无缝对接
- 基于原生的Servlet，通过了功能强大的前端控制器DispatcherServlet，对请求和响应进行统一处理
- 表述层各细分领域需要解决的问题全方位覆盖，提供全面解决方案
- 代码清新简洁，大幅度提升开发效率
- 内部组件化程度高，可插拔式组件即插即用，想要什么功能配置相应组件即可
- 性能卓著，尤其适合现代大型、超大型互联网项目要求
二、HelloWorld
1、开发环境
IDE：idea 2019.2
构建工具：maven3.5.4
服务器：tomcat7
Spring版本：5.3.1
2、创建maven工程
a>添加web模块
b>打包方式：war
c>引入依赖
org.springframework
spring-webmvc
5.3.10
ch.qos.logback
logback-classic
1.2.3
javax.servlet
javax.servlet-api
3.1.0
provided
org.thymeleaf
thymeleaf-spring5
3.0.12.RELEASE
注：由于 Maven 的传递性，我们不必将所有需要的包全部配置依赖，而是配置最顶端的依赖，其他靠传递性导入。（引入一个jar包，Maven会将其依赖的jar包自动导入）
? 如上图，当我们引入 spring-webmvc 包时，会将这个jar包依赖的其他jar自动导入。（如aop、beans等包）
3、配置web.xml(注册前端控制器)
注册SpringMVC的前端控制器DispatcherServlet，对浏览器发送的请求进行统一处理。
a>默认配置方式
此配置作用下，SpringMVC的配置文件默认位于WEB-INF下，默认名称为
springMVC
org.springframework.web.servlet.DispatcherServlet
springMVC
/
? 不匹配jsp请求的原因：因为jsp本身就是一个servlet，所以请求jsp时已经有特定的Servlet来处理该请求（也就是自己），如果用前端控制器处理jsp的话，就不会调用原先jsp所对应的Servlet进行处理。通俗来讲就是，前端控制器是对Servlet进行封装使用的，统一处理浏览器发来的请求，如果再调用servlet的话，就违背了使用前端控制器的初衷。
b>扩展配置方式（推荐使用）
可通过init-param标签设置SpringMVC配置文件的位置和名称，通过load-on-startup标签设置SpringMVC前端控制器DispatcherServlet的初始化时间
springMVC
org.springframework.web.servlet.DispatcherServlet
contextConfigLocation
classpath:springMVC.xml
1
springMVC
/
注：
classpath：对应类路径，src路径下的文件在编译后，都会放到WEB-INF文件下的classes目录中去；若使用Maven进行构建项目时，resources目录就是默认的classpath
标签中使用/和/*的区别： / 所匹配的请求可以是/login或.html或.js或.css方式的请求路径，但是/不能匹配.jsp请求路径的请求
因此就可以避免在访问jsp页面时，该请求被DispatcherServlet处理，从而找不到相应的页面
/* 则能够匹配所有请求，例如在使用过滤器时，若需要对所有请求进行过滤，就需要使用/*的写法
4、创建请求控制器
由于前端控制器对浏览器发送的请求进行了统一的处理，但是具体的请求有不同的处理过程，因此需要创建处理具体请求的类，即请求控制器
请求控制器中每一个处理请求的方法成为控制器方法
因为SpringMVC的控制器由一个POJO（普通的Java类，有getter和setter方法即可）担任，因此需要通过@Controller注解将其标识为一个控制层组件，交给Spring的IoC容器管理，此时SpringMVC才能够识别控制器的存在
@Controller
public class HelloController {
}
5、创建springMVC的配置文件
text/html
application/json
6、测试HelloWorld
a>实现对首页的访问
在请求控制器中创建处理请求的方法
@Controller
public class HelloController {
// @RequestMapping注解：处理请求和控制器方法之间的映射关系
// @RequestMapping注解的value属性可以通过请求地址匹配请求，/ 表示的当前工程的上下文路径
// localhost:8080/springMVC/
// "/" -> /WEB-INF/templates/index.html
// 此时需要在请求控制器中创建处理 /WEB-INF/templates/index.html 请求的方法
@RequestMapping("/")
public String index() {
// 设置视图名称（因为在配置文件中，前缀和后缀已经配置完成）
// Thymeleaf 已经配置好视图的 前缀：/WEB-INF/templates/
// 后缀：.html
return "index";
}
}
b>通过超链接跳转到指定页面
在主页index.html中设置超链接
首页
首页
HelloWorld
在请求控制器中创建处理请求的方法
@RequestMapping("/hello")
public String HelloWorld() {
return "target";
}
7、总结
浏览器发送请求，若请求地址符合前端控制器的url-pattern，该请求就会被前端控制器DispatcherServlet处理。前端控制器会读取SpringMVC的核心配置文件，通过扫描组件找到控制器，将请求地址和控制器中@RequestMapping注解的value属性值进行匹配，若匹配成功，该注解所标识的控制器方法就是处理请求的方法。处理请求的方法需要返回一个字符串类型的视图名称，该视图名称会被视图解析器解析，加上前缀和后缀组成视图的路径，通过Thymeleaf对视图进行渲染，最终转发到视图所对应页面。
三、@RequestMapping注解
1、@RequestMapping注解的功能
从注解名称上我们可以看到，@RequestMapping注解的作用就是将请求和处理请求的控制器方法关联起来，建立映射关系。
SpringMVC 接收到指定的请求，就会来找到在映射关系中对应的控制器方法来处理这个请求。
2、@RequestMapping注解的位置
@RequestMapping标识一个类：设置映射请求的请求路径的初始信息
@RequestMapping标识一个方法：设置映射请求请求路径的具体信息，经常用于不同模块增加命名空间，比如user和admin模块，在类上添加注解后，访问路径就分开为user/list、admin/list
Title
首页测试
测试@RequestMapping("/testRequestMapping")的位置
注意看上面html代码中，超链接的地址！
@Controller
@RequestMapping("/test") // 注解标识一个类的时候，注意路径！
public class RequestMappingController {
//此时请求映射所映射的请求的请求路径为：/test/testRequestMapping
@RequestMapping("/testRequestMapping")
public String testRequestMapping(){
return "success";
}
}
RequestMapping建立映射关系时，是唯一的，也就是不能再出现一个完全相同的请求和被请求的映射关系：如上面代码中，在另一个类中建立同样的映射@RequestMapping("/testRequestMapping")，会报错。
There is already 'requestMappingTest' bean method
3、@RequestMapping注解的value属性
@RequestMapping注解的value属性通过请求的请求地址匹配请求映射
@RequestMapping注解的value属性是一个字符串类型的数组，表示该请求映射能够匹配多个请求地址所对应的请求
@RequestMapping注解的value属性必须设置，至少通过请求地址匹配请求映射
测试@RequestMapping的value属性-->/testRequestMapping
测试@RequestMapping的value属性-->/test
@RequestMapping(
value = {"/testRequestMapping", "/test"}
) // value属性值是一个字符串类型的数组，可以匹配多个请求地址所对应的请求
public String testRequestMapping(){
return "success";
}
4、@RequestMapping注解的method属性
@RequestMapping注解的method属性通过请求的请求方式（get或post）匹配请求映射
@RequestMapping注解的method属性是一个RequestMethod类型的数组，表示该请求映射能够匹配多种请求方式的请求
不设置的话，那就是任意请求都可以，get和post均可。
若当前请求的请求地址满足请求映射的value属性，但是请求方式不满足method属性，则浏览器报错405：Request method 'POST' not supported（请求方式不对）
测试@RequestMapping的value属性-->/test
@RequestMapping(
value = {"/testRequestMapping", "/test"},
method = {RequestMethod.GET, RequestMethod.POST}
)
public String testRequestMapping(){
return "success";
}
注：
1、对于处理指定请求方式的控制器方法，SpringMVC中提供了@RequestMapping的派生注解
处理get请求的映射-->@GetMapping
处理post请求的映射-->@PostMapping
处理put请求的映射-->@PutMapping
处理delete请求的映射-->@DeleteMapping
@GetMapping("test") String getMapping(){ return "hello"; }2、常用的请求方式有get，post，put，delete
但是目前浏览器只支持get和post，若在form表单提交时，为method设置了其他请求方式的字符串（put或delete），则按照默认的请求方式get处理
若要发送put和delete请求，则需要通过spring提供的过滤器HiddenHttpMethodFilter，在RESTful部分会讲到
5、@RequestMapping注解的params属性（了解）
@RequestMapping注解的params属性通过请求的请求参数匹配请求映射，且params设置的参数必须全部满足
@RequestMapping注解的params属性是一个字符串类型的数组，可以通过四种表达式设置请求参数和请求映射的匹配关系
"param"：要求请求映射所匹配的请求必须携带param请求参数
"!param"：要求请求映射所匹配的请求必须不能携带param请求参数
"param=value"：要求请求映射所匹配的请求必须携带param请求参数且param=value
"param!=value"：要求请求映射所匹配的请求必须携带param请求参数但是param!=value
测试@RequestMapping的params属性-->/test
@RequestMapping(
value = {"/testRequestMapping", "/test"}
,method = {RequestMethod.GET, RequestMethod.POST}
,params = {"username","password!=123456"}
)// 要求请求参数必须有 username 和 password，且password的值不能为123456
public String testRequestMapping(){
return "success";
}
注：
若当前请求满足@RequestMapping注解的value和method属性，但是不满足params属性，此时页面回报错400：Parameter conditions "username, password!=123456" not met for actual request parameters: username={admin}, password={123456}
请求参数不符合要求，报错400
6、@RequestMapping注解的headers属性（了解）
@RequestMapping注解的headers属性通过请求的请求头信息匹配请求映射
@RequestMapping注解的headers属性是一个字符串类型的数组，可以通过四种表达式设置请求头信息和请求映射的匹配关系
"header"：要求请求映射所匹配的请求必须携带header请求头信息
"!header"：要求请求映射所匹配的请求必须不能携带header请求头信息
"header=value"：要求请求映射所匹配的请求必须携带header请求头信息且header=value
"header!=value"：要求请求映射所匹配的请求必须携带header请求头信息且header!=value
若当前请求满足@RequestMapping注解的value和method属性，但是不满足headers属性，此时页面显示404错误，即资源未找到。
7、SpringMVC支持ant风格的路径
模糊匹配请求，占位符
？：表示任意的单个字符
*：表示任意的0个或多个字符
**：表示任意的一层或多层目录
注意：在使用**时，只能使用/**/xxx的方式
举例子：
@RequestMapping("/a*a")
public String index(){
return "index";
}
? 只要此时，请求地址是 a拼接一个字符a (如a1a)，控制器就能响应对应请求并进行处理。
8、SpringMVC支持路径中的占位符（重点）
原始方式：/deleteUser?id=1
restful方式（风格）：/deleteUser/1
SpringMVC路径中的占位符常用于RESTful风格中，当请求路径中将某些数据通过路径的方式传输到服务器中，就可以在相应的@RequestMapping注解的value属性中通过占位符{xxx}表示传输的数据，在通过@PathVariable注解，将占位符所表示的数据赋值给控制器方法的形参。
测试路径中的占位符-->/testRest
@RequestMapping("/testRest/{id}/{username}")
public String testRest(@PathVariable("id") String id, @PathVariable("username") String username){
System.out.println("id:"+id+",username:"+username);
return "success";
}
//最终输出的内容为-->id:1,username:admin
四、SpringMVC获取请求参数
1、通过ServletAPI获取
在MVC框架下，不推荐使用原生API来获取参数。
将HttpServletRequest作为控制器方法的形参，此时HttpServletRequest类型的参数表示封装了当前请求的请求报文的对象
@RequestMapping("/testParam")
public String testParam(HttpServletRequest request){
String username = request.getParameter("username");
String password = request.getParameter("password");
System.out.println("username:"+username+",password:"+password);
return "success";
}
http://localhost:8080/Day2/test/servlet?username=jack&password=123456
2、通过控制器方法的形参获取请求参数
在控制器方法的形参位置，设置和请求参数同名的形参，当浏览器发送请求，匹配到请求映射时，在DispatcherServlet中就会将请求参数赋值给相应的形参。（控制器会自动将请求参数的值赋给同名的形参）
测试获取请求参数-->/testParam
@RequestMapping("/testParam")
public String testParam(String username, String password){
System.out.println("username:"+username+",password:"+password);
return "success";
}
注：
若请求所传输的请求参数中有多个同名的请求参数，此时可以在控制器方法的形参中设置字符串数组或者字符串类型的形参接收此请求参数
? 若使用字符串数组类型的形参，此参数的数组中包含了每一个数据（Arrays.toString()方法，如：[值1,值2,值3]）
? 若使用字符串类型的形参，此参数的值为每个数据中间使用逗号拼接的结果（如：值1,值2,值3）
3、@RequestParam
@RequestParam是将请求参数和控制器方法的形参创建映射关系
@RequestParam注解一共有三个属性：
value：指定为形参赋值的请求参数的参数名
required：设置是否必须传输此请求参数，默认值为true
若设置为true时，则当前请求必须传输value所指定的请求参数，若没有传输该请求参数，且没有设置defaultValue属性，则页面报错400：Required String parameter 'xxx' is not present；若设置为false，则当前请求不是必须传输value所指定的请求参数，若没有传输，则注解所标识的形参的值为null
defaultValue：不管required属性值为true或false，当value所指定的请求参数没有传输或传输的值为""时，则使用默认值为形参赋值
@RequestMapping("/testParam")
public String testParam(@RequestParam("username") String name, @RequestParam("pwd") String password){
System.out.println("username:"+name+",password:"+password);
return "success";
}
? 使用@RequestParam注解方式，相较于通过控制器形参获取参数，可以灵活绑定形参，设置赋值时机。
4、@RequestHeader
@RequestHeader是将请求头信息和控制器方法的形参创建映射关系
@RequestHeader注解一共有三个属性：value、required、defaultValue，用法同@RequestParam
5、@CookieValue
@CookieValue是将cookie数据和控制器方法的形参创建映射关系
@CookieValue注解一共有三个属性：value、required、defaultValue，用法同@RequestParam
6、通过POJO获取请求参数
可以在控制器方法的形参位置设置一个实体类类型的形参，此时若浏览器传输的请求参数的参数名和实体类中的属性名一致，那么请求参数就会为此属性赋值。
（注意：请求参数的参数名与实体类中的属性名一致，才赋值）
@RequestMapping("/testpojo")
public String testPOJO(User user){
System.out.println(user);
return "success";
}
//最终结果-->User{id=null, username='张三', password='123', age=23, sex='男', email='123@qq.com'}
7、解决获取请求参数的乱码问题
解决获取请求参数的乱码问题，可以使用SpringMVC提供的编码过滤器CharacterEncodingFilter，
（源码部分：）
protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws ServletException, IOException {
String encoding = this.getEncoding();
if (encoding != null) {//如果encoding不为空，才强制转换编码，所以需要在配置文件中设置encoding的值
if (this.isForceRequestEncoding() || request.getCharacterEncoding() == null) {//这里还有一个判断条件，所以需要将forceResponseEncoding赋值为true，最终才会强制转换编码
request.setCharacterEncoding(encoding);
}
if (this.isForceResponseEncoding()) {
response.setCharacterEncoding(encoding);
}
}
filterChain.doFilter(request, response);
}
但是必须在web.xml中进行注册
CharacterEncodingFilter
org.springframework.web.filter.CharacterEncodingFilter
encoding
UTF-8
forceResponseEncoding
true
CharacterEncodingFilter
/*
注：
SpringMVC中处理编码的过滤器一定要配置到其他过滤器之前，否则无效
五、域对象共享数据
1、使用ServletAPI向request域对象共享数据
原生API的方式：后面四种就是SpringMVC提供的方式
Title
Hello!!!!!!!!!!!!!!!!!!!!!!!
@RequestMapping("/testServletAPI")
public String testServletAPI(HttpServletRequest request){
request.setAttribute("testScope", "hello,servletAPI");
return "success";
}
2、使用ModelAndView向request域对象共享数据(推荐使用)
这段测试的html代码，下面直接使用，不用修改，因为键均为”testScope“，直接看打印结果即可。
Title
Hello!!!!!!!!!!!!!!!!!!!!!!!
@RequestMapping("/testModelAndView")
public ModelAndView testModelAndView(){
/**
* ModelAndView有Model和View的功能
* Model主要用于向请求域共享数据
* View主要用于设置视图，实现页面跳转
*/
ModelAndView mav = new ModelAndView();
//处理模型数据，即向请求域request共享数据
mav.addObject("testScope", "hello,ModelAndView");
//设置视图名称，实现页面跳转
mav.setViewName("success");
return mav;
}
3、使用Model向request域对象共享数据
@RequestMapping("/testModel")
public String testModel(Model model){
model.addAttribute("testScope", "hello,Model");
return "success";
}
4、使用map向request域对象共享数据
@RequestMapping("/testMap")
public String testMap(Map map){
map.put("testScope", "hello,Map");
return "success";
}
5、使用ModelMap向request域对象共享数据
@RequestMapping("/testModelMap")
public String testModelMap(ModelMap modelMap){
modelMap.addAttribute("testScope", "hello,ModelMap");
return "success";
}
6、Model、ModelMap、Map的关系
使用反射的方法查看之间可能存在的关系：
modelMap.getClass().getName();//只是获取实现类的名字
Model、ModelMap、Map类型的参数其实本质上都是 BindingAwareModelMap 类型的（ .getClass().getName() 打印出来结果都一样）
Model、ModelMap、Map类型实例化的结果，都是同一个实现子类BindingAwareModelMap 类型。
public interface Model{}
public class ModelMap extends LinkedHashMap {}
public class ExtendedModelMap extends ModelMap implements Model {}
public class BindingAwareModelMap extends ExtendedModelMap {}
7、向session域共享数据
注意类型是 HttpSession 类型
@RequestMapping("/testSession")
public String testSession(HttpSession session){
session.setAttribute("testSessionScope", "hello,session");
return "success";
}
8、向application域共享数据
@RequestMapping("/testApplication")
public String testApplication(HttpSession session){
// ServletContext代表整个应用的范围，通过它来向application域共享数据
ServletContext application = session.getServletContext();
application.setAttribute("testApplicationScope", "hello,application");
return "success";
}
六、SpringMVC的视图
SpringMVC中的视图是View接口，视图的作用渲染数据，将模型Model中的数据展示给用户。
SpringMVC视图的种类很多，默认有转发视图(InternalResourceView)和重定向视图。(RedirectView)
当工程引入jstl的依赖，转发视图会自动转换为JstlView。
若使用的视图技术为Thymeleaf，在SpringMVC的配置文件中配置了Thymeleaf的视图解析器，由此视图解析器解析之后所得到的是ThymeleafView。
当没有在配置文件中配置视图解析器时，SpringMVC默认使用转发视图。
前四个的条件是在视图是html，当视图是jsp类型时，则视图解析器是InternalResourceViewResolver。
1、ThymeleafView
当控制器方法中所设置的视图名称没有任何前缀时，此时的视图名称会被SpringMVC配置文件中所配置的视图解析器解析。（当控制器返回的视图名称没有前缀时，就会被解析成一个ThymeleafView）
视图名称拼接视图前缀和视图后缀所得到的最终路径，会通过转发的方式实现跳转。
@RequestMapping("/testHello")
public String testHello(){
return "hello";
}
SpringMVC中ThymeleafView配置文件：
2、转发视图
SpringMVC中默认的转发视图是InternalResourceView
SpringMVC中创建转发视图的情况：
当控制器方法中所设置的视图名称以"forward:"为前缀时，创建InternalResourceView视图，此时的视图名称不会被SpringMVC配置文件中所配置的视图解析器解析，而是会将前缀"forward:"去掉，剩余部分作为最终路径通过转发的方式实现跳转。
例如"forward:/"，"forward:/employee"（说白了，就是一个转发，forward: 加上转发路径，记得带上 / ，因为页面在WEB-INF文件夹中，不能通过浏览器进行访问，只能是通过服务器来转发html页面，所以并不会像thymeleaf那样，使用视图解析器进行地址的拼接）
转发能够访问WEB-INF资源文件夹下的文件，但转发不能跨域，只能访问服务器内部的资源。
@RequestMapping("/testForward")
public String testForward(){
return "forward:/testHello";
}
3、重定向视图
SpringMVC中默认的重定向视图是RedirectView
当控制器方法中所设置的视图名称以"redirect:"为前缀时，创建RedirectView视图，此时的视图名称不会被SpringMVC配置文件中所配置的视图解析器解析，而是会将前缀"redirect:"去掉，剩余部分作为最终路径通过重定向的方式实现跳转。
重定向，是浏览器发出的两次请求，所以重定向是能够跨域，访问不同服务器的资源。
注意地址栏的变化：转发视图的话，地址栏是原来的请求地址，而重定向地址的变化，是会变成最终实际显示视图的名称地址。
例如"redirect:/"，"redirect:/employee"
@RequestMapping("/testRedirect")
public String testRedirect(){
return "redirect:/testHello";
}
注：
重定向视图在解析时，会先将redirect:前缀去掉，然后会判断剩余部分是否以/开头，若是则会自动拼接上下文路径
4、视图控制器view-controller
当控制器方法中，仅仅用来实现页面跳转，即只需要设置视图名称时，可以将处理器方法使用view-controller标签进行替代。
替代前，在控制器类中写控制器方法来实现页面跳转：
@RequestMapping("/testView")
public String success(){
return "success";
}
仅仅实现页面跳转时，可以在SpringMVC配置文件中使用view-controller标签进行替代：
注：
当SpringMVC中设置任何一个view-controller时，其他控制器中的请求映射将全部失效，此时需要在SpringMVC的核心配置文件中设置开启mvc注解驱动的标签：
5. 视图解析器InternalResourceViewResolver（了解）
如果视图技术使用的是jsp而不是html，则使用这个视图解析器。springMVC的配置文件如下：
此时，跟前面几节类似，当在控制器方法中返回的视图名称中不含前缀时，或者有forward前缀，则会被解析成为转发视图（InternalResourceView），重定向视图需要 redirect:/视图名 。
七、RESTful
1、RESTful简介
REST：Representational State Transfer，表现层资源状态转移。
一种开发风格，也就是格式。
a>资源（内容）
资源是一种看待服务器的方式，即，将服务器看作是由很多离散的资源组成。每个资源是服务器上一个可命名的抽象概念。因为资源是一个抽象的概念，所以它不仅仅能代表服务器文件系统中的一个文件、数据库中的一张表等等具体的东西，可以将资源设计的要多抽象有多抽象，只要想象力允许而且客户端应用开发者能够理解。与面向对象设计类似，资源是以名词为核心来组织的，首先关注的是名词。一个资源可以由一个或多个URI来标识。URI既是资源的名称，也是资源在Web上的地址。对某个资源感兴趣的客户端应用，可以通过资源的URI与其进行交互。
b>资源的表述（什么样的内容）
资源的表述是一段对于资源在某个特定时刻的状态的描述。可以在客户端-服务器端之间转移（交换）。资源的表述可以有多种格式，例如HTML/XML/JSON/纯文本/图片/视频/音频等等。资源的表述格式可以通过协商机制来确定。请求-响应方向的表述通常使用不同的格式。
c>状态转移（什么样的操作行为）
状态转移说的是：在客户端和服务器端之间转移（transfer）代表资源状态的表述。通过转移和操作资源的表述，来间接实现操作资源的目的。
2、RESTful的实现
具体说，就是 HTTP 协议里面，四个表示操作方式的动词：GET、POST、PUT、DELETE。
它们分别对应四种基本操作：GET 用来获取资源，POST 用来新建资源，PUT 用来更新资源，DELETE 用来删除资源。
REST 风格提倡 URL 地址使用统一的风格设计，从前到后各个单词使用斜杠分开，不使用问号键值对方式携带请求参数，而是将要发送给服务器的数据作为 URL 地址的一部分（将数据用斜杠拼接到URL地址里面），以保证整体风格的一致性。
| 操作 | 传统方式 | REST风格 |
|---|---|---|
| 查询操作 | getUserById?id=1 | user/1-->get请求方式 |
| 保存操作 | saveUser | user-->post请求方式 |
| 删除操作 | deleteUser?id=1 | user/1-->delete请求方式 |
| 更新操作 | updateUser | user-->put请求方式 |
使用RESTFul模拟操作用户资源：代码如下
Title
查询所有用户信息
根据id查询用户信息
@Controller
public class UserController {
/*
* 使用RESTFul风格，模拟用户资源的增删改查
* /user GET 查询所有用户信息
* /user/1 GET 根据用户id查询用户信息
* /user POST 添加用户信息
* /user/1 DELETE 删除用户信息
* /user PUT 修改用户信息
* */
@RequestMapping(value = "/user", method = RequestMethod.GET)
public String getAllUser() {
System.out.println("查询所有用户信息！");
return "hello"; // 查询成功，跳转到hello页面显示
}
@RequestMapping(value = "/user/{id}", method = RequestMethod.GET)
public String getUserById() {
System.out.println("根据id查询用户信息！");
return "hello";
}
@RequestMapping(value = "/user", method = RequestMethod.POST)
public String addUser(String username, String pwd) {
System.out.println("添加用户信息：" + username + " , " + pwd);
return "hello";
}
@RequestMapping(value = "/user", method = RequestMethod.PUT)
public String update(String username, String pwd) {
System.out.println("修改用户信息：" + username + " , " + pwd);
return "hello";
}
}
3、HiddenHttpMethodFilter
由于浏览器只支持发送get和post方式的请求，那么该如何发送put和delete请求呢？
SpringMVC 提供了 HiddenHttpMethodFilter 帮助我们将 POST 请求转换为 DELETE 或 PUT 请求
HiddenHttpMethodFilter 处理put和delete请求的方法为doFilterInternal，要成功转换的话，必须满足以下两个条件：
? 1. 当前请求的请求方式必须为POST。
? 2. 当前请求中，实际传输请求参数_method的值存在，也就是需要进行转换请求方式。
满足以上条件，HiddenHttpMethodFilter 过滤器就会将当前请求的请求方式转换为请求参数_method的值，因此请求参数_method的值才是最终的请求方式。
核心源码：
protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws ServletException, IOException {
HttpServletRequest requestToUse = request;
if ("POST".equals(request.getMethod()) && request.getAttribute("javax.servlet.error.exception") == null) {//当前请求的请求方式是POST
String paramValue = request.getParameter(this.methodParam);//获取当前请求中，请求参数的值（也就是希望最终请求的方式）
if (StringUtils.hasLength(paramValue)) {//如果当前请求，确实需要改变请求方式的话
String method = paramValue.toUpperCase(Locale.ENGLISH);//将真正请求参数_method的值转换为大写
if (ALLOWED_METHODS.contains(method)) {//如果_method的大写结果值在ALLOWED_METHODS中（PUT、DELETE、PATCH），那么就将当前请求方法进行替换
requestToUse = new HiddenHttpMethodFilter.HttpMethodRequestWrapper(request, method);//将POST进行替换_method参数的最终请求参数的值
}
}
}
filterChain.doFilter((ServletRequest)requestToUse, response);//放行，执行最终实际请求方式
}
static {
ALLOWED_METHODS = Collections.unmodifiableList(Arrays.asList(HttpMethod.PUT.name(), HttpMethod.DELETE.name(), HttpMethod.PATCH.name()));
}
在web.xml中注册HiddenHttpMethodFilter
HiddenHttpMethodFilter
org.springframework.web.filter.HiddenHttpMethodFilter
HiddenHttpMethodFilter
/*
注：
目前为止，SpringMVC中提供了两个过滤器：CharacterEncodingFilter和HiddenHttpMethodFilter
在web.xml中注册时，必须先注册CharacterEncodingFilter，再注册HiddenHttpMethodFilter，否则编码过滤器失效。
原因：
在 CharacterEncodingFilter 中通过 request.setCharacterEncoding(encoding) 方法设置字符集的
request.setCharacterEncoding(encoding) 方法要求前面不能有任何获取请求参数的操作
而 HiddenHttpMethodFilter 恰恰有一个获取请求方式的操作：
String paramValue = request.getParameter(this.methodParam);
八、RESTful案例
1、准备工作
和传统 CRUD 一样，实现对员工信息的增删改查。
-
搭建环境
-
准备实体类
package com.atguigu.mvc.bean; public class Employee { private Integer id; private String lastName; private String email; //1 male, 0 female private Integer gender; public Integer getId() { return id; } public void setId(Integer id) { this.id = id; } public String getLastName() { return lastName; } public void setLastName(String lastName) { this.lastName = lastName; } public String getEmail() { return email; } public void setEmail(String email) { this.email = email; } public Integer getGender() { return gender; } public void setGender(Integer gender) { this.gender = gender; } public Employee(Integer id, String lastName, String email, Integer gender) { super(); this.id = id; this.lastName = lastName; this.email = email; this.gender = gender; } public Employee() { } } -
准备dao模拟数据
package com.atguigu.mvc.dao; import java.util.Collection; import java.util.HashMap; import java.util.Map; import com.atguigu.mvc.bean.Employee; import org.springframework.stereotype.Repository; @Repository public class EmployeeDao { private static MapgetAll(){ return employees.values(); } public Employee get(Integer id){ return employees.get(id); } public void delete(Integer id){ employees.remove(id); } }
2、功能清单
| 功能 | URL 地址 | 请求方式 |
|---|---|---|
| 访问首页√ | / | GET |
| 查询全部数据√ | /employee | GET |
| 删除√ | /employee/2 | DELETE |
| 跳转到添加数据页面√ | /toAdd | GET |
| 执行保存√ | /employee | POST |
| 跳转到更新数据页面√ | /employee/2 | GET |
| 执行更新√ | /employee | PUT |
3、具体功能：访问首页
a>配置view-controller
b>创建页面
Title
首页
访问员工信息
4、具体功能：查询所有员工数据
a>控制器方法
@RequestMapping(value = "/employee", method = RequestMethod.GET)
public String getEmployeeList(Model model){
Collection employeeList = employeeDao.getAll();
model.addAttribute("employeeList", employeeList);
return "employee_list";
}
b>创建employee_list.html
Employee Info
Employee Info
id
lastName
email
gender
options(add)
delete
update
5、具体功能：删除
a>创建处理delete请求方式的表单
b>删除超链接绑定点击事件
引入vue.js
删除超链接
delete
通过vue处理点击事件
c>控制器方法
@RequestMapping(value = "/employee/{id}", method = RequestMethod.DELETE)
public String deleteEmployee(@PathVariable("id") Integer id){
employeeDao.delete(id);
/* 这里不能直接填employee，因为会被thymeleaf视图解析器解析，
* 将会去WEB-INF文件中寻找employee.html
* 因此，为了回到能够显示删除数据后的页面，需要使用重定向视图，
* 即访问 地址+/employee ，前端控制器执行对应控制器方法，进行处理
* */
return "redirect:/employee"; // 重定向到显示列表数据页面
}
? 注意：
? @RequestParam 和 @PathVariable 注解是用于从request中接收请求的，两个都可以接收参数，关键点不同的是@RequestParam 是从request里面拿取值，而 @PathVariable 是从一个URI模板里面来填充。
d>在spirngMVC配置文件中开放对静态资源的访问
vue.js被前端控制器拦截了，要使用静态资源，就要开启default-servlet
6、具体功能：跳转到添加数据页面
a>员工信息主页employee_list.html添加add按钮
id
lastName
email
gender
options(add)
b>配置view-controller
当访问指定请求地址 .../toAdd 时，会被thymeleaf视图解析器解析，并转到 employee_add.html 视图。
c>创建employee_add.html
Add Employee
7、具体功能：执行保存
a>控制器方法
用来处理添加数据的请求 ，注意最后应该是重定向视图
@RequestMapping(value = "/employee", method = RequestMethod.POST)
public String addEmployee(Employee employee){
employeeDao.save(employee);
return "redirect:/employee"; //没有指定请求方法时，默认get方法，此时就是查询职员列表数据
}
8、具体功能：跳转到更新数据页面
a>修改超链接
update
b>控制器方法
查询功能，使用get
@RequestMapping(value = "/employee/{id}", method = RequestMethod.GET)
public String getEmployeeById(@PathVariable("id") Integer id, Model model){
Employee employee = employeeDao.get(id);
model.addAttribute("employee", employee);
return "employee_update";
}
c>创建employee_update.html
Update Employee
9、具体功能：执行更新
a>控制器方法
@RequestMapping(value = "/employee", method = RequestMethod.PUT)
public String updateEmployee(Employee employee){
employeeDao.save(employee);
return "redirect:/employee";
}
八、HttpMessageConverter报文信息转换器
HttpMessageConverter，报文信息转换器，将请求报文转换为Java对象，或将Java对象转换为响应报文，对报文数据进行处理。
HttpMessageConverter提供了两个注解和两个类型：
? @RequestBody：将请求报文中的请求体转换为Java对象
? @ResponseBody：将Java对象转换为响应体
? RequestEntity：请求实体
? ResponseEntity：响应实体
1、@RequestBody
@RequestBody可以获取请求体，需要在控制器方法设置一个形参，使用@RequestBody进行标识，当前请求的请求体就会为当前注解所标识的形参赋值
@RequestMapping("/testRequestBody")
public String testRequestBody(@RequestBody String requestBody){
System.out.println("requestBody: "+requestBody);
return "success";
}
输出结果：
requestBody: username=admin&password=123456
2、RequestEntity
RequestEntity封装请求报文的一种类型，需要在控制器方法的形参中设置该类型的形参，当前请求的请求报文就会赋值给该形参，可以通过getHeaders()获取请求头信息，通过getBody()获取请求体信息。
@RequestMapping("/testRequestEntity")
public String testRequestEntity(RequestEntity requestEntity){
// 当前requestEntity表示整个请求报文的信息
System.out.println("请求头: "+requestEntity.getHeaders());
System.out.println("请求体: "+requestEntity.getBody());
return "success";
}
输出结果：
请求头: [host:"localhost:8080", connection:"keep-alive", content-length:"25", cache-control:"max-age=0", sec-ch-ua:""Microsoft Edge";v="95", "Chromium";v="95", ";Not A Brand";v="99"", sec-ch-ua-mobile:"?0", sec-ch-ua-platform:""Windows"", upgrade-insecure-requests:"1", origin:"http://localhost:8080", user-agent:"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.54 Safari/537.36 Edg/95.0.1020.38", accept:"text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,/;q=0.8,application/signed-exchange;v=b3;q=0.9", sec-fetch-site:"same-origin", sec-fetch-mode:"navigate", sec-fetch-user:"?1", sec-fetch-dest:"document", referer:"http://localhost:8080/Day4/testRequestBody", accept-encoding:"gzip, deflate, br", accept-language:"zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6", cookie:"Idea-3f41897f=25b077f5-0023-4dbc-8d35-70b7c6f832ec", Content-Type:"application/x-www-form-urlencoded;charset=UTF-8"]
请求体: username=112&password=123
3、@ResponseBody
@ResponseBody用于标识一个控制器方法，可以将该方法的返回值直接作为响应报文的响应体响应到浏览器。
注意，该注解是标识控制器方法，而不是形参。
测试一：使用注解方式
通过servelet的response对象响应浏览器数据
@RequestMapping("/testResponseBody")
@ResponseBody // 将这个控制器方法的返回值直接作为响应报文的响应体返回给浏览器
public String testResponseBody(){
return "success";
}
结果：浏览器页面显示 success
测试二：使用HttpServletResponse响应浏览器数据
@RequestMapping("/testResponseBody")
public void testResponseBody(HttpServletResponse response) throws IOException {
response.getWriter().println("Hello！");
}
结果：浏览器页面显示 Hello！
4、SpringMVC处理json
错误的处理：
-
html
处理Json数据
-
bean类
public class User { private int id; private String name; private String sex; private int age; public User(int id, String name, String sex, int age) { this.id = id; this.name = name; this.sex = sex; this.age = age; } public int getId() { return id; } public void setId(int id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public String getSex() { return sex; } public void setSex(String sex) { this.sex = sex; } public int getAge() { return age; } public void setAge(int age) { this.age = age; } @Override public String toString() { return "User{" + "id=" + id + ", name='" + name + '\'' + ", sex='" + sex + '\'' + ", age='" + age + '\'' + '}'; } } -
控制器方法：
@RequestMapping("/testJson") @ResponseBody public User testJson(){ return new User(1, "Jack", "男", 23); } -
结果：
HTTP状态 406 - 不可接收
类型 状态报告
描述 根据请求中接收到的主动协商头字段，目标资源没有用户代理可以接受的当前表示，而且服务器不愿意提供缺省表示。
正确处理过程：
@ResponseBody处理json的步骤：
a>在pom.xml配置文件中导入jackson的依赖
com.fasterxml.jackson.core
jackson-databind
2.13.0
b>在SpringMVC的核心配置文件中开启mvc的注解驱动，此时在HandlerAdaptor中会自动装配一个消息转换器：MappingJackson2HttpMessageConverter，可以将响应到浏览器的Java对象转换为Json格式的字符串
? 目前使用到该标签的三次总结：
? 1. 使用view-controller，配置视图控制器，建立请求与视图的映射关系。
? 2. 开放对静态资源的访问。
? 3. 处理Java对象转换为json对象。
c>在处理器方法上使用@ResponseBody注解进行标识
d>将Java对象直接作为控制器方法的返回值返回，就会自动转换为Json格式的字符串
@RequestMapping("/testJson")
@ResponseBody
public User testJson(){
return new User(1, "Jack", "男", 23);
}
浏览器的页面中展示的结果：
{"id":1,"name":"Jack","sex":"男","age":23}
5、SpringMVC处理ajax
a>请求超链接：
b>通过vue和axios处理点击事件：
c>控制器方法：
@RequestMapping("/testAjax")
@ResponseBody
public String testAjax(String username, String password){
System.out.println("username:"+username+",password:"+password);
return "hello,ajax";
}
6、@RestController注解
@RestController注解是springMVC提供的一个复合注解，标识在控制器的类上，就相当于为类添加了@Controller注解，并且为其中的每个方法添加了@ResponseBody注解。
7、ResponseEntity
ResponseEntity用于控制器方法的返回值类型，该控制器方法的返回值就是响应到浏览器的响应报文。
主要用于文件下载，返回给浏览器一个响应实体。
注意，RequestEntity请求实体，则是获取请求体信息，一般用于形参赋值的位置。
九、文件上传和下载
1、文件下载
使用ResponseEntity实现下载文件的功能，将项目中部署到服务器的资源下载到本地
html链接触发：
下载数据
控制器方法：
@RequestMapping("/testDown")
public ResponseEntity testResponseEntity(HttpSession session) throws IOException {
//获取ServletContext对象
ServletContext servletContext = session.getServletContext();
//获取服务器中文件的真实路径，getRealPath()获取服务器当前的部署路径（WEB-INF）
String realPath = servletContext.getRealPath("/static/img/1.jpg");
//创建输入流
InputStream is = new FileInputStream(realPath);
//创建字节数组
byte[] bytes = new byte[is.available()];
//将流读到字节数组中
is.read(bytes);
//创建HttpHeaders对象设置响应头信息
MultiValueMap headers = new HttpHeaders();
//设置要下载方式以及下载文件的名字
headers.add("Content-Disposition", "attachment;filename=1.jpg");
//设置响应状态码
HttpStatus statusCode = HttpStatus.OK;
//创建ResponseEntity对象，bytes=响应体，headers=响应头
ResponseEntity responseEntity = new ResponseEntity<>(bytes, headers, statusCode);
//关闭输入流
is.close();
return responseEntity;
}
2、文件上传
文件上传要求form表单的请求方式必须为post，并且添加属性enctype="multipart/form-data"
SpringMVC中将上传的文件封装到MultipartFile对象中，通过此对象可以获取文件相关信息
上传步骤：
测试文件上传和下载
下载1.jpg
a>添加依赖：
commons-fileupload
commons-fileupload
1.3.1
b>在SpringMVC的配置文件中添加配置：bean标签中id必须为multipartResolver
c>控制器方法：
@RequestMapping("/testUp")
public String testUp(MultipartFile photo, HttpSession session) throws IOException {
// 获取上传的文件的文件名
String fileName = photo.getOriginalFilename();
// 处理文件重名问题
String hzName = fileName.substring(fileName.lastIndexOf(".")); // 取文件名
// 将UUID和后缀名拼接后的结果作为最终的文件名
fileName = UUID.randomUUID().toString() + hzName; // 使用随机数的方式，其实可以使用时间戳
// 获取服务器中photo目录的路径
ServletContext servletContext = session.getServletContext();
String photoPath = servletContext.getRealPath("photo");
File file = new File(photoPath);
// 判断photoPath所对应的路径是否存在
if(!file.exists()){
// 若不存在，则创建目录
file.mkdir();
}
// 最终上传路径 目录+文件分隔符(不清楚到底是/还是\时)+文件名
String finalPath = photoPath + File.separator + fileName;
//实现上传功能
photo.transferTo(new File(finalPath));
return "success";
}
十、拦截器
1、拦截器的配置
SpringMVC中的拦截器用于拦截控制器方法的执行。
SpringMVC中的拦截器需要实现HandlerInterceptor接口。
SpringMVC的拦截器必须在SpringMVC的配置文件中进行配置：
控制器方法：
@Controller
public class InterceptorController {
@RequestMapping("/**/testInterceptor") // ** 表示请求地址可以含一级或多级目录
public String testInterceptor() {
return "success";
}
}
2、拦截器的三个抽象方法
SpringMVC中的拦截器有三个抽象方法：
preHandle：控制器方法执行之前执行preHandle()，其boolean类型的返回值表示是否拦截或放行，返回true为放行，即调用控制器方法；返回false表示拦截，即不调用控制器方法。
postHandle：控制器方法执行之后执行postHandle()
afterComplation：处理完视图和模型数据，渲染视图完毕之后执行afterComplation()
创建一个拦截器类，并实现HandlerInterceptor接口：
@Component(value = "firstInterceptors") // 将实现拦截器接口的类，标识为组件，添加进IOC容器中，以便在拦截器配置文件中进行设置
public class FirstInterceptor implements HandlerInterceptor {
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
System.out.println("FirstInterceptor-->preHandle");
return true; // 如果返回false，拦截器就会进行拦截，就不会往下继续执行
}
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
System.out.println("FirstInterceptor-->postHandle");
}
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
System.out.println("FirstInterceptor-->afterCompletion");
}
}
3、多个拦截器的执行顺序
a> 若每个拦截器的preHandle()都返回true（都放行）
? 此时多个拦截器的执行顺序和拦截器在SpringMVC的配置文件的配置顺序有关：（拦截器执行顺序与配置顺序有关）
? preHandle()会按照配置的顺序执行（因为是将所有拦截器放在一个list集合中进行遍历的），
? 而postHandle()和afterComplation()会按照配置的反序执行（并不是栈的关系）：
b> 若某个拦截器的preHandle()返回了false
? preHandle()返回false，和它之前的拦截器的preHandle()都会执行，postHandle()都不执行(因为有多个拦截器时，先执行完各个拦截器的preHandle()，才会再执行postHanle() )，控制器方法肯定更不会执行，
? 返回false的拦截器之前的拦截器的afterComplation()会执行。
十一、异常处理器
1、基于配置的异常处理
SpringMVC提供了一个处理控制器方法执行过程中所出现的异常的接口：HandlerExceptionResolver
HandlerExceptionResolver接口的实现类有：DefaultHandlerExceptionResolver和SimpleMappingExceptionResolver
SpringMVC提供了自定义的异常处理器SimpleMappingExceptionResolver，使用方式：
exception
? 对于可能出现的异常，可以进行设置，并在异常发生时，跳转到指定的页面，就避免了直接给用户展示一个505状态码等异常页面。
? 控制器方法：该控制器方法会产生一个算术异常，此时这个异常会被异常处理器捕捉。
@RequestMapping("/testException")
public String testException(){
System.out.println(1/0); // 此行代码会产生算术异常，从而执行异常处理器
return "success";
}
? 异常信息页面：该页面是由springMVC配置文件中进行配置，将异常种类与页面进行映射，当前页面是与算术异常进行映射。
Title
Exception：发生异常，跳转到此页面，并打印异常信息
? 效果：
2、基于注解的异常处理
//@ControllerAdvice将当前类标识为异常处理的组件
@ControllerAdvice
public class ExceptionController {
//@ExceptionHandler用于设置所标识方法处理的异常
@ExceptionHandler(ArithmeticException.class) // 这里是算术异常
//ex表示当前请求处理中出现的异常对象
public String handleArithmeticException(Exception exception, Model model){
model.addAttribute("info", exception); // 设置key与异常信息的映射关系
return "exception";
}
}
十二、注解配置SpringMVC
使用配置类和注解代替web.xml和SpringMVC配置文件的功能。
1、创建初始化类，代替web.xml
? 在Servlet3.0环境中，容器会在类路径中查找实现javax.servlet.ServletContainerInitializer接口的类，如果找到的话就用它来配置Servlet容器。
? Spring提供了这个接口的实现，名为SpringServletContainerInitializer，这个类反过来又会查找实现WebApplicationInitializer的类并将配置的任务交给它们来完成。
? Spring3.2引入了一个便利的WebApplicationInitializer基础实现，名为 AbstractAnnotationConfigDispatcherServletInitializer，当我们的类扩展了AbstractAnnotationConfigDispatcherServletInitializer并将其部署到Servlet3.0容器的时候，容器会自动发现它，并用它来配置Servlet上下文。
public class WebInit extends AbstractAnnotationConfigDispatcherServletInitializer {
/**
* 指定spring的配置类（这里是新建的配置类为SpringConfig）
* @return
*/
@Override
protected Class<?>[] getRootConfigClasses() {
return new Class[]{SpringConfig.class};
}
/**
* 指定SpringMVC的配置类（这里是新建配置类WebConfig）
* @return
*/
@Override
protected Class<?>[] getServletConfigClasses() {
return new Class[]{WebConfig.class};
}
/**
* 指定DispatcherServlet的映射规则，即url-pattern
* @return
*/
@Override
protected String[] getServletMappings() {
return new String[]{"/"};
}
/**
* 注册过滤器（ctrl+o 添加重写方法来的）
* @return
*/
@Override
protected Filter[] getServletFilters() {
CharacterEncodingFilter encodingFilter = new CharacterEncodingFilter();
encodingFilter.setEncoding("UTF-8");
encodingFilter.setForceRequestEncoding(true);//这两句是根据源码得到的
HiddenHttpMethodFilter hiddenHttpMethodFilter = new HiddenHttpMethodFilter();//post请求方法的转换，delete、put
return new Filter[]{encodingFilter, hiddenHttpMethodFilter};
}
}
2、创建SpringConfig配置类，代替spring的配置文件
注意！配置文件类，需要用Configuration关键字进行注解。
@Configuration
public class SpringConfig {
//ssm整合之后，spring的配置信息写在此类中
}
3、创建WebConfig配置类，代替SpringMVC的配置文件
注意！配置文件类，需要用Configuration关键字进行注解。
/**
* 代替SpringMVC的配置文件：
* 1、扫描组件 2、视图解析器 3、view-controller 4、default-servlet-handler
* 5、mvc注解驱动 6、文件上传解析器 7、异常处理 8、拦截器
*/
//将当前类标识为一个配置类
@Configuration
//1、扫描组件
@ComponentScan("com.atguigu.mvc.controller")
//5、开启mvc注解驱动
@EnableWebMvc
public class WebConfig implements WebMvcConfigurer {
//4、default-servlet-handler
@Override
public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
configurer.enable(); // 开启默认servlet
}
//8、拦截器
@Override
public void addInterceptors(InterceptorRegistry registry) {
TestInterceptor testInterceptor = new TestInterceptor();
registry.addInterceptor(testInterceptor).addPathPatterns("/**");//添加拦截规则
}
//3、view-controller
@Override
public void addViewControllers(ViewControllerRegistry registry) {
registry.addViewController("/hello").setViewName("hello");//建立请求地址与视图的映射关系
}
//6、文件上传解析器
@Bean
public MultipartResolver multipartResolver(){
CommonsMultipartResolver commonsMultipartResolver = new CommonsMultipartResolver();
return commonsMultipartResolver;
}
//7、异常处理
@Override
public void configureHandlerExceptionResolvers(List resolvers) {
SimpleMappingExceptionResolver exceptionResolver = new SimpleMappingExceptionResolver();
Properties prop = new Properties();
prop.setProperty("java.lang.ArithmeticException", "error");//建立异常与视图的映射关系
exceptionResolver.setExceptionMappings(prop);
exceptionResolver.setExceptionAttribute("exception");//设置请求域中共享异常信息的键
resolvers.add(exceptionResolver);
}
//对比springMVC配置文件，因为配置thymeleaf视图解析器依赖多个类，遵循从内到外的顺序，依次创建bean
//配置生成模板解析器
@Bean
public ITemplateResolver templateResolver() {
WebApplicationContext webApplicationContext = ContextLoader.getCurrentWebApplicationContext();
// ServletContextTemplateResolver需要一个ServletContext作为构造参数，可通过WebApplicationContext 的方法获得
ServletContextTemplateResolver templateResolver = new ServletContextTemplateResolver(
webApplicationContext.getServletContext());
templateResolver.setPrefix("/WEB-INF/templates/");
templateResolver.setSuffix(".html");
templateResolver.setCharacterEncoding("UTF-8");
templateResolver.setTemplateMode(TemplateMode.HTML);
return templateResolver;
}
//生成模板引擎并为模板引擎注入模板解析器
@Bean
public SpringTemplateEngine templateEngine(ITemplateResolver templateResolver) {
SpringTemplateEngine templateEngine = new SpringTemplateEngine();
templateEngine.setTemplateResolver(templateResolver);
return templateEngine;
}
//生成视图解析器并未解析器注入模板引擎
@Bean
public ViewResolver viewResolver(SpringTemplateEngine templateEngine) {
ThymeleafViewResolver viewResolver = new ThymeleafViewResolver();
viewResolver.setCharacterEncoding("UTF-8");
viewResolver.setTemplateEngine(templateEngine);
return viewResolver;
}
}
4、测试功能
@RequestMapping("/")
public String index(){
return "index";
}
十三、SpringMVC执行流程
1、SpringMVC常用组件
- DispatcherServlet：前端控制器，不需要工程师开发，由框架提供
作用：统一处理请求和响应，整个流程控制的中心，由它调用其它组件处理用户的请求
- HandlerMapping：处理器映射器，不需要工程师开发，由框架提供
作用：根据请求的url、method等信息查找Handler，即控制器方法
- Handler：处理器，需要工程师开发
作用：在DispatcherServlet的控制下Handler对具体的用户请求进行处理（控制器方法）
- HandlerAdapter：处理器适配器，不需要工程师开发，由框架提供
作用：通过HandlerAdapter对处理器（控制器方法）进行执行（执行控制器方法）
- ViewResolver：视图解析器，不需要工程师开发，由框架提供
作用：进行视图解析，得到相应的视图，例如：ThymeleafView、InternalResourceView、RedirectView
- View：视图
作用：将模型数据通过页面展示给用户
2、DispatcherServlet初始化过程
DispatcherServlet 本质上是一个 Servlet，所以天然的遵循 Servlet 的生命周期。所以宏观上是 Servlet 生命周期来进行调度。下图展示了，servlet的初始化方法init()：
? DispatcherServlet 继承了 FrameworkServlet，然后FrameworkServlet继承了......
? 注意上图，在IDEA中对于子类重写父类的方法，会有一个向上的箭头，指明这个重写方法是重写的哪个类的方法。
? 上面追踪到initWebApplicationContext()方法后，由于第一次初始化时，wac肯定为null，且要创建WebApplicationContext，所以追踪到这个方法里面：
if (wac == null) {
wac = this.createWebApplicationContext(rootContext);
}
a>初始化WebApplicationContext（initWebApplicationContext()方法）
所在类：org.springframework.web.servlet.FrameworkServlet
protected WebApplicationContext initWebApplicationContext() {
WebApplicationContext rootContext =
WebApplicationContextUtils.getWebApplicationContext(getServletContext());
WebApplicationContext wac = null;
if (this.webApplicationContext != null) {
// A context instance was injected at construction time -> use it
wac = this.webApplicationContext;
if (wac instanceof ConfigurableWebApplicationContext) {
ConfigurableWebApplicationContext cwac = (ConfigurableWebApplicationContext) wac;
if (!cwac.isActive()) {
// The context has not yet been refreshed -> provide services such as
// setting the parent context, setting the application context id, etc
if (cwac.getParent() == null) {
// The context instance was injected without an explicit parent -> set
// the root application context (if any; may be null) as the parent
cwac.setParent(rootContext);
}
configureAndRefreshWebApplicationContext(cwac);
}
}
}
if (wac == null) {
// No context instance was injected at construction time -> see if one
// has been registered in the servlet context. If one exists, it is assumed
// that the parent context (if any) has already been set and that the
// user has performed any initialization such as setting the context id
wac = findWebApplicationContext();
}
if (wac == null) { // 重点！
// No context instance is defined for this servlet -> create a local one
// 创建WebApplicationContext
wac = createWebApplicationContext(rootContext); // 初始化，第一次肯定是要先创建context
}
if (!this.refreshEventReceived) {
// Either the context is not a ConfigurableApplicationContext with refresh
// support or the context injected at construction time had already been
// refreshed -> trigger initial onRefresh manually here.
synchronized (this.onRefreshMonitor) {
// 刷新WebApplicationContext
onRefresh(wac);
}
}
if (this.publishContext) {
// Publish the context as a servlet context attribute.
// 将IOC容器在应用域共享
String attrName = getServletContextAttributeName();
getServletContext().setAttribute(attrName, wac);
}
return wac;
}
b>创建WebApplicationContext
所在类：org.springframework.web.servlet.FrameworkServlet
protected WebApplicationContext createWebApplicationContext(@Nullable ApplicationContext parent) {
Class<?> contextClass = getContextClass();
if (!ConfigurableWebApplicationContext.class.isAssignableFrom(contextClass)) {
throw new ApplicationContextException(
"Fatal initialization error in servlet with name '" + getServletName() +
"': custom WebApplicationContext class [" + contextClass.getName() +
"] is not of type ConfigurableWebApplicationContext");
}
// 通过反射创建 IOC 容器对象
ConfigurableWebApplicationContext wac =
(ConfigurableWebApplicationContext) BeanUtils.instantiateClass(contextClass);
wac.setEnvironment(getEnvironment());
// 设置父容器
wac.setParent(parent);
String configLocation = getContextConfigLocation();
if (configLocation != null) {
wac.setConfigLocation(configLocation);
}
configureAndRefreshWebApplicationContext(wac);
return wac;
}
c>DispatcherServlet初始化策略
FrameworkServlet创建WebApplicationContext后，刷新容器，调用onRefresh(wac)，
此方法在DispatcherServlet中进行了重写，调用了initStrategies(context)方法，初始化策略，即初始化DispatcherServlet的各个组件
所在类：org.springframework.web.servlet.DispatcherServlet
protected void initStrategies(ApplicationContext context) {
initMultipartResolver(context);//初始化文件上传解析器
initLocaleResolver(context);
initThemeResolver(context);
initHandlerMappings(context);//处理器映射器，请求与控制器方法创建映射关系
initHandlerAdapters(context);//执行对应的控制器方法
initHandlerExceptionResolvers(context);//初始化异常处理器
initRequestToViewNameTranslator(context);
initViewResolvers(context);//初始化视图解析器
initFlashMapManager(context);
}
? 所以在配置springMVC的前端控制器DispatcherServlet时，需要将初始化时间提前:
DispatcherServlet
org.springframework.web.servlet.DispatcherServlet
contextConfigLocation
classpath:SpringMVC.xml
1
3、DispatcherServlet调用组件处理请求
a>processRequest()
FrameworkServlet重写HttpServlet中的service()和doXxx()，这些方法中调用了processRequest(request, response)
所在类：org.springframework.web.servlet.FrameworkServlet
protected final void processRequest(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
long startTime = System.currentTimeMillis();
Throwable failureCause = null;
LocaleContext previousLocaleContext = LocaleContextHolder.getLocaleContext();
LocaleContext localeContext = buildLocaleContext(request);
RequestAttributes previousAttributes = RequestContextHolder.getRequestAttributes();
ServletRequestAttributes requestAttributes = buildRequestAttributes(request, response, previousAttributes);
WebAsyncManager asyncManager = WebAsyncUtils.getAsyncManager(request);
asyncManager.registerCallableInterceptor(FrameworkServlet.class.getName(), new RequestBindingInterceptor());
initContextHolders(request, localeContext, requestAttributes);
try {
// 执行服务，doService()是一个抽象方法，在DispatcherServlet中进行了重写
doService(request, response);
}
catch (ServletException | IOException ex) {
failureCause = ex;
throw ex;
}
catch (Throwable ex) {
failureCause = ex;
throw new NestedServletException("Request processing failed", ex);
}
finally {
resetContextHolders(request, previousLocaleContext, previousAttributes);
if (requestAttributes != null) {
requestAttributes.requestCompleted();
}
logResult(request, response, failureCause, asyncManager);
publishRequestHandledEvent(request, response, startTime, failureCause);
}
}
b>doService()
所在类：org.springframework.web.servlet.DispatcherServlet
@Override
protected void doService(HttpServletRequest request, HttpServletResponse response) throws Exception {
logRequest(request);
// Keep a snapshot of the request attributes in case of an include,
// to be able to restore the original attributes after the include.
Map attributesSnapshot = null;
if (WebUtils.isIncludeRequest(request)) {
attributesSnapshot = new HashMap<>();
Enumeration<?> attrNames = request.getAttributeNames();
while (attrNames.hasMoreElements()) {
String attrName = (String) attrNames.nextElement();
if (this.cleanupAfterInclude || attrName.startsWith(DEFAULT_STRATEGIES_PREFIX)) {
attributesSnapshot.put(attrName, request.getAttribute(attrName));
}
}
}
// Make framework objects available to handlers and view objects.
request.setAttribute(WEB_APPLICATION_CONTEXT_ATTRIBUTE, getWebApplicationContext());
request.setAttribute(LOCALE_RESOLVER_ATTRIBUTE, this.localeResolver);
request.setAttribute(THEME_RESOLVER_ATTRIBUTE, this.themeResolver);
request.setAttribute(THEME_SOURCE_ATTRIBUTE, getThemeSource());
if (this.flashMapManager != null) {
FlashMap inputFlashMap = this.flashMapManager.retrieveAndUpdate(request, response);
if (inputFlashMap != null) {
request.setAttribute(INPUT_FLASH_MAP_ATTRIBUTE, Collections.unmodifiableMap(inputFlashMap));
}
request.setAttribute(OUTPUT_FLASH_MAP_ATTRIBUTE, new FlashMap());
request.setAttribute(FLASH_MAP_MANAGER_ATTRIBUTE, this.flashMapManager);
}
RequestPath requestPath = null;
if (this.parseRequestPath && !ServletRequestPathUtils.hasParsedRequestPath(request)) {
requestPath = ServletRequestPathUtils.parseAndCache(request);
}
try {
// 处理请求和响应
doDispatch(request, response);
}
finally {
if (!WebAsyncUtils.getAsyncManager(request).isConcurrentHandlingStarted()) {
// Restore the original attribute snapshot, in case of an include.
if (attributesSnapshot != null) {
restoreAttributesAfterInclude(request, attributesSnapshot);
}
}
if (requestPath != null) {
ServletRequestPathUtils.clearParsedRequestPath(request);
}
}
}
c>doDispatch()
所在类：org.springframework.web.servlet.DispatcherServlet
protected void doDispatch(HttpServletRequest request, HttpServletResponse response) throws Exception {
HttpServletRequest processedRequest = request;
HandlerExecutionChain mappedHandler = null;
boolean multipartRequestParsed = false;
WebAsyncManager asyncManager = WebAsyncUtils.getAsyncManager(request);
try {
ModelAndView mv = null;
Exception dispatchException = null;
try {
processedRequest = checkMultipart(request);
multipartRequestParsed = (processedRequest != request);
// Determine handler for the current request.
/*
mappedHandler：调用链
包含handler、interceptorList、interceptorIndex
handler：浏览器发送的请求所匹配的控制器方法
interceptorList：处理控制器方法的所有拦截器集合
interceptorIndex：拦截器索引，控制拦截器afterCompletion()的执行
*/
mappedHandler = getHandler(processedRequest);
if (mappedHandler == null) {
noHandlerFound(processedRequest, response);
return;
}
// Determine handler adapter for the current request.
// 通过控制器方法创建相应的处理器适配器，调用所对应的控制器方法
HandlerAdapter ha = getHandlerAdapter(mappedHandler.getHandler());
// Process last-modified header, if supported by the handler.
String method = request.getMethod();
boolean isGet = "GET".equals(method);
if (isGet || "HEAD".equals(method)) {
long lastModified = ha.getLastModified(request, mappedHandler.getHandler());
if (new ServletWebRequest(request, response).checkNotModified(lastModified) && isGet) {
return;
}
}
// 调用拦截器的preHandle()
if (!mappedHandler.applyPreHandle(processedRequest, response)) {
return;
}
// Actually invoke the handler.
// 由处理器适配器调用具体的控制器方法，最终获得ModelAndView对象
mv = ha.handle(processedRequest, response, mappedHandler.getHandler());
if (asyncManager.isConcurrentHandlingStarted()) {
return;
}
applyDefaultViewName(processedRequest, mv);
// 调用拦截器的postHandle()
mappedHandler.applyPostHandle(processedRequest, response, mv);
}
catch (Exception ex) {
dispatchException = ex;
}
catch (Throwable err) {
// As of 4.3, we're processing Errors thrown from handler methods as well,
// making them available for @ExceptionHandler methods and other scenarios.
dispatchException = new NestedServletException("Handler dispatch failed", err);
}
// 后续处理：处理模型数据和渲染视图
processDispatchResult(processedRequest, response, mappedHandler, mv, dispatchException);
}
catch (Exception ex) {
triggerAfterCompletion(processedRequest, response, mappedHandler, ex);
}
catch (Throwable err) {
triggerAfterCompletion(processedRequest, response, mappedHandler,
new NestedServletException("Handler processing failed", err));
}
finally {
if (asyncManager.isConcurrentHandlingStarted()) {
// Instead of postHandle and afterCompletion
if (mappedHandler != null) {
mappedHandler.applyAfterConcurrentHandlingStarted(processedRequest, response);
}
}
else {
// Clean up any resources used by a multipart request.
if (multipartRequestParsed) {
cleanupMultipart(processedRequest);
}
}
}
}
d>processDispatchResult()
private void processDispatchResult(HttpServletRequest request, HttpServletResponse response,
@Nullable HandlerExecutionChain mappedHandler, @Nullable ModelAndView mv,
@Nullable Exception exception) throws Exception {
boolean errorView = false;
if (exception != null) {
if (exception instanceof ModelAndViewDefiningException) {
logger.debug("ModelAndViewDefiningException encountered", exception);
mv = ((ModelAndViewDefiningException) exception).getModelAndView();
}
else {
Object handler = (mappedHandler != null ? mappedHandler.getHandler() : null);
mv = processHandlerException(request, response, handler, exception);
errorView = (mv != null);
}
}
// Did the handler return a view to render?
if (mv != null && !mv.wasCleared()) {
// 处理模型数据和渲染视图
render(mv, request, response);
if (errorView) {
WebUtils.clearErrorRequestAttributes(request);
}
}
else {
if (logger.isTraceEnabled()) {
logger.trace("No view rendering, null ModelAndView returned.");
}
}
if (WebAsyncUtils.getAsyncManager(request).isConcurrentHandlingStarted()) {
// Concurrent handling started during a forward
return;
}
if (mappedHandler != null) {
// Exception (if any) is already handled..
// 调用拦截器的afterCompletion()
mappedHandler.triggerAfterCompletion(request, response, null);
}
}
4、SpringMVC的执行流程
-
用户向服务器发送请求，请求被SpringMVC 前端控制器 DispatcherServlet捕获。
-
DispatcherServlet对请求URL进行解析，得到请求资源标识符（URI），判断请求URI对应的映射：
a) 不存在
i. 再判断是否配置了mvc:default-servlet-handler（可能是需要访问静态资源，如js、html、css、image等，通过使用默认servlet处理静态资源请求）
ii. 如果没配置默认servlet，则控制台报映射查找不到，客户端展示404错误
iii. 如果有配置，请求会被 DispatcherServlet 先处理，要是访问目标资源（一般为静态资源，如：JS,CSS,HTML），交给默认servlet，找不到客户端也会展示404错误
b) 存在映射，则执行下面的流程
-
根据该URI，调用HandlerMapping获得该Handler配置的所有相关的对象（包括Handler对象(控制器方法)以及Handler对象对应的拦截器），最后以HandlerExecutionChain执行链对象的形式返回。
-
DispatcherServlet 根据获得的Handler，选择一个合适的HandlerAdapter。
-
如果成功获得HandlerAdapter，此时将开始执行拦截器的preHandler(…)方法【顺序执行，拦截器先执行preHandler，再执行控制器方法】
-
提取Request中的模型数据，填充Handler入参(填充控制器方法形参)，开始执行Handler（Controller)方法，处理请求。在填充Handler的入参过程中，根据你的配置，Spring将帮你做一些额外的工作：
a) HttpMessageConveter： 将请求消息（如Json、xml等数据）转换成一个对象，将对象转换为指定的响应信息
b) 数据转换：对请求消息进行数据转换。如String转换成Integer、Double等
c) 数据格式化：对请求消息进行数据格式化。 如将字符串转换成格式化数字或格式化日期等
d) 数据验证： 验证数据的有效性（长度、格式等），验证结果存储到BindingResult或Error中
- Handler执行完成后，向DispatcherServlet 返回一个ModelAndView对象。
- 此时将开始执行拦截器的postHandle(...)方法【倒序处理】。
- 根据返回的ModelAndView（此时会判断是否存在异常：如果存在异常，则执行HandlerExceptionResolver进行异常处理）选择一个适合的ViewResolver进行视图解析（转发视图、重定向视图、thymeleaf视图），根据Model和View，来渲染视图。
- 渲染视图完毕执行拦截器的afterCompletion(…)方法【逆向】。
- 将渲染结果返回给客户端。