SpringMVC

SpringMVC简介

SpringMVC概述

SpringMVC 是一种基于 Java 的实现 MVC 设计模型的请求驱动类型的轻量级 Web 框架，属于 SpringFrameWork 的后续产品，已经融合在 Spring Web Flow 中。

SpringMVC 已经成为目前最主流的MVC框架之一，并且随着Spring3.0 的发布，全面超越 Struts2，成为最优秀的 MVC 框架。它通过一套注解，让一个简单的 Java 类成为处理请求的控制器，而无须实现任何接口。同时它还支持 RESTful 编程风格的请求。

SpringMVC快速入门

需求：客户端发起请求，服务器端接收请求，执行逻辑并进行视图跳转。

开发步骤：

导入SpringMVC相关坐标
配置SpringMVC核心控制器DispathcerServlet
创建Controller类和视图页面
使用注解配置Controller类中业务方法的映射地址
配置SpringMVC核心文件 spring-mvc.xml
客户端发起请求测试

导入Spring和SpringMVC的坐标

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>5.0.5.RELEASE</version>
</dependency>

导入Servlet和Jsp的坐标

<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>3.1.0</version>
    <scope>provided</scope>
</dependency>
<dependency>
    <groupId>javax.servlet.jsp</groupId>
    <artifactId>javax.servlet.jsp-api</artifactId>
    <version>2.2.1</version>
    <scope>provided</scope>
</dependency>

在web.xml配置SpringMVC的核心控制器

<servlet>
    <servlet-name>DispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:spring-mvc.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>DispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

创建Controller和业务方法

package com.kiang.controller;

public class UserController {
    public String save() {
        System.out.println("Controller save running......");
        return "success.jsp";
    }
}

创建视图页面success.jsp

<html>
    <head>
        <title>Title</title>
    </head>
    <body>
        <h1>Success</h1>
    </body>
</html>

配置注解

package com.kiang.controller;

@Controller
public class UserController {
    @RequestMapping("/quick")
    public String save() {
        System.out.println("Controller save running......");
        return "success.jsp";
    }
}

创建spring-mvc.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
                           http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">

    <context:component-scan base-package="com.kiang.controller"/>
</beans>

访问测试地址

http://localhost:8080/KiangSpringMVC_war_exploded/

http://localhost:8080/KiangSpringMVC_war_exploded/quick

SpringMVC流程图示

SpringMVC 组件解析

SpringMVC的执行流程

用户发送请求至前端控制器DispatcherServlet。
DispatcherServlet收到请求调用HandlerMapping处理器映射器。
处理器映射器找到具体的处理器(可以根据xml配置、注解进行查找)，生成处理器对象及处理器拦截器(如果有则生成)一并返回给DispatcherServlet。
DispatcherServlet调用HandlerAdapter处理器适配器。
HandlerAdapter经过适配调用具体的处理器(Controller，也叫后端控制器)。
Controller执行完成返回ModelAndView。
HandlerAdapter将controller执行结果ModelAndView返回给DispatcherServlet。
DispatcherServlet将ModelAndView传给ViewReslover视图解析器。
ViewReslover解析后返回具体View。
DispatcherServlet根据View进行渲染视图（即将模型数据填充至视图中）。DispatcherServlet响应用户。

SpringMVC组件解析

前端控制器：DispatcherServlet

用户请求到达前端控制器，它就相当于 MVC 模式中的 C，DispatcherServlet 是整个流程控制的中心，由它调用其它组件处理用户的请求，DispatcherServlet 的存在降低了组件之间的耦合性。
处理器映射器：HandlerMapping

HandlerMapping 负责根据用户请求找到 Handler 即处理器，SpringMVC 提供了不同的映射器实现不同的映射方式，例如：配置文件方式，实现接口方式，注解方式等。
处理器适配器：HandlerAdapter

通过 HandlerAdapter 对处理器进行执行，这是适配器模式的应用，通过扩展适配器可以对更多类型的处理器进行执行。
处理器：Handler

