1. Spring与Web环境集成

1.1 ApplicationContext应用上下文获取方式

应用上下文对象是通过new ClasspathXmlApplicationContext(spring配置文件) 方式获取的,但是每次从容器中获得Bean时都要编写new ClasspathXmlApplicationContext(spring配置文件) ,这样的弊端是配置文件加载多次,应用上下文对象创建多次。
在Web项目中,可以使用ServletContextListener监听Web应用的启动,我们可以在Web应用启动时,就加载Spring的配置文件,创建应用上下文对象ApplicationContext,在将其存储到最大的域servletContext域中,这样就可以在任意位置从域中获得应用上下文ApplicationContext对象了。

1.2 Spring提供获取应用上下文的工具

上面的分析不用手动实现,Spring提供了一个监听器ContextLoaderListener就是对上述功能的封装,该监听器内部加载Spring配置文件,创建应用上下文对象,并存储到ServletContext域中,提供了一个客户端工具WebApplicationContextUtils供使用者获得应用上下文对象。
所以我们需要做的只有两件事:
①在web.xml中配置ContextLoaderListener监听器(导入spring-web坐标)
②使用WebApplicationContextUtils获得应用上下文对象ApplicationContext

1.3 导入Spring集成web的坐标

  1. <dependency>
  2. <groupId>org.springframework</groupId>
  3. <artifactId>spring-web</artifactId>
  4. <version>5.2.12.RELEASE</version>
  5. </dependency>

1.4 配置ContextLoaderListener监听器

  1. <!--全局参数-->
  2. <context-param>
  3. <param-name>contextConfigLocation</param-name>
  4. <param-value>classpath:ApplicationContext.xml</param-value>
  5. </context-param>
  6. <!--Spring的监听器-->
  7. <listener>
  8. <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
  9. </listener>

1.5 通过工具获得应用上下文对象

ServletContext servletContext = this.getServletContext();
ApplicationContext applicationContext = WebApplicationContextUtils.getWebApplicationContext(servletContext);
Object obj = applicationContext.getBean("id");

知识要点
Spring集成web环境步骤
①配置ContextLoaderListener监听器
②使用WebApplicationContextUtils获得应用上下文


2. 回顾MVC

  • MVC是模型(Model)、视图(View)、控制器(Controller)的简写,是一种软件设计规范。
  • 是将业务逻辑、数据、显示分离的方法来组织代码。
  • MVC主要作用是降低了视图与业务逻辑间的双向偶合。
  • MVC不是一种设计模式,MVC是一种架构模式。当然不同的MVC存在差异。

Model(模型):数据模型,提供要展示的数据,因此包含数据和行为,可以认为是领域模型或 JavaBean组件(包含数据和行为),不过现在一般都分离开来
Value Object(数据Dao) 和 服务层 (行为Service)。也就是模型提供了模型数据查询和模型数据的状态更新等功能,包括数据和业务。
View(视图):负责进行模型的展示,一般就是我们见到的用户界面,客户想看到的东西。
Controller(控制器):接收用户请求,委托给模型进行处理(状态改变)处理完毕后把返回的模型 数据返回给视图,由视图负责展示。 也就是说控制器做了个调度员的工作。
image-20210119120224933.png

3. SpringMVC简介

1. SpringMVC概述

image-20210119120358300.png
SpringMVC 是一种基于 Java 的实现 MVC 设计模型的请求驱动类型的轻量级 Web 框架,属于SpringFrameWork 的后续产品,已经融合在 Spring Web Flow 中。
SpringMVC 已经成为目前最主流的MVC框架之一,并且随着Spring3.0 的发布,全面超越 Struts2,成为最优秀的 MVC 框架。它通过一套注解,让一个简单的 Java 类成为处理请求的控制器,而无须实现任何接口。同时它还支持 RESTful 编程风格的请求。
我们为什么要学习SpringMVC?
Spring MVC的特点:
1. 轻量级,简单易学
2. 高效 , 基于请求响应的MVC框架
3. 与Spring兼容性好,无缝结合
4. 约定优于配置
5. 功能强大:RESTful、数据验证、格式化、本地化、主题等
6. 简洁灵活
Spring的web框架围绕DispatcherServlet [ 调度Servlet ] 设计。
DispatcherServlet的作用是将请求分发到不同的处理器。从Spring 2.5开始,使用Java 5或者以上版本的 用户可以采用基于注解形式进行开发,十分简洁;
正因为SpringMVC好 , 简单 , 便捷 , 易学 , 天生和Spring无缝集成(使用SpringIoC和Aop) , 使用约定优于 配置 . 能够进行简单的junit测试 . 支持Restful风格 .异常处理 , 本地化 , 国际化 , 数据验证 , 类型转换 , 拦截器 等等……所以我们要学习 .
SpringMVC雏形
image-20210119123410907.png

2. SpringMVC快速入门

