SpringMVC 笔记

1. SpringMVC 简介

1.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视图，渲染数据后最终响应给浏览器。

1.2 什么是SpringMVC

SpringMVC是Spring的一个后续产品，是Spring的一个子项目。

SpringMVC 是 Spring 为表述层（也叫表示层）开发提供的一整套完备的解决方案。在表述层框架历经 Strust、WebWork、Strust2 等诸多产品的历代更迭之后，目前业界普遍选择了 SpringMVC 作为 Java EE 项目表述层开发的首选方案。

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

1.3 SpringMVC 的特点

（1）Spring 家族原生产品，与 IOC 容器等基础设施无缝对接

（2）基于原生的Servlet，通过了功能强大的前端控制器DispatcherServlet，对请求和响应进行统一处理

（3）表述层各细分领域需要解决的问题全方位覆盖，提供全面解决方案

（4）代码清新简洁，大幅度提升开发效率

（5）内部组件化程度高，可插拔式组件即插即用，想要什么功能配置相应组件即可

（6）性能卓著，尤其适合现代大型、超大型互联网项目要求

2. 安装配置Maven

Maven是Apache的一个纯Java开发的开源项目管理工具，基于项目对POM概念。除此之外，Gradle也是一个极好的项目管理工具，Gradle是一个基于Apache Ant和Apache Maven概念的项目自动化构建开源工具。它使用一种基于Groovy的特定领域语言(DSL)来声明项目设置，也增加了基于Kotlin语言的kotlin-based DSL，抛弃了基于XML的各种繁琐配置。面向Java应用为主。当前其支持的语言C++、Java、Groovy、Kotlin、Scala和Swift，计划未来将支持更多的语言。Gradle是一个基于JVM的构建工具，是一款通用灵活的构建工具，支持maven， Ivy仓库，支持传递性依赖管理，而不需要远程仓库或者是pom.xml和ivy.xml配置文件，基于Groovy，build脚本使用Groovy编写。

下载maven。地址：

Maven – Download Apache Maven

Maven – Download Apache Maven

建议下载3.0以上版本。

解压下载包，Maven不需要执行文件来安装，直接将文件解压即可使用，但要配置系统环境变量，如下：

cmd验证配置结果

Maven安装成功。

详细的Maven知识可以参考本人专栏中的文章：

(1) maven基础_menergy-CSDN博客

maven基础_龙泉太阿的博客-CSDN博客

(2) 搭建Nexus仓库管理器（私服）_menergy-CSDN博客

搭建Nexus仓库管理器（私服）_龙泉太阿的博客-CSDN博客

3. 第一个SpringMVC实例

3.1 开发环境

IDE： idea 2022.3.2

构建工具：maven 3.8.4

服务器：tomcat 9

Spring 版本：5以上

3.2 创建Maven工程

（1）首先创建一个空工程：

（2）基于当前的工程创建一个Module

（3）创建一个web 模块

（4）修改POM文件，注意打包方式为“war”，并加入相关依赖：

问题：发现IDE无法自动导入相关依赖

解决：打开右边的Maven选项卡，然后点击刷新图标，则会重新加载项目及引入相关依赖。

具体引入的依赖如下：

      <!-- 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>

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

查看具体依赖结构如下：

说明：如下ServletAPI依赖的jar包，依赖范围scope 的值设置为provided，表示该jar已被提供（已被服务器提供），因为当前的服务器中已经提供了Servlet 的jar 包，所以这里设置为provided，这样当我们的web 工程被打包成war 包时，这个Servlet 的jar包就不会存在于war包的WEB-INF/lib目录下。

（5）配置web.xml

情况一：如果创建maven 模块时，用的Archetype 是“maven-archetype-webapp”模板，可能生成的web.xml 的内容格式如下，不是我们想要的，那么需要删除并重新生成web.xml 文件。

步骤如下：

1. 点击“-”号，移除现有的web结构，如下：

1. 选中项目并点击“+”新增web结构：

1. 如下操作，增加webapp资源路径到src/main:

1. 如下操作，增加新的web.xml 文件到webapp目录下：

1. 成功设置后，打开web.xml 文件，发现内容已经是4.0版本的配置。

情况二：如果一开始在项目结构中就没有web.xml 文件，只需要设置项目结构中加入，右键项目，步骤如下：

3.3 配置 web.xml

注册SpringMVC的前端控制器DispatcherServlet

（1）默认配置方式

此配置作用下，SpringMVC的配置文件默认位于WEB-INF下，默认名称为<servlet-name>-servlet.xml （<servlet-name>标签的内容加上“-servlet.xml”），例如，以下配置所对应SpringMVC的配置文件位于WEB-INF下，文件名为springMVC-servlet.xml。