它就是我们开发中要编写的具体业务控制器。由 DispatcherServlet 把用户请求转发到 Handler。由 Handler 对具体的用户请求进行处理。
视图解析器：View Resolver

View Resolver 负责将处理结果生成 View 视图，View Resolver 首先根据逻辑视图名解析成物理视图名，即具体的页面地址，再生成 View 视图对象，最后对 View 进行渲染将处理结果通过页面展示给用户。
视图：View

SpringMVC 框架提供了很多的 View 视图类型的支持，包括：jstlView、freemarkerView、pdfView等。最常用的视图就是 jsp。一般情况下需要通过页面标签或页面模版技术将模型数据通过页面展示给用户，需要由程序员根据业务需求开发具体的页面。

SpringMVC注解解析

@RequestMapping

作用：用于建立请求 URL 和处理请求方法之间的对应关系

位置：

类上，请求URL 的第一级访问目录。此处不写的话，就相当于应用的根目录
方法上，请求 URL 的第二级访问目录，与类上的使用@ReqquestMapping标注的一级目录一起组成访问虚拟路径

属性：

value：用于指定请求的URL。它和path属性的作用是一样的
method：用于指定请求的方式
params：用于指定限制请求参数的条件。它支持简单的表达式。要求请求参数的key和value必须和配置的一模一样

mvc命名空间引入

命名空间：

xmlns:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc"

约束地址：

http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd
http://www.springframework.org/schema/mvc 
http://www.springframework.org/schema/mvc/spring-mvc.xsd

组件扫描

SpringMVC基于Spring容器，所以在进行SpringMVC操作时，需要将Controller存储到Spring容器中，如果使用@Controller注解标注的话，就需要进行组件扫描:

<context:component-scan base-package="com.kiang.controller"/>

SpringMVC的XML配置解析

视图解析器

SpringMVC有默认组件配置，默认组件都是DispatcherServlet.properties配置文件中配置的，该配置文件地址 org/springframework/web/servlet/DispatcherServlet.properties，该文件中配置了默认的视图解析器，如下：

org.springframework.web.servlet.ViewResolver=org.springframework.web.servlet.view.InternalResourceViewResolver

翻看该解析器源码，可以看到该解析器的默认设置，如下：

REDIRECT_URL_PREFIX = "redirect:" //重定向前缀
FORWARD_URL_PREFIX = "forward:" //转发前缀（默认值）
prefix = ""; //视图名称前缀
suffix = ""; //视图名称后缀

我们可以通过属性注入的方式修改视图的的前后缀：

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <property name="prefix" value="/WEB-INF/views/"></property>
    <property name="suffix" value=".jsp"></property>
</bean>

SpringMVC的数据响应

SpringMVC的数据响应方式

页面跳转
- 直接返回字符串
- 通过ModelAndView对象返回
回写数据
- 直接返回字符串
- 返回对象或集合

页面跳转

返回字符串形式

即上述视图解析器

返回ModelAndView对象

@RequestMapping("/quick1")
public ModelAndView save1() {
    ModelAndView modelAndView = new ModelAndView();
    modelAndView.setViewName("success");
    return modelAndView;
}

向request域存储数据

通过ModelAndView的addObject()方法设置

@RequestMapping("/quick2")
public ModelAndView save2() {
    ModelAndView modelAndView = new ModelAndView();
    modelAndView.addObject("username","test2");
    modelAndView.setViewName("success");
    return modelAndView;
}

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
    <head>
        <title>Title</title>
    </head>
    <body>
        <h1>Success ${username}</h1>
    </body>
</html>

通过SpringMVC框架注入的request对象setAttribute()方法设置

@RequestMapping("/quick3")
public String save3(HttpServletRequest request) {
    request.setAttribute("username","test3");
    return "success";
}

实际上以下方式都可以，谁调用谁传形参，SpringMVC框架调用会自动创建对象并传入，常用下列方法：

@RequestMapping("/quick5")
public String save5(Model model) {
    model.addAttribute("username","test5");
    return "success";
}

@RequestMapping("/quick4")
public ModelAndView save4(ModelAndView modelAndView) {
    modelAndView.addObject("username","test4");
    modelAndView.setViewName("success");
    return modelAndView;
}