需求:客户端发起请求,服务器端接收请求,执行逻辑并进行视图跳转。
开发步骤
①导入SpringMVC相关坐标
②配置SpringMVC核心控制器DispathcerServlet
③创建Controller类和视图页面
④使用注解配置Controller类中业务方法的映射地址
⑤配置SpringMVC核心文件 spring-mvc.xml
⑥客户端发起请求测试
代码实现

  1. 添加所有需要的坐标 ```xml javax.servlet.jsp jsp-api 2.0 provided
org.apache.tomcat tomcat-servlet-api 8.0.1 org.springframework spring-web 5.2.12.RELEASE

org.springframework spring-webmvc 5.2.12.RELEASE


2. web.xml中配置核心控制器
```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>
    <!--任何请求都需要经过该Servlet-->
    <url-pattern>/</url-pattern>
</servlet-mapping>
  1. 创建Controller以及业务方法

    public class UserController{
     public String save(){
         System.out.println("Controller Save Running...");
         return "Success.jsp";
     }
    }
    

    Success.jsp

    <%@ page contentType="text/html;charset=UTF-8" language="java" %>
    <html>
    <head>
     <title>Title</title>
    </head>
    <body>
      <h3>成功</h3>
    </body>
    </html>
    
  2. 使用注解配置Controller中的方法的映射路径

    @Controller
    public class UserController{
     //配置请求映射,相当于@WebServlet
     @RequestMapping("/save")
     public String save(){
         System.out.println("Controller Save Running...");
         //return代表返回的页面
         return "Success.jsp";
     }
    }
    
  3. 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">
    
     <!--Controller的组件扫描-->
     <context:component-scan base-package="com.gmf.controller"/>
    </beans>
    
  4. 客户端测试
    image-20210119151959525.pngimage-20210119152021590.png

    3. SpringMVC的流程展示

    image-20210119152112316.png

    4. SpringMVC的流程解析

    1. SpringMVC执行流程

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

    2. SpringMVC组件解析

  5. 前端控制器:DispatcherServlet

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

  6. 处理器映射器:HandlerMapping

    HandlerMapping 负责根据用户请求找到 Handler 即处理器,SpringMVC 提供了不同的映射器实现不同的映射方式,例如:配置文件方式,实现接口方式,注解方式等,返回对应的执行链。

  7. 处理器适配器:HandlerAdapter

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

  8. 处理器:Handler

    它就是我们开发中要编写的具体业务控制器(Controler)。由 DispatcherServlet 把用户请求转发到 Handler。由Handler 对具体的用户请求进行处理。

  9. 视图解析器:View Resolver

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

  10. 视图:View

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

    3. Spring注解解析

    @RequestMapping
    作用:用于建立请求 URL 和处理请求方法之间的对应关系
    位置
    1. 类上,请求URL 的第一级访问目录。此处不写的话,就相当于应用的根目录
    2. 方法上,请求 URL 的第二级访问目录,与类上的使用@ReqquestMapping标注的一级目录一起组成访问虚拟路径
    属性

  11. value:用于指定请求的URL。它和path属性的作用是一样的

    @RequestMapping(value = "/user")
    public class UserController{...}
    
  12. method:用于指定请求的方式

    @RequestMapping(value = "/user",method = RequestMethod.POST)
    
  13. params:用于指定限制请求参数的条件。它支持简单的表达式。要求请求参数的key和value必须和配置的一模一样
    例如:
    params = {"id"},表示请求参数必须含有id
    params = {"moeny!100"},表示请求参数中money不能是100

    @RequestMapping(value = "/user",method = RequestMethod.GET,params = {"id"})
    
  14. produces:用户指定ContentType

    @RequestMapping(value = "/save",produces = "text/html;charset=utf-8")
    

    组件扫描
    SpringMVC基于Spring容器,所以在进行SpringMVC操作时,需要将Controller存储到Spring容器中,如果使用@Controller注解标注的话,就需要使用<context:component-scan base-package="com.gmf.controller"/>进行组件扫描
    也可以通过筛选条件的方式

    <!--Controller的组件扫描-->
    <context:component-scan base-package="com.gmf">
     <!--表示只扫描com.gmf包下的Controller注解标识bean-->
     <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
     <!--表示扫描com.gmf包下除了Controller注解标识的bean-->
     <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
    </context:component-scan>
    

    4. SpringMVC的XML配置解析

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

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

    翻看该解析器源码,可以看到该解析器的默认设置,如下: ```java public static final String REDIRECT_URL_PREFIX = “redirect:”; //路径前缀名 public static final String FORWARD_URL_PREFIX = “forward:”; //路径后缀名 private String prefix = “”; private String suffix = “”;

//提供了set属性,可以通过Spring依赖注入设置值 public void setPrefix(@Nullable String prefix) { this.prefix = prefix != null ? prefix : “”; } public void setSuffix(@Nullable String suffix) { this.suffix = suffix != null ? suffix : “”; }

**Spring-mvc.xml中配置视图解析器**<br />我们可以通过属性注入的方式修改视图的的前后缀
```xml
<!--配置内部资源视图解析器-->
<bean id="resolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <!--设置前缀-->
    <property name="prefix" value="/jsp/"/>
    <!--设置后缀-->
    <property name="suffix" value=".jsp"/>
</bean>

修改Controller方法的返回路径

