Spring MVC

一、Spring MVC简介

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为表述层开发提供的一整套完备的解决方案。在表述层框架经历Sturct、WebWork、Struct2等诸多产品的历代更迭之后，目前业界普遍选择了SpringMVC作为Java EE项目表述层开发的首选方案。

【注：三层架构分为表述层，（或表示层）、业务层、数据访问层，表述层表示前台页面和后台Servlet】

3、SpringMVC的特点

• Spring家族原生产品，与IOC容器的等基础设施无缝对接
• 基于原生的Servlet，通过了功能强大的前端控制器DispatcherServlet,对请求和响应进行统一处理
• 表述层各细分领域需要解决的问题全方位覆盖，提供全面解决方案
• 代码清新简洁，大幅提升开发效率
• 内部组件化程度高，可插拔式组件即插即用，想要什么功能配置相应组件即可
• 性能卓越，尤其适合现代大型、超大型互联网项目的要求

二、HelloWorld案例

1、开发环境

IDE：idea 2020.1

构建工具：maven3.6.3

服务器：tomcat7

Spring版本：5.3.1

2、创建maven工程

a>添加web模块

b>把包方式：war

c>引入依赖

<dependencies>
    <!-- SpringMVC -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>5.3.1</version>
    </dependency>

    <!-- 日志 -->
    <dependency>
        <groupId>ch.qos.logback</groupId>
        <artifactId>logback-classic</artifactId>
        <version>1.2.3</version>
    </dependency>

    <!-- ServletAPI -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>3.1.0</version>
        <scope>provided</scope>
    </dependency>

    <!-- Spring5和Thymeleaf整合包 -->
    <dependency>
        <groupId>org.thymeleaf</groupId>
        <artifactId>thymeleaf-spring5</artifactId>
        <version>3.0.12.RELEASE</version>
    </dependency>
</dependencies>

对上述代码的解释：

 <!-- ServletAPI -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>3.1.0</version>
        <scope>provided</scope>
    </dependency>

这里的<scope>provided</scope>的意思是：已被提供，被tomcat服务器提供，如果把该项目打成war包，这个依赖所对应的jar包是不会存在与打成wa包下的webapp下的web-info下的lib下。

注意：由于Maven的传递性，我们不必将所有需要的包全部配置到依赖，而是配置最顶端的依赖，其他靠传递性导入。

 3、配置web.xml

1、首先需要在pom.xml文件下把打包方式改为war

 2、在main目录下新建webapp目录

 3、在刚创建的webapp目录下创建WEB-INF目录，在WEB-INF目录下创建web.xml

 

3、配置web.xml

注册SpringMVC的前端控制器DispatcherServlet

在web.xml中配置配置SpringMVC的前端控制器，对浏览器发送的请求进行统一处理