回写数据

直接返回字符串

通过SpringMVC框架注入的response对象，使用response.getWriter().print(“hello world”) 回写数据，此时不需要视图跳转，业务方法返回值为void。
```
@RequestMapping("/quick6")
public void save6(HttpServletResponse response) throws IOException {
    response.getWriter().print("hello world");
}
```
将需要回写的字符串直接返回，但此时需要通过@ResponseBody注解告知SpringMVC框架，方法返回的字符串不是跳转是直接在http响应体中返回。
```
@RequestMapping("/quick7")
@ResponseBody
public String save7() {
    return "hello world7";
}
```
在异步项目中，客户端与服务器端往往要进行json格式字符串交互，此时我们可以手动拼接json字符串返回。
```
@RequestMapping("/quick8")
@ResponseBody
public String save8() {
    return "{\"name\":\"zhangsan\",\"age\":18}";
}
```

通过jackson转换json格式字符串，回写字符串。

导入jackson坐标

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-core</artifactId>
    <version>2.9.0</version>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.9.0</version>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-annotations</artifactId>
    <version>2.9.0</version>
</dependency>

写个User类

package com.kiang.domain;

public class User {
    private String username;
    private int age;

/*
补齐
set
get
tostring
*/
}

用jackson

@RequestMapping("/quick9")
@ResponseBody
public String save9() throws JsonProcessingException {
    User user = new User();
    user.setUsername("kiang");
    user.setAge(22);
    ObjectMapper objectMapper = new ObjectMapper();
    String json = objectMapper.writeValueAsString(user);
    return json;
}

返回对象或集合

通过SpringMVC帮助我们对对象或集合进行json字符串的转换并回写，为处理器适配器配置消息转换参数，指定使用jackson进行对象或集合的转换，因此需要在spring-mvc.xml中进行如下配置：

<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
    <property name="messageConverters">
        <list>
            <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">
            </bean>
        </list>
    </property>
</bean>

@RequestMapping("/quick10")
@ResponseBody
public User save10() throws JsonProcessingException {
    User user = new User();
    user.setUsername("kiang");
    user.setAge(22);
    return user;
}

在方法上添加@ResponseBody就可以返回json格式的字符串，但是这样配置比较麻烦，配置的代码比较多，因此，我们可以使用mvc的注解驱动代替上述配置。

<!--命名空间配置-->
xmlns:mvc="http://www.springframework.org/schema/mvc"
xsi:schemaLocation="http://www.springframework.org/schema/mvc 		
                    http://www.springframework.org/schema/mvc/spring-mvc.xsd"

<mvc:annotation-driven/>

SpringMVC获得请求数据

获得请求参数

SpringMVC可以接收如下类型的参数：

基本类型参数
POJO类型参数
数组类型参数
集合类型参数

获得基本类型参数

Controller中的业务方法的参数名称要与请求参数的name一致，参数值会自动映射匹配。

http://localhost:8080/quick11?username=22&age=18

@RequestMapping("/quick11")
@ResponseBody
public void save11(String username,int age) {
    System.out.println(username);
    System.out.println(age);
}

获得POJO类型参数

Controller中的业务方法的POJO参数的属性名与请求参数的name一致，参数值会自动映射匹配。

http://localhost:8080/quick12?username=22&age=18

@RequestMapping("/quick12")
@ResponseBody
public void save12(User user) {
    System.out.println(user);
}

获得数组类型参数

http://localhost:8080/quick13?strs=a&strs=b&strs=c

@RequestMapping("/quick13")
@ResponseBody
public void save13(String[] strs) {
    System.out.println(Arrays.asList(strs));
}

获得集合类型参数

获得集合参数时，要将集合参数包装到一个POJO中才可以。

写个VO类

package com.kiang.domain;

public class VO {
    private List<User> userList;
/*
get
set
tostring补齐
*/
}