@RequestMapping("/save")
public String save(){
    System.out.println("Controller Save Running...");
    //return代表返回的页面,配置视图解析器的前后缀之后,可以直接通过文件名访问
    return "Success";
}

补充:Spring默认的跳转方式为转发,默认添加 forword: 前缀;如果想更改为重定向的方式,可手动配置 redirect:
测试浏览器解析后成功跳转

5. SpringMVC的数据响应方式

1. 页面跳转

  • 直接返回字符串
    1.jpg
    SpringMVC实现转发以及重定向:
    在返回值前添加 foward: 或者 redirect: 例如 return "redirect:index"
    备注:如果在返回值手动设置了重定向或转发,则不会再执行视图解析器

**

  • 通过ModelAndView对象返回
    1. 第一种方式:在Controller中方法返回ModelAndView对象,并且设置视图名称
      @Controller
      @RequestMapping("user")
      public class UserController {
      @RequestMapping("pageTurn")
      public ModelAndView pageTurn(){
        /*
        * Model:模型(封装数据)
        * View:视图(展示数据)
        * */
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.addObject("loginUser","GMF");
        //设置视图名称
        modelAndView.setViewName("Success");
        return modelAndView;
      }
      }
      
      jsp访问:
      <%--通过键名直接获取--%>
      <h3>成功${loginUser}</h3>
      
      b. 第二种方式:在Controller中方法形参上直接声明ModelAndView / Model,无需在方法中自己创建,在方法中直接使用该对象设置视图,同样可以跳转页面 ```java @RequestMapping(“pageTurn2”) //Spring会自动判断方法是否有形参,自动注入 public ModelAndView pageTurn2(ModelAndView modelAndView){ modelAndView.addObject(“loginUser”,”KYN”); //设置视图名称 modelAndView.setViewName(“Success”); return modelAndView; }

@RequestMapping(“pageTurn3”) //Spring会自动判断方法是否有形参,自动注入 public String pageTurn3(Model model){ model.addAttribute(“loginUser”,”HBT”); return “Success”; }

****        **** c. **第三种方式**:在Controller方法的形参上可以直接使用原生的HttpServeltRequest对象,只需声明即可
```java
@RequestMapping("pageTurn4")
public String pageTurn4(HttpServletRequest request){
    request.setAttribute("loginUser","THV");
    return "Success";
}

2. 回写数据

  • 直接返回字符串

    1. 通过SpringMVC框架注入的response对象,使用response.getWriter().print(“hello world”) 回写数据,此时不需要视图跳转,业务方法返回值为void
      @RequestMapping("dataBack1")
      public void dataBack(HttpServletResponse response) throws IOException {
      response.getWriter().print("HelloSpringMVC");
      }
      
      b. 将需要回写的字符串直接返回,但此时需要通过@ResponseBody注解告知SpringMVC框架,方法返回的字符串不是跳转是直接在http响应体中返回
      @RequestMapping("dataBack2")
      @ResponseBody  //告知Spring该方法不作为跳转,用作响应数据
      public String dataBack2() throws IOException {
      return "Hello GMF";
      }
      
      c. 回写Json格式字符串
      @RequestMapping("dataBack3")
      @ResponseBody  //告知Spring该方法不作为跳转,用作响应数据
      public String dataBack3() throws IOException {
      List<String> users = List.of("GMF", "KYN", "ZTL");
      //使用Jackson将对象数据转换为字符串
      String strJson = new ObjectMapper().writeValueAsString(users);
      return strJson;
      }
      
  • 返回对象或集合
    通过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"/>
          </list>
      </property>
    </bean>
    
  • 于是我们在方法中直接返回对象or集合即可,处理适配器会自动转换为Json格式字符串

    @RequestMapping("dataBack4")
    @ResponseBody
    //期待SpringMVC自动将user转换为Json字符串
    public List<String> dataBack4() throws IOException {
      List<String> users = List.of("GMF", "KYN", "HBT");
      return users;
    }
    

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

    <!--
    支持mvc注解驱动
      在spring中一般采用@RequestMapping注解来完成映射关系
      要想使@RequestMapping注解生效
      必须向上下文中注册DefaultAnnotationHandlerMapping
      和一个AnnotationMethodHandlerAdapter实例
      这两个实例分别在类级别和方法级别处理。
      而annotation-driven配置帮助我们自动完成上述两个实例的注入
    -->
    <mvc:annotation-driven/>
    

    在 SpringMVC 的各个组件中,处理器映射器、处理器适配器、视图解析器称为 SpringMVC 的三大组件。
    使用<mvc:annotation-driven />自动加载 RequestMappingHandlerMapping(处理映射器)和 RequestMappingHandlerAdapter( 处 理 适 配 器 ),可用在Spring-xml.xml配置文件中使用
    <mvc:annotation-driven />替代注解处理器和适配器的配置。
    同时使用<mvc:annotation-driven />
    默认底层就会集成jackson进行对象或集合的json格式字符串的转换

    6. SpringMVC的请求

    1. 获得请求参数-请求参数类型(理解)

    客户端请求参数的格式是:name=value&name=value……
    服务器端要获得请求的参数,有时还需要进行数据的封装,SpringMVC可以接收如下类型的参数

  • 基本类型参数

  • POJO类型参数
  • 数组类型参数
  • 集合类型参数

    2. 获得请求参数-获得基本类型参数

    Controller中的业务方法的参数名称要与请求参数的name一致,参数值会自动映射匹配。并且能自动做类型转换;
    自动的类型转换是指从String向其他类型的转换
    http://localhost:8080/param1?name=gmf&age=2
    
    @Controller
    public class RequestParam {
      @RequestMapping("param1")
      @ResponseBody
      //SpringMVC会根据方法上的参数名称以及请求的参数名称匹配赋值
      public void params1(String name, int age){
          System.out.println(name);
          System.out.println(age);
      }
    }
    

    3. 获得请求参数-获得POJO类型参数

    Controller中的业务方法的POJO参数的属性名与请求参数的name一致,参数值会自动映射匹配。
    pojo实体
    @Data
    @AllArgsConstructor
    @NoArgsConstructor
    public class User {
      private String name;
      private int age;
    }
    
    Controller
    @RequestMapping("param2")
    @ResponseBody
    public void params2(User user){
      System.out.println(user);
    }
    
    页面访问
    http://localhost:8080/param2?name=gmf&age=2
    

    4. 获得请求参数-获得数组类型参数

    Controller中的业务方法数组名称与请求参数的name一致,参数值会自动映射匹配。
    Controller
    @RequestMapping("param3")
    @ResponseBody
    public void params3(String[] hobby){
      System.out.println(Arrays.toString(hobby));  //[听歌, 看书]
    }
    
    页面访问
    http://localhost:8080/param3?hobby=听歌&favorite=打球&hobby=看书
    

    5. 获得请求参数-获得集合类型参数

    1. 第一种方式:将集合封装到一个实体中

    获得集合参数时,不进行其他配置的话,要将集合参数包装到一个POJO中才可以
    pojo ```java @Data public class Vo { private List userList; }

@Data @AllArgsConstructor @NoArgsConstructor public class User { private String name; private int age; }

**html**
```html
<form action="/param4" method="post">
    <input name="userList[0].name"><br>
    <input name="userList[0].age"><br>
    <input name="userList[1].name"><br>
    <input name="userList[1].age"><br>
    <input type="submit">