a>默认配置方式

 此配置作用下，SpringMVC的配置文件默认位于WEB-INF下，默认名称为<servlet-name>-servlet.xml，例如，以下的配置所对应对 SpringMVC的配置文件位于WEB-INF下，文件名为springMVC-servlet.xml

 <!--我们需要保证servlet中的servlet-name与servlet-mapping中的servlet-name
        保持一致，这样就能保证servlet和servlet-mapping这两个共同来注册一个servlet
    -->
    <!--配置SpringMVC的前端控制器，对浏览器发送的请求统一进行处理-->
    <servlet>
        <servlet-name>springMVC</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>springMVC</servlet-name>
        <!--解释：
            设置springMVC的核心控制器所能处理的请求路径
            /所匹配的请求可以是/login或者.html或者.js或者.css方式的请求路径
            但是不能匹配.jsp请求路径的请求.

            为什么不能匹配.jsp是因为：.jsp本质也是一个servlet，它需要服务器里特殊的servlet,
            也可以说是指定的servlet来处理，而DispatcherServlet是进行统一处理的，处理不了这个.jsp
            的请求。如果被DispatcherServlet处理了，它就把.jsp的请求当作普通的请求进行处理了
            就不会找到其相对于的.jsp的页面
            而/*是包括.jsp的请求，这一点注意区分/与/*的区别
        -->
        <url-pattern>/</url-pattern>
    </servlet-mapping>

但是这样的配置不好，在现在的maven工程中，配置文件一般都位于resources目录下，所以有了如下的第二中配置方式

b>扩展配置方式

可以通过int-param标签设置SpringMVC配置文件的配置和名称，通过load-on-startup标签设置SpringMVC前端控制器DispatcherServlet的初始化时间。

    <!--第2种配置方式-->
    <servlet>
        <servlet-name>SpringMVC</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!--初始化参数
            是伴随着当前servlet的初始化来初始化的，
            使用它主要来配置SpringMVC配置文件的位置和名称
        -->
        <init-param>
            <!--这里为什么要用contextConfigLocation是因为，这里要使用SpringMVC已经
            在它的servlet中DispatcherServlet已经定义好的，我们直接在这为赋值即可
            然后它就有相对应的功能。
            contextConfigLocation表示的是上下文配置路径-->
            <param-name>contextConfigLocation</param-name>
            <!--设置位置和名称
             classpath:对应类路径也就是java和resources
             值就是springMVC.xml，这时就需要到resoures目录下创建springMVC.xml的配置文件
            -->
            <param-value>classpath:springMVC.xml</param-value>
        </init-param>
        <!--将SpringMVC的前端控制器DispatcherServlet
            的初始化时间提前到服务器启动时
            作为框架的核心组件，在启动过程中有大量的初始化操作要做
            而这些操作放在第一次请求时才执行会严重影响访问速度
            因此需要通过此标签将启动控制DispatcherServlet的初始化时间提前到服务器启动时
        -->
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>SpringMVC</servlet-name>
        <!--
            设置springMVC的核心控制器所能处理的请求的请求路径
            /所匹配的请求可以是/login或.html或.js或.css方式的请求路径
            但是/不能匹配.jsp请求路径的请求
        -->
        <url-pattern>/</url-pattern>
    </servlet-mapping>

注意：

<url-pattern>标签中使用/和/*的区别：
/所匹配的请求可以是/login或.html或.js或.css方式的请求路径，但是/不能匹配.jsp请求路径的请求
因此就可以避免在访问jsp页面时，该请求被DispatcherServlet处理，从而找不到相应的页面
/*则能够匹配所有请求，例如在使用过滤器时，若需要对所有请求进行过滤，就需要使用/*的写法

总结url-pattern的使用：

方式一：带后缀，比如*.action   *.do   *.aaa

方式二：/不会拦截  .jsp

方式三：/* 拦截所有的，包括.jsp

4、创建请求控制器

由于前端控制器对浏览器发送的请求进行了统一的处理，但是具体的请求有不同的处理过程，因此需要创建处理具体请求的类，即请求控制器

请求控制器中每一个处理请求的方法称为控制器方法

因为SpringMVC的控制器由一个POJO（普通的Java类）担任，因此需要通过@Controller注解将其标识为一个控制器组件，交给Spring的IOC容器管理，此SpringMVC才能够识别控制器的存在。

创建一个控制器HelloController.java

package com.zisu.mvc.controller;

import org.springframework.stereotype.Controller;

/**
 * @author xyf
 * @version 1.0
 * @date 2021/8/24 9:01
 */

@Controller
public class HelloController {
}

5、创建springMVC的配置文件

1)需要开启自动扫描包