写个能用post的页面

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
    <form action="${pageContext.request.contextPath}/quick14" method="post">
        <input type="text" name="userList[0].username"><br>
        <input type="text" name="userList[0].age"><br>
        <input type="text" name="userList[1].username"><br>
        <input type="text" name="userList[1].age"><br>
        <input type="submit" value="提交"><br>
    </form>
</body>
</html>

@RequestMapping("/quick14")
@ResponseBody
public void save14(VO vo) {
    System.out.println(vo.getUserList());
}

当使用ajax提交时，可以指定contentType为json形式，那么在方法参数位置使用@RequestBody可以直接接收集合数据而无需使用POJO进行包装。

写个ajax，注意要导jquery

<html>
<head>
    <title>Title</title>
</head>
<body>
    <script src="${pageContext.request.contextPath}/js/jquery-3.3.1.js"></script>
    <script>
        var userList = new Array();
        userList.push({username: "a", age: 18});
        userList.push({username: "b", age: 19});

        $.ajax({
            type:"POST",
            url:"${pageContext.request.contextPath}/quick15",
            data:JSON.stringify(userList),
            contentType:"application/json;charset=utf-8"
        })
    </script>
</body>
</html>

@RequestMapping("/quick15")
@ResponseBody
public void save15(@RequestBody List<User> userList) {
    System.out.println(userList);
}

jquery加载不进去，原因是SpringMVC的前端控制器 DispatcherServlet的url-pattern 配置的是/,代表对所有的资源都进行过滤操作，我们可以通过以下两种方式指定放行静态资源：

在spring-mvc.xml配置文件中指定放行的资源

<mvc:resources mapping="/js/**" location="/js/"/>

使用 <mvc:default-servlet-handler/> 标签

请求数据乱码问题

当post请求时，数据会出现乱码，我们可以在web.xml设置一个过滤器来进行编码的过滤。

  <filter>
    <filter-name>CharacterEncodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param>
      <param-name>encoding</param-name>
      <param-value>UTF-8</param-value>
    </init-param>
  </filter>
  <filter-mapping>
    <filter-name>CharacterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>

参数绑定注解@requestParam

当请求的参数名称与Controller的业务方法参数名称不一致时，就需要通过@RequestParam注解显示的绑定。

http://localhost:8080/quick16?name=a

@RequestMapping("/quick16")
@ResponseBody
public void save16(@RequestParam(value="name") String username) {
    System.out.println(username);
}

注解@RequestParam还有如下参数可以使用：

value：与请求参数名称
required：此在指定的请求参数是否必须包括，默认是true，提交时如果没有此参数则报错
defaultValue：当没有指定请求参数时，则使用指定的默认值赋值

获得Restful风格的参数

Rest风格

Restful是一种软件架构风格、设计风格，而不是标准，只是提供了一组设计原则和约束条件。主要用于客户端和服务器交互类的软件，基于这个风格设计的软件可以隐藏资源访问行为，更简洁，更有层次，更易于实现缓存机制等。

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

GET：用于获取资源
POST：用于新建资源
PUT：用于更新资源
DELETE：用于删除资源

例如：

```
http://localhost/users (使用GET)
```
查询全部用户信息
```
http://localhost/users/1 (使用GET)
```
查询 id = 1 的用户信息
```
http://localhost/users (使用POST)
```

添加用户信息

```
http://localhost/users (使用PUT)
```
修改用户信息

http://localhost/users/1 (使用DELETE)

删除id = 1 的用户信息

根据REST风格对资源进行访问称为RESTful

基本使用

http://localhost:8080/quick17/zhangsan (使用POST)

@RequestMapping(value = "/quick17/{username}", method = RequestMethod.POST)
@ResponseBody
public void save17(@PathVariable(value = "username") String username) {
    System.out.println(username);
}

需要通过@RequestMapping注解的method属性设定请求动作，用于区分行为
获取参数需要在路径后设置和形参同名的占位符
形参前需要加相应的注解，用于绑定路径参数与处理器方法形参间的关系，三种形参注解：
- ＠RequestParam：用于接收url地址传参或表单传参
- ＠RequestBody：用于接收json数据
- ＠PathVariable：用于接收路径参数，使用 {参数名称} 描述路径参数