</form>

name属性的写法:集合属性名称[下标].元素属性
测试代码

@RequestMapping("param4")
@ResponseBody
public void params4(Vo vo){
    System.out.println(vo);  //Vo(userList=[User(name=GMF, age=17), User(name=KYN, age=17)])
}

注意:当我们直接访问html以及其他静态资源时,会出现404问题, 因为SpringMVC 会将这些访问静态资源的请求也当成一个普通请求处理,然后这个请求会被 DispatcherServlet 拦截器拦截,因找不到对应处理器将导致错误
解决方法:在 SpringMVC 的配置文件中配置 <mvc:default-servlet-handler/>

2. 第二种方式:在方法形参处设置集合

当使用ajax提交时,可以指定contentType为json形式,那么在方法参数位置使用@RequestBody可以直接接收集合数据而无需使用POJO进行包装
HTML页面
1. 使用JSON.stringify()方法将对象转换为JSON格式字符串
2. contentType:设置请求的数据格式为JSON

<body>
    <script src="/js/jquery-3.3.1.min.js"></script>
    <script>
        var userList = new Array();
        userList.push({name:"GMF",age:17})
        userList.push({name:"KYN",age:17})
        $.ajax({
            type:"POST",
            url:"/param5",
            data:JSON.stringify(userList),
            contentType:"application/json;charset=utf-8"
        });
    </script>
</body>

测试代码

@RequestMapping("param5")
@ResponseBody
//SpringMVC自动将JSON格式字符串转换为集合参数
//@RequestBody:读取 Request 请求的部分数据,使用系统默认配置的 HttpMessageConverter 进行解析,然后把相应的数据绑定到要返回的对象上
public void params5(@RequestBody List<User> userList) {
    System.out.println(userList);
}

注意:当我们访问静态资源时会报出404问题
原因:前端控制器将我们的请求拦截,去寻找对应的controllerMapping
解决方法<mvc:resources mapping="/js/**" location="/js/"/>

6. 请求数据乱码问题

当我们在表单提交中文数据时,到服务器客户端发送乱码问题

Vo(userList=[User(name=è??è??é??, age=17), User(name=??·??????, age=17)])