2)配置Thymeleaf视图解析器

    <!--扫描组件-->
    <context:component-scan base-package="com.zisu.mvc.controller"></context:component-scan>

    <!-- 配置Thymeleaf视图解析器 -->
    <bean id="viewResolver" class="org.thymeleaf.spring5.view.ThymeleafViewResolver">
        <property name="order" value="1"/>
        <property name="characterEncoding" value="UTF-8"/>
        <property name="templateEngine">
            <bean class="org.thymeleaf.spring5.SpringTemplateEngine">
                <property name="templateResolver">
                    <bean class="org.thymeleaf.spring5.templateresolver.SpringResourceTemplateResolver">

                        <!-- 视图前缀 -->
                        <property name="prefix" value="/WEB-INF/templates/"/>

                        <!-- 视图后缀 -->
                        <property name="suffix" value=".html"/>
                        <property name="templateMode" value="HTML5"/>
                        <property name="characterEncoding" value="UTF-8" />
                    </bean>
                </property>
            </bean>
        </property>
    </bean>

    <!--
       处理静态资源，例如html、js、css、jpg
      若只设置该标签，则只能访问静态资源，其他请求则无法访问
      此时必须设置<mvc:annotation-driven/>解决问题
     -->
    <mvc:default-servlet-handler/>

    <!-- 开启mvc注解驱动 -->
    <mvc:annotation-driven>
        <mvc:message-converters>
            <!-- 处理响应中文内容乱码 -->
            <bean class="org.springframework.http.converter.StringHttpMessageConverter">
                <property name="defaultCharset" value="UTF-8" />
                <property name="supportedMediaTypes">
                    <list>
                        <value>text/html</value>
                        <value>application/json</value>
                    </list>
                </property>
            </bean>
        </mvc:message-converters>
    </mvc:annotation-driven>

6、测试HelloWorld

a>实现对首页的访问

在请求控制器中创建处理请求的方法

    //@RequestMapping注解：处理请求和控制器方法直接的映射关系
    //@RequestMapping注解的value属性可以通过请求地址匹配请求，/表示的当前工程的上下文路径
    //localhost:8080/springMVC/
    
    //"/"-->/WEB-INF/templates/index.html
    @RequestMapping(value = "/")
    public String index(){
        //返回视图名称
        return "index";
    }

b>通过超链接跳转到指定页面

在主页index.html中设置超链接

<!DOCTYPE html>
<html lang="en" xmlns:th="http://thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>首页</title>
</head>
<body>
    <h1>首页</h1>
<a th:href="@{/target}">访问目标页面target.html</a>
</body>
</html>

在请求控制器中创建处理请求的方法

  @RequestMapping("/target")
    public String toTarget(){
        return "target";
    }

7、总结

浏览器发送请求，若请求的地址符合前端控制器的url-pattern，该请求就会被前端控制器DispatcherServlet处理。前端控制器会读取器SpringMVC的核心配置文件，通过扫描组件找到控制器，将请求地址和控制器中的@RequestMapping注解的value属性值进行匹配，若匹配成功，该注解所标识的控制器方法就是处理请求的方法。处理请求的方法需要返回一个字符串类型的视图名称，该视图名称会被称为视图解析器解析，加上前缀和后缀组成的视图路径，通过Thymeleaf对视图进行渲染，最终转发到视图所对应的页面。

三、@RequestMapping注解

1、@RequestMapping注解的作用

从注解名称上看我们可以看到，@RequestMapping注解的作用就是将请求和处理请求的控制器方法关联起来，建立映射关系。

SpringMVC接收到指定请求，就会来找到在映射关系中对应的控制器方法来处理这个请求

注意如果有两个相同的请求路径，会服务器会报错。

RequestMapping注解中的value属性的/表示的是：当前工程的上下文路径为：localhost:8080/springMVC/

例如我在Controller类中配置的映射路径为：/hello/testRequestMapping  会在浏览器中被dispatcherServlet进行处理加上当前工程的上下文路径，所以最好在浏览器地址栏中最终显示的是localhost:8080/hello/testRequestMapping

在Thymeleaf中如下图：

这里的@相当于会在前面添上/springMVC，而这里的/就是浏览器的上下文路径localhost:8080/ 

F12显示的

 

 这里浏览器解析的/springMVC前的/会被解析为localhost:8080/  所以这里连起来就是：localhost:8080/springMVC/hello/testRequestMapping