简化

多个方法的 @RequestMapping 注解的 value 值相同则可以直接写到类名上，方法上只写 method 即可
多个方法都需要 @ResponseBody 注解也可以写到类名上
类上的 @Controller + @ResponseBody 可以替换为 @RestController
可以使用 @PostMapping、@PutMapping、@GetMapping、@DeleteMapping 替换相应的 @RequestMapping

//@Controller
//@ResponseBody
@RestController
@RequestMapping(value = "/books")
public class BookController {
    
    //@RequestMapping(value = "/books/{bookname}", method = RequestMethod.POST)
    //@ResponseBody
    @PostMapping("/{bookname}")
    public void save(@PathVariable(value = "bookname") String username) {
        System.out.println(username);
    }
    
    //@RequestMapping(value = "/books", method = RequestMethod.PUT)
    //@ResponseBody
    @PutMapping
    public void update(@RequestBody Book book) {
        System.out.println("更新" + book)
    }
    
    //@RequestMapping(value = "/books", method = RequestMethod.GET)
    //@ResponseBody
    @GetMapping
    public void getAll() {
        System.out.println("get all......")
    }
}

自定义类型转换器

SpringMVC 默认已经提供了一些常用的类型转换器，例如客户端提交的字符串转换成int型进行参数设置。但是不是所有的数据类型都提供了转换器，没有提供的就需要自定义转换器，例如：日期类型的数据就需要自定义转换器。

自定义类型转换器的开发步骤：

定义转换器类实现Converter接口

package com.kiang.converter;

public class DateConverter implements Converter<String, Date> {
    public Date convert(String dateStr) {
        SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");
        Date date=null;
        try {
            date = format.parse(dateStr);
        }
        catch (ParseException e) {
            e.printStackTrace();
        }
        return date;
    }
}

注意是import org.springframework.core.convert.converter.Converter;

在配置文件spring-mvc.xml中声明转换器

<bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean">
    <property name="converters">
        <list>
            <bean class="com.kiang.converter.DateConverter"/>
        </list>
    </property>
</bean>

在<annotation-driven>中引用转换器

<mvc:annotation-driven conversion-service="conversionService"/>

http://localhost:8080/quick18?date=2022-03-19

@RequestMapping("/quick18")
@ResponseBody
public void save18(Date date) {
    System.out.println(date);
}

获得Servlet相关API

如上所讲，SpringMVC支持使用原始ServletAPI对象作为控制器方法的参数进行注入，常用的对象如下：

HttpServletRequest
HttpServletResponse
HttpSession

获得请求头

@RequestHeader

使用@RequestHeader可以获得请求头信息，相当于web阶段学习的request.getHeader(name) @RequestHeader注解的属性如下：

value：请求头的名称
required：是否必须携带此请求头

http://localhost:8080/quick19

@RequestMapping("/quick19")
@ResponseBody
public void save19(@RequestHeader(value = "User-Agent",required = false) String user_agent) {
    System.out.println(user_agent);
}

@CookieValue

使用@CookieValue可以获得指定Cookie的值

@CookieValue注解的属性如下：

value：指定cookie的名称
required：是否必须携带此cookie

http://localhost:8080/quick20

@RequestMapping("/quick20")
@ResponseBody
public void save20(@CookieValue(value = "JSESSIONID") String jsessionID) {
    System.out.println(jsessionID);
}

文件上传

文件上传客户端三要素

表单项 type=“file”
表单的提交方式是 post
表单的 enctype 属性是多部分表单形式，及 enctype=“multipart/form-data”

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
<form action="${pageContext.request.contextPath}/quick21" method="post" enctype="multipart/form-data">
    名称<input type="text" name="username"><br>
    文件<input type="file" name="uploadFile"><br>
    <input type="submit" name="提交"><br>
</form>
</body>
</html>

文件上传原理

当form表单修改为多部分表单时，request.getParameter()将失效。
enctype=“application/x-www-form-urlencoded”时，form表单的正文内容格式是： key=value&key=value&key=value
当form表单的enctype取值为Mutilpart/form-data时，请求正文内容就变成多部分形式：