解决方法

  1. 使用Request设置编码格式为UTF-8(不推荐,尽量与之前的Servlet解耦)
  2. 使用SpringMVC的过滤器,在web.xml中配置

    <!--配置字符编码过滤器:使用SpringMVC自带的CharacterEncodingFilter-->
    <filter>
     <filter-name>CharacterEncodingFilter</filter-name>
     <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
     <!--配置其中的属性encoding为UTF-8-->
     <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>
    
    Vo(userList=[User(name=虢莫非, age=17), User(name=KYN, age=17)])
    

    7. 获得请求参数-静态资源访问的开启

    当有静态资源需要加载时,比如jquery / img / js文件,通过谷歌开发者工具抓包发现,没有加载到jquery文件,原因是SpringMVC的前端控制器DispatcherServlet的url-pattern配置的是’ / ‘,代表对所有的资源都进行过滤操作,去controller中查找对应的Mapping,我们可以通过以下两种方式指定放行静态资源:

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

    <!--开发资源的访问权限-->
    <mvc:resources mapping="/js/**" location="/js/"/>
    <mvc:resources mapping="/img/**" location="/img/"/>
    

    作用:告知SpringMVC对该路径下的文件取消过滤

  4. 使用 <mvc:default-servlet-handler/> 配置

    <!--如果核心配置器未找到对应的方法mapping,则交由Tomcat查找-->
    <mvc:default-servlet-handler/>
    

    作用:如果SpringMVC通过前端配置器未找到对应的Mapping,则交由Tomcat查询对应资源

    8. 参数绑定注解@RequestParam

    当客户端发出请求的参数名称与controler参数名称不同时,服务器后台数据无法接收到

    http://localhost:8080/param1?username=gmf&age=1
    

    测试代码

    @RequestMapping("param6")
    @ResponseBody
    public void params6(String name, int age){
     System.out.println(name);  //null
     System.out.println(age);  //1
    }
    

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

    @RequestMapping("param6")
    @ResponseBody
    public void params6(@RequestParam("username")String name, int age){
     System.out.println(name);  //gmf
     System.out.println(age);  //1
    }
    

    @RequestParam注解的属性

  5. value:请求参数与方法参数的映射名称

  6. required:如果参数为空,是否抛出异常(true:抛出异常 / false:抛出异常)
  7. defaultValue:当没有指定请求参数时,则使用指定的默认值赋值

修改测试代码

@RequestMapping("param6")
@ResponseBody
public void params6(@RequestParam(value = "username",required = false,defaultValue = "KYN")String name, int age){
    System.out.println(name);
    System.out.println(age);
}

9. 获得请求参数-获得Servlet相关API

SpringMVC支持使用原始ServletAPI对象作为控制器方法的参数进行注入,常用的对象如下:

  • HttpServletRequest
  • HttpServletResponse
  • HttpSession

    @RequestMapping("param9")
    @ResponseBody
    //将ServletAPI作为方法形参,SpringMVC会自动注入
    public void params9(HttpServletRequest request, HttpServletResponse response, HttpSession session){
      System.out.println(request);
      System.out.println(response);
      System.out.println(session);
    }
    

    10. 获取请求头数据

    1. @RequestHeader

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

  • value:请求头的名称

  • required:是否必须携带此请求头

    @RequestMapping("param10")
    @ResponseBody
    //将ServletAPI作为方法形参,SpringMVC会自动注入
    public void params10(@RequestHeader(value = "User-Agent",required = false) String user_Agent){
      System.out.println(user_Agent);  //Mozilla/5.0 (Windows NT 10.0; Win64; x64)...
    }
    

    2. @CookieValue

    使用@CookieValue可以获得指定Cookie的值
    @CookieValue注解的属性如下:

  • value:指定cookie的名称

  • required:是否必须携带此cookie

    @RequestMapping("param11")
    @ResponseBody
    //使用@CookieValue注解使形参获取指定key的value
    public void params11(@CookieValue(value = "Idea-ad83301d",required = false) String Idea_ad83301d){
      System.out.println(Idea_ad83301d);  //64e084ff-f59d-4faa-b2e1-96c220edab3e
    }
    

    7. Restful风格的参数

    Restful是一种软件架构风格、设计风格,而不是标准,只是提供了一组设计原则和约束条件。主要用于客户端和服务器交互类的软件,基于这个风格设计的软件可以更简洁,更有层次,更易于实现缓存机制等。
    Restful风格的请求是使用“url+请求方式”表示一次请求目的的,HTTP 协议里面四个表示操作方式的动词如下:

  • GET:用于获取资源

  • POST:用于新建资源
  • PUT:用于更新资源
  • DELETE:用于删除资源

For Example:

/user/1   GET :    得到 id = 1 的 user

/user/1   DELETE:  删除 id = 1 的 user

/user/1   PUT:     更新 id = 1 的 user

/user     POST:    新增 user

上述url地址/user/1中的1就是要获得的请求参数,在SpringMVC中可以使用占位符进行参数绑定。地址/user/1可以写成/user/{param},占位符{param}对应的就是1的值。在业务方法中我们可以使用@PathVariable注解进行占位符的匹配获取工作

http://localhost:8080/param7/GMF

测试代码

//使用Restful风格传递参数
@RequestMapping("param7/{userName}")  //localhost:8080/param7/GMF
@ResponseBody
//使用@PathVariable注解标识请求url中的占位符对应的参数
public void params7(@PathVariable("userName") String name){
    System.out.println(name);
}

image-20210120154342457.png

8. 自定义类型转换器

SpringMVC 默认已经提供了一些常用的类型转换器,例如客户端提交的字符串转换成int型进行参数设置。
但是不是所有的数据类型都提供了转换器,没有提供的就需要自定义转换器,例如:日期类型的数据就需要自定义转换器。
问题演示
当我们需要对Date类型方法参数进行自动装配时,SpringMVC自带有类型转换器,支持yyyy/MM/dd的格式转换
测试代码:

@RequestMapping("param8")
@ResponseBody
public void params8(@RequestParam("date") Date birthday){
    System.out.println(birthday);
}

网页请求

http://localhost:8080/param8?date=2020/8/9

控制台打印:

Sun Aug 09 00:00:00 CST 2020

注意:当我们日期参数为yyyy-MM-dd时,抛出异常

http://localhost:8080/param8?date=2020-8-9

image-20210120160159556.png

实现步骤**:

  1. 自定义转换器类实现Converter接口

    /**
    * @className: DateConverter
    * @description 在处理器适配器HandlerAdaptor中对于String转Date类型自定义的转换器
    */
    public class DateConverter implements Converter<String,Date> {
     /**
      * @param dateStr 参数的类型由接口的第一个泛型决定
      * @return java.util.Date  接口的返回值类型由接口的第二个泛型决定
      * @description 转换器中String转Date类型的方法
      */
     @SneakyThrows
     @Override
     public Date convert(String dateStr) {
         SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
         Date date = sdf.parse(dateStr);
         return date;
     }
    }
    
  2. 在配置文件中声明转换器

    <!--声明转换器-->
    <bean id="convertors" class="org.springframework.context.support.ConversionServiceFactoryBean">
     <!--将自定义的Convert转换器添加至SpringMVC的转换器工厂中-->
     <property name="converters">
         <list>
             <bean class="com.gmf.converter.DateConverter"/>
         </list>
     </property>
    </bean>
    
  3. 中引用转换器

    <mvc:annotation-driven conversion-service="convertors"/>
    
  4. 测试
    测试代码

    @RequestMapping("param8")
    @ResponseBody
    public void params8(@RequestParam("date") Date birthday, int age){
     System.out.println(birthday);
     System.out.println(age);
    }
    

    页面访问

    http://localhost:8080/param8?date=2020-8-9&age=2
    

    成功访问并打印参数

补充:添加自定义转换器不会影响SpringMVC的其他类型转换器

9. 文件上传

1. 文件上传-客户端表单实现

文件上传客户端表单需要满足三要素:

  • 表单项type=“file”
  • 表单的提交方式是post
  • 表单的enctype属性是多部分表单形式,及enctype=“multipart/form-data”
    <body>
      <form action="/upload1" method="post" enctype="multipart/form-data">
          名称<input name="userName">
          文件<input type="file" name="uploadFile">
          <input type="submit" name="提交"/>
      </form>
    </body>
    

    2. 文件上传-文件上传的原理

    2.jpg

    3. 单文件上传的代码实现

    实现步骤:
  1. 添加依赖

    <!--文件上传所需maven依赖jar包-->
    <dependency>
     <groupId>commons-fileupload</groupId>
     <artifactId>commons-fileupload</artifactId>
     <version>1.4</version>
    </dependency>
    <dependency>
     <groupId>commons-io</groupId>
     <artifactId>commons-io</artifactId>
     <version>2.8.0</version>
    </dependency>
    
  2. 配置文件上传解析器

    <!--配置文件上传解析器-->
    <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
     <property name="defaultEncoding" value="UTF-8"/>
     <property name="maxUploadSize" value="500000"/>
     <!--其余配置查看其属性-->
    </bean>
    
  3. 编写文件上传代码

    @SneakyThrows
    @RequestMapping("upload1")
    @ResponseBody
    public void upload1(String userName, MultipartFile uploadFile){
     System.out.println(userName);  //GMF
     System.out.println(uploadFile);  //org.springframework.web.multipart.commons.CommonsMultipartFile@26672224
     //System.out.println(uploadFile.getName());  //获取【表单】上fileInput的name
     //获取上传文件的名称
     String fileName = uploadFile.getOriginalFilename(); 
     System.out.println(fileName);
     //将文件保存到指定路径
     uploadFile.transferTo(new File("C:\\upload\\"+fileName));
    }
    

    image-20210120191924562.png

    4. 多文件上传的代码实现

    HTML

    <form action="/upload2" method="post" enctype="multipart/form-data">
     名称<input name="userName">
     文件1<input type="file" name="uploadFile">
     文件2<input type="file" name="uploadFile">
     文件3<input type="file" name="uploadFile">
     <input type="submit" name="提交"/>
    </form>
    

    代码实现

    /**
    * @description 多文件上传的代码实现
    */
    @SneakyThrows
    @RequestMapping("upload2")
    @ResponseBody
    public void upload2(String userName, @RequestParam("uploadFile")MultipartFile[] uploadFiles){
     System.out.println(userName);  //GMF
     System.out.println(uploadFiles.length);
     for (MultipartFile uploadFile : uploadFiles) {
         //获取上传文件的名称
         String fileName = uploadFile.getOriginalFilename();
         System.out.println(fileName);
         //将文件保存到指定路径
         uploadFile.transferTo(new File("C:\\upload\\"+fileName));
     }
    }
    

    使用数组接收上传的多个文件,循环遍历保存