（但是这种方式有点不好，因为maven工程下，一般我们的配置文件要统一放在src/main/resources 目录下，所有不推荐这种配置方式）

    <!-- 配置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页面。 / 则不能。

        -->

        <url-pattern>/</url-pattern>

    </servlet-mapping>

如上配置关键点说明：

1. “/*”能够匹配到jsp页面，“/”则不能匹配jsp页面。因为jsp 的本质就是Servlet ，jsp需要当前服务器中指定的特殊的Servlet 来处理的，所以".jsp" 为后缀的请求路径不需要SpringMVC 提供的 DispatcherServlet 来处理。因此这里不需要来匹配“.jsp”,所以这里用“/”。
2. 如果这里用“/*”，那么“.jsp”为后缀的请求也会被DispatcherServlet 来处理。那么SpringMVC就会把当前的“.jsp”当作普通的请求来处理，而不会去找到相应的jsp 页面。所以我们访问相应的jsp，就找不到相应的jsp 页面了。
3. 所以我们这里要用“/”将“.jsp”请求过滤掉，其它所有请求都交给前端控制器。
4. /*则能够匹配所有请求，例如在使用过滤器时，若需要对所有请求进行过滤，就需要使用/*的写法

（2）扩展配置方式（推荐使用）

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

（主要目的是，要将当前的配置文件不要放在WEB-INF下，因为WEB-INF上一般只放页面，如html页面）

在resources 目录下新建springMVC.xml配置文件：

完整web.xml 配置如下：

<?xml version="1.0" encoding="UTF-8"?>

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"

         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"

         version="4.0">

    <!-- 配置SpringMVC的前端控制器，对浏览器发送的请求统一进行处理 -->

    <servlet>

        <servlet-name>springMVC</servlet-name>

        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>

        <!-- 通过初始化参数指定SpringMVC配置文件的位置和名称 -->

        <init-param>

            <!-- contextConfigLocation为固定值 -->

            <param-name>contextConfigLocation</param-name>

            <!-- 使用classpath:表示从类路径查找配置文件(即使java 和 resources 路径)，例如maven工程中的src/main/resources -->

            <param-value>classpath:springMVC.xml</param-value>

        </init-param>

        <!--

             作为框架的核心组件，在启动过程中有大量的初始化操作要做

            而这些操作放在第一次请求时才执行会严重影响访问速度

            因此需要通过此标签将启动控制DispatcherServlet的初始化时间提前到服务器启动时

        -->

        <load-on-startup>1</load-on-startup>

    </servlet>

    <servlet-mapping>

        <servlet-name>springMVC</servlet-name>

        <!--

            设置springMVC的核心控制器所能处理的请求的请求路径

            /所匹配的请求可以是/login或.html或.js或.css方式的请求路径

            但是/不能匹配.jsp请求路径的请求。

            这里值得注意的是：/ 与 /* 的区别。/* 能够匹配到jsp页面。 / 则不能。

        -->

        <url-pattern>/</url-pattern>

    </servlet-mapping>

</web-app>

3.4 创建请求控制器

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

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

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

3.5 配置 springMVC 配置文件

（1）在springMVC.xml 中配置包扫描和Thymeleaf 视图解析器

<?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 https://www.springframework.org/schema/context/spring-context.xsd">

    <!--自动扫描包-->

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

    <!-- 配置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>

</beans>

（2）根据配置的Thymeleaf ，在WEB-INF 下新建文件夹“tempalate”，然后在 文件夹下新建index.html页面（HTML5 的页面），如下：

（3）在index.html 中加入thymeleaf 的支持的命名空间的配置，并设置到html 模板中：

设置完成后，尝试删除项目中的index.html 文件，重新新建该文件，看模板的设置效果：

3.6 测试HelloWorld

（1）实现对首页的访问

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

配置Tomcat：具体也可以参考《Maven 笔记》文章

配置好后，启动Tomcat，这里用debug模式：

问题：访问后发现识别错误页面，是因为我的项目中存在一个同名称的index.jsp 页面

解决：删除同名称的index.jsp 页面，然后重启服务后再次访问，看会不会显示index.html 的页面结果

显示成功。

（2）访问指定页面

访问：http://localhost:8080/springMVC/

点击链接：

注：以“/”开头的路径是表示绝对路径，绝对路径又分为服务器解析的和浏览器解析的。比如说，html页面中超链接中所写的绝对路径是由浏览器解析的，“/”表示的是从“localhost:8080”下访问。

（3）总结

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