单文件上传步骤

导入fileupload和io坐标
配置文件上传解析器
编写文件上传代码

单文件上传实现

导入fileupload和io坐标

<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.3.1</version>
</dependency>
<dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.3</version>
</dependency>

在spring-mvc.xml中配置文件上传解析器

<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <property name="defaultEncoding" value="UTF-8"/>
    <property name="maxUploadSize" value="500000"/>
    <property name="maxUploadSizePerFile" value="5242800"/>
</bean>

编写文件上传代码

@RequestMapping("/quick21")
@ResponseBody
public void quickMethod21(String username,MultipartFile uploadFile) throws IOException {
    System.out.println(username);
    String originalFilename = uploadFile.getOriginalFilename();
    uploadFile.transferTo(new File("D:\\upload\\" + originalFilename));
}

多文件上传实现

多文件上传，只需要将页面修改为多个文件上传项，将方法参数MultipartFile类型修改为MultipartFile[]即可

<form action="${pageContext.request.contextPath}/quick21" method="post" enctype="multipart/form-data">
    名称<input type="text" name="username"><br>
    文件<input type="file" name="uploadFile"><br>
    文件<input type="file" name="uploadFile2"><br>
    <input type="submit" name="提交"><br>
</form>

@RequestMapping("/quick21")
@ResponseBody
public void quickMethod21(String username,MultipartFile uploadFile,MultipartFile uploadFile2) throws IOException {
    System.out.println(username);
    String originalFilename = uploadFile.getOriginalFilename();
    uploadFile.transferTo(new File("D:\\upload\\" + originalFilename));
    String originalFilename2 = uploadFile2.getOriginalFilename();
    uploadFile2.transferTo(new File("D:\\upload\\" + originalFilename2));
}

SpringMVC拦截器（interceptor）

拦截器（interceptor）的作用

Spring MVC 的拦截器类似于 Servlet 开发中的过滤器 Filter，用于对处理器进行预处理和后处理。

将拦截器按一定的顺序联结成一条链，这条链称为拦截器链（Interceptor Chain）。在访问被拦截的方法或字段时，拦截器链中的拦截器就会按其之前定义的顺序被调用。拦截器也是AOP思想的具体实现。

拦截器和过滤器区别