5. SpringMVC的请求-知识要点(理解,记忆)

6.jpg

10. 拦截器

1.SpringMVC拦截器-拦截器的作用

Spring MVC 的拦截器类似于 Servlet 开发中的过滤器 Filter,用于对处理器进行预处理后处理
将拦截器按一定的顺序联结成一条链,这条链称为拦截器链(InterceptorChain)。在访问被拦截的方法或字段时,拦截器链中的拦截器就会按其之前定义的顺序被调用。拦截器也是AOP思想的具体实现。
总结一句话:拦截器就是在我们访问目标资源时做一些相应干预

2. 拦截器和过滤器的区别

区别 过滤器 拦截器
使用范围 是Servlet规范中的一部分,任何JavaWeb工程都可以使用 是SpringMVC框架自己提供的,只有使用了SpringMVC框架的工程才能使用
拦截范围 在url-pattern中配置了/*之后,可以对所有要访问的资源进行拦截 只会拦截访问的控制器方法,如果访问的是jsp/html/css/image/js是不会进行拦截的

3. 拦截器快速入门

实现步骤

  1. 创建拦截器类实现HandlerInterceptor接口

    /**
    * @description 自定义的拦截器
    */
    public class MyInterceptor1 implements HandlerInterceptor {
     //在目标Controller方法执行前执行
     @Override
     public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
         System.out.println("preHandle");
         //返回值:是否放行
         return true;
     }
     //目标方法执行后,视图对象返回之前执行
     @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");
     }
    }
    
    1. 配置拦截器
      <!--配置拦截器-->
      <mvc:interceptors>
      <mvc:interceptor>
        <!--对哪些资源执行拦截操作,/**代表拦截所有资源-->
        <mvc:mapping path="/**"/>
        <bean class="com.gmf.interceptor.MyInterceptor1"/>
      </mvc:interceptor>
      </mvc:interceptors>
      
      b. Controller中目标方法
      @RequestMapping("target")
      public ModelAndView target(ModelAndView modelAndView){
      System.out.println("访问目标资源");
      modelAndView.setViewName("index");
      return modelAndView;
      }
      
  2. 测试拦截器的拦截效果

image-20210120225016731.png


4. 拦截器详解

拦截器在预处理后什么情况下会执行目标资源,什么情况下不执行目标资源?
拦截器中每个方法的作用

  1. preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
    方法将在请求处理之前进行调用,该方法的返回值是布尔值Boolean类型的,当它返回为false时,表示请乳结束,后续的Interceptor和Controller都不会再执行;当返回值为true时就会继续调用下一个Interceptor的preHandle方法获取Controller方法

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
     System.out.println("preHandle");
     //判断请求参数中是否存在值为yes的param参数
     if (!"yes".equals(request.getParameter("param"))){
         //如果不存在,或者值不同,则重定向到Error页面
         response.sendRedirect("/error.html");
         return false;
     }
     //返回值:是否放行
     return true;
    }
    
  2. postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, @Nullable ModelAndView modelAndView)
    该方法是在当前请求进行处理之后被调用,前提是preHandle方法的返回值为true 时才能被调用,且它会在DispatcherServlet进行视图返回渲染之前被调用,所以我们可以在这个方法中对Controller处理之后的ModelAndView对象进行操作

    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
     //当执行完controller方法后,重写设置View中的视图名称
     modelAndView.setViewName("success");
     System.out.println("postHandle");
    }
    
  3. afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, @Nullable Exception ex)
    该方法将在整个请求结束之后,也就是在DispatcherServlet渲染了对应的视图之后执行,前提是preHandle方法的返回值为true时才能被调用

2.png

多个拦截器的情况下拦截器的执行顺序是什么?
编写第二个拦截器

public class MyInterceptor2 implements HandlerInterceptor {
    //在目标Controller方法执行前执行
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("preHandle222");
        return true;
    }
    //目标方法执行后,视图对象返回之前执行
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("postHandle222");
    }
    //在整个流程都执行完毕后执行
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("afterCompletion222");
    }
}

配置拦截器

<!--配置拦截器-->
<mvc:interceptors>
    <mvc:interceptor>
        <!--对哪些资源执行拦截操作,/**代表拦截所有资源-->
        <mvc:mapping path="/target"/>
        <bean class="com.gmf.interceptor.MyInterceptor1"/>
    </mvc:interceptor>
    <!--配置第二个拦截器,按照配置顺序执行-->
    <mvc:interceptor>
        <mvc:mapping path="/target"/>
        <bean class="com.gmf.interceptor.MyInterceptor2"/>
    </mvc:interceptor>
</mvc:interceptors>

补充:配置拦截器时,可以设置排除的资源(例如:登陆的方法)

<mvc:interceptor>
    <!--对哪些资源执行拦截操作,/**代表拦截所有资源-->
    <mvc:mapping path="/target"/>
    <!--排除哪些资源,不对其进行拦截-->
    <mvc:exclude-mapping path="/login"/>
    <bean class="com.gmf.interceptor.MyInterceptor1"/>
</mvc:interceptor>

查看执行访问顺序

http://localhost:8080/target?param=yes

image-20210120235346097.png
结论

  • 当拦截器的preHandle方法返回true则会执行目标资源,如果返回false则不执行目标资源
  • 多个拦截器情况下,配置在前的先执行,配置在后的后执行
  • 拦截器中的方法执行顺序是:preHandler———-目标资源——postHandle—— afterCompletion

    11. SpringMVC的异常处理

    1. 异常处理的思路

    系统中异常包括两类:预期异常运行时异常RuntimeException,前者通过捕获异常从而获取异常信息,后者主要通过规范代码开发、测试等手段减少运行时异常的发生。
    系统的DaoServiceController出现都通过throws Exception向上抛出,最后由SpringMVC前端控制器交由异常处理器进行异常处理,如下图:
    image-20210121090202120.png

    2.异常处理的两种方式

    ① 使用Spring MVC提供的简单异常处理器SimpleMappingExceptionResolver
    ② 实现Spring的异常处理接口HandlerExceptionResolver 自定义自己的异常处理器
    测试环境搭建
    自定义异常

    public class MyException extends Exception{ }
    

    Service

    @Service
    public class DemoService {
      public void show1(){
          System.out.println("类型转换异常");
          Object str = "abc";
          Integer abc = (Integer)str;
      }
      public void show2(){
          System.out.println("数学异常");
          int i = 1/0;
      }
      public void show3() throws FileNotFoundException {
          System.out.println("文件找不到异常");
          new FileInputStream("C://**");
      }
      public void show4(){
          System.out.println("空指针异常");
          String str = null;
          str.replaceAll("1","1");
      }
      public void show5() throws MyException {
          System.out.println("自定义异常");
          throw new MyException();
      }
    }
    

    Controller

    @Controller
    public class DemoController {
      @Autowired
      private DemoService service;
      @RequestMapping("show")
      public String show(String name){
          System.out.println("show Running...");
          service.show1();
          //service.show2();
          //service.show3();
          //service.show4();
          return "index";
      }
    }
    

    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"
         xmlns:mvc="http://www.springframework.org/schema/mvc"
         xsi:schemaLocation="http://www.springframework.org/schema/beans
          https://www.springframework.org/schema/beans/spring-beans.xsd
          http://www.springframework.org/schema/context
          https://www.springframework.org/schema/context/spring-context.xsd
          http://www.springframework.org/schema/mvc
          https://www.springframework.org/schema/mvc/spring-mvc.xsd">
      <mvc:annotation-driven/>
      <context:component-scan base-package="com.gmf"/>
      <mvc:default-servlet-handler/>
      <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
          <property name="suffix" value=".html"/>
      </bean>
    </beans>
    

    错误页面
    image-20210121095649697.png

    3. 简单异常处理器SimpleMappingExceptionResolver

    SpringMVC已经定义好了该类型转换器,在使用时可以根据项目情况对不同的异常与视图的映射配置

    <!--配置简单映射异常处理器-->
    <bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">
      <!--配置不同异常与视图的映射-->
      <property name="exceptionMappings">
          <map>
              <!--捕获异常后跳转到对于的视图页面-->
              <entry key="java.lang.ClassCastException" value="error1"/>
              <entry key="java.io.FileNotFoundException" value="error2"/>
              <entry key="java.lang.NullPointerException" value="error3"/>
          </map>
      </property>
      <!--如果异常没有被上方捕获,则使用默认的异常视图-->
      <property name="defaultErrorView" value="defaultError"/>
    </bean>
    

    对于抛出的异常会在简单处理器中被捕获处理,根据视图跳转到相应页面

    4. 自定义异常处理器

    ①创建异常处理器类实现HandlerExceptionResolver

    public class MyExceptionResolver implements HandlerExceptionResolver {
      /**
       * @param request
    * @param response
    * @param o
    * @param exception  程序抛出到处理器的异常对象
       * @return org.springframework.web.servlet.ModelAndView  跳转的错误视图信息
       * @description  异常处理的逻辑:日志、跳转...
       */
      @Override
      public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object o, Exception exception) {
          ModelAndView modelAndView = new ModelAndView();
          if (exception instanceof MyException){
              modelAndView.addObject("errorInfo","自定义异常错误");
              modelAndView.setViewName("MyException");
          }else if (exception instanceof ClassCastException){
              modelAndView.addObject("errorInfo","类转换异常");
              modelAndView.setViewName("ClassCastException");
          }
          return modelAndView;
      }
    }
    

    ②配置异常处理器

    <!--自定义的异常处理器-->
    <bean class="com.gmf.resolver.MyExceptionResolver"/>
    

    ③编写异常页面
    image-20210121095649697.png
    ④测试异常跳转
    测试代码

    @RequestMapping("show")
    public String show(String name) throws MyException {
      System.out.println("show Running...");
      service.show5();
      return "index";
    }
    

    浏览器访问:

    http://localhost:8080/show
    

    结果
    image-20210121095829017.png

    5. 知识要点

    异常处理方式

  • 配置简单异常处理器SimpleMappingExceptionResolver

  • 自定义异常处理器

自定义异常处理步骤

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