区别	过滤器	拦截器
使用范围	是 servlet 规范中的一部分，任何 Java Web 工程都可以使用	是 SpringMVC 框架自己的，只有使用了 SpringMVC 框架的工程才能用
拦截范围	在 url-pattern 中配置了/*之后，可以对所有要访问的资源拦截	在<mvc:mapping path=“”/>中配置了/**之后，也可以多所有资源进行拦截，但是可以通过<mvc:exclude-mapping path=“”/>标签排除不需要拦截的资源

拦截器快速入门

自定义拦截器很简单，只有如下三步：

创建拦截器类实现 HandlerInterceptor 接口

package com.kiang.interceptor;

public class MyInterceptor1 implements HandlerInterceptor {
    @Override//在目标方法执行之前执行
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("preHandle......");
        return true;//返回flase则不会向下执行
    }
    @Override//在目标方法执行之后试图返回之前执行
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("postHandle......");
    }
    @Override//在流程执行完毕后执行
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("afterCompletion......");
    }
}

配置拦截器

<!--    配置拦截器-->
<mvc:interceptors>
    <mvc:interceptor>
        <!--配置拦截哪些-->
        <mvc:mapping path="/**"/>
        <!--也可以配置放行哪些，例如：-->
        <!--<mvc:exclude-mapping path="/user/login"/>-->
        <bean class="com.kiang.interceptor.MyInterceptor1"/>
    </mvc:interceptor>
</mvc:interceptors>

测试拦截器的拦截效果

package com.kiang.controller;

@Controller
public class TargetController {
    @RequestMapping("/target")
    public ModelAndView show() {
        System.out.println("目标资源执行......");
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.addObject("name","kiang");
        modelAndView.setViewName("index");
        return modelAndView;
    }
}

执行效果

http://localhost:8080/KiangSpringInterceptor/target

多拦截器操作

同上，再编写一个MyHandlerInterceptor2操作，测试执行顺序

拦截器方法说明

方法名	说明
preHandle()	方法将在请求处理之前进行调用，该方法的返回值是布尔值Boolean类型的，当它返回为false 时，表示请求结束，后续的Interceptor 和Controller 都不会再执行；当返回值为true 时就会继续调用下一个Interceptor 的preHandle 方法
postHandle()	该方法是在当前请求进行处理之后被调用，前提是preHandle 方法的返回值为 true 时才能被调用，且它会在DispatcherServlet 进行视图返回渲染之前被调用，所以我们可以在这个方法中对Controller 处理之后的ModelAndView 对象进行操作
afterCompletion()	该方法将在整个请求结束之后，也就是在DispatcherServlet 渲染了对应的视图之后执行，前提是preHandle 方法的返回值为true 时才能被调用

SpringMVC异常处理

异常处理的思路

系统中异常包括两类：

预期异常：通过捕获异常从而获取异常信息。
运行时异常RuntimeException：主要通过规范代码开发、测试等手段减少运行时异常的发生。

系统的Dao、Service、Controller出现都通过throws Exception向上抛出，最后由SpringMVC前端控制器交由异常处理器进行异常处理，如下图：

异常处理两种方式

使用Spring MVC提供的简单异常处理器 SimpleMappingExceptionResolver
实现Spring的异常处理接口 HandlerExceptionResolver 自定义自己的异常处理器

简单异常处理器SimpleMappingExceptionResolver

SpringMVC已经定义好了该类型转换器，在使用时可以根据项目情况进行相应异常与视图的映射配置：

<bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">
    <!--默认错误视图-->
    <property name="defaultErrorView" value="error"/>
    <property name="exceptionMappings">
        <map>
            <!--异常类型 错误视图-->
            <entry key="java.lang.ClassCastException" value="error1"/>
            <entry key="com.kiang.exception.MyException" value="error2"/>
        </map>
    </property>
</bean>

自定义异常处理步骤

创建异常处理器类实现HandlerExceptionResolver
配置异常处理器
编写异常页面
测试异常跳转

创建异常处理器类实现HandlerExceptionResolver

package com.kiang.resolver;

public class MyExceptionResolver implements HandlerExceptionResolver {
    /*
        参数Exception：异常对象
        返回值ModelAndView：跳转到错误视图信息
     */
    public ModelAndView resolveException(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, Object o, Exception e) {
        ModelAndView modelAndView = new ModelAndView();

        if(e instanceof MyException){
            modelAndView.addObject("info","自定义异常");
        }else if(e instanceof ClassCastException){
            modelAndView.addObject("info","类转换异常");
        }

        modelAndView.setViewName("error");

        return modelAndView;
    }
}

配置异常处理器

<bean class="com.kiang.resolver.MyExceptionResolver"/>

编写异常页面

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
    <h1>通用的错误提示页面</h1>
    <h1>${info}</h1>
</body>
</html>

测试异常跳转

public void show5() throws MyException {
    System.out.println("自定义异常....");
    throw new MyException();
}

posted @ 2022-10-28 21:56 AncilunKiang 阅读(46) 评论(0) 编辑收藏举报

刷新页面返回顶部

登录后才能查看或发表评论，立即登录或者逛逛博客园首页

相关博文：

· Spring

· SSM概述

· 【springmvc】springmvc基本知识

· SpringMVC的请求和响应

· 学习笔记--Spring MVC

阅读排行：
· 全程不用写代码，我用AI程序员写了一个飞机大战
· MongoDB 8.0这个新功能碉堡了，比商业数据库还牛
· DeepSeek 开源周回顾「GitHub 热点速览」
· 记一次.NET内存居高不下排查解决与启示
· 白话解读 Dapr 1.15：你的「微服务管家」又秀新绝活了

公告

昵称： AncilunKiang
园龄： 4年2个月
粉丝： 18
关注： 2

+加关注

2025年3月

日

一

二

三

四

五

六