Spring MVC学习 | 简介&HelloWord

---

学习视频🎥：https://www.bilibili.com/video/BV1Ry4y1574R

一、Spring MVC简介

1.1 MVC回顾

💡 详细解释可参见MVC开发模式&三层架构简记

💬概述：MVC 是一种软件架构的思想，将软件分为模型、视图和控制器

🔑各个组成部分

① M --> model 模型：表示工程中的JavaBean，作用是封装和处理数据

❓ 这里的JavaBean分为两类

1. 实体类Bean：用于封装和存储业务数据
2. 业务处理Bean：表示service层对象和dao层对象，用于处理业务逻辑和数据访问

② V --> view 视图：表示工程中的html 和jsp等页面。作用是与用户交互和展示数据

③ C --> controller 控制器：表示工程中的servlet，作用是接受请求和响应浏览器

1.2 Spring MVC是神魔

💬概述：Spring MVC是Spring的一个后续产品，是Spring的子项目，也是Spring为表示层开发提供的一套完备的解决方案

❓ 表示层（表述层）：三层架构中其中一层，表示前台页面（html和jsp）和后台servlet，具体可参见MVC开发模式&三层架构简记

🔑主要特点

• Spring MVC 是Spring家族原生产品，所以Spring 上的配置（IOC、AOP等）对Spring MVC同样适用
• 基于原生的servlet，提供功能更强大的前端控制器DispatcherServlet，将请求和响应进行统一处理
• 代码简洁，提高开发效率

---

二、HelloWord

2.1 相关文件的准备

🔑导入相关jar包：spring-webmvc、logback-classic（日志包）、javax.servlet-api、thymeleaf-spring5（视图解析器）

🔑在web.xml 中注册（配置）前端控制器

① 默认配置方式（不推荐）：按照普通Servlet的配置方式，在web.xml中配置DispatcherServlet。默认配置方式下，springmvc的配置文件会默认生成在WEB-INF目录下，文件名默认为“<servlet-name>标签值-servlet.xml”，如这里演示的配置的名称配置文件名为“SpringMVC-servlet.xml”

<!-- 配置DispatcherServlet，对浏览器的请求进行统一处理 -->
<servlet>
	<servlet-name>SpringMVC</servlet-name>
    <servlet-class>DispatcherServlet的全类名（在spring相关jar包中）</servlet-class>
</servlet>
<servlet-mapping>
	<servlet-name>SpringMVC</servlet-name>
    <!-- 资源路径要设置为 / -->
    <url-pattern>/</url-pattern>
</servlet-mapping>

❓ 为什么不推荐默认方式：因为以后项目都是基于maven工程，而maven工程的资源配置文件一般都是放在src/main/resource目录下，不会放在WEB-INF目录下，WEB-INF目录下一般存放页面文件
❓ 关于/的疑问

1. 为什么资源路径设置为/：以前配置servlet资源路径时，都是一个请求对应一个servlet，所以servlet资源路径一般都是固定的，如/userServlet，前端控制器要对浏览器的请求进行统一处理，而不是只处理一个请求，不能把资源路径写成固定，所以需要设置为/

2. /表示什么：表示当前浏览器发起的所有请求，包括/login、/register、.html、.css、.js等请求路径，但不包括.jsp为后缀的请求路径

3. 为什么/不能匹配.jsp请求路径：jsp文件本质上就是一个servelt，它需要服务器指定的servlet来处理，不需要前端控制器处理。如果请求路径中包括了jsp，Spring MVC（或者说前端控制器）会将它作为普通的请求进行处理，而不会去找jsp对应的页面

4. /*与/的区别：/*能匹配浏览器发起的所有请求，包括.jsp，一般在过滤器中设置/*，实现对所有请求进行过滤

② 扩展配置方式（推荐）：扩展方式配置方式基于默认方式。在<servlet>标签内添加<init-param>标签，初始化springmvc配置文件的位置和名称，并通过<load-on-startup>标签设置DispatcherServlet初始化的时间

<!-- 配置DispatcherServlet，对浏览器的请求进行统一处理 -->
<servlet>
  
	<servlet-name>SpringMVC</servlet-name>
    <servlet-class>DispatcherServlet的全类名（在spring相关jar包中）</servlet-class>
    
    <!-- 使用初始化参数标签，初始化springmvc配置文件的位置和名称 -->
    <init-param>
    	<!-- 参数名固定为ContextConfigLocation（上下文配置路径） -->
        <param-name>ContextConfigLocation</param-name>
        <!-- 
			参数值为springmvc配置文件位置和名称（自定义）
 			 - classpath：对应类路径，映射到工程中的src/main目录下，可以直接找到src/main/resource目录下的配置文件
		-->
        <param-value>classpath:springmvc.xml</param-value>
    </init-param>
    
    <!-- 将前端控制器的初始化操作提前到服务器启动时 -->
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
	<servlet-name>SpringMVC</servlet-name>
    <!-- 资源路径要设置为 / -->
    <url-pattern>/</url-pattern>
</servlet-mapping>

❓ 为什么要提前前端控制器的初始化

​ 前端控制器本身也是servlet，servlet默认初始化时间为第一次访问时，而前端控制器作为Spring MVC的核心组件，需要做大量的初始化操作，因此在会大大减慢第一次访问时的速度，所以需要将初始化时间提前至服务器启动时

🔑<load-on-startup>标签的作用（扩展知识）：标记容器是否在启动的时候就加载（初始化）这个servlet

👀 参考博文：servlet配置load-on-startup的作用

1. 当值为0或者大于0时，表示容器在应用启动时就加载这个servlet
2. 当是一个负数时或者没有指定时，则指示容器在该servlet被选择时才加载
3. 正数的值越小，启动该servlet的优先级越高

2.2 创建请求控制器

🔑请求控制器：请求控制器就是用来处理具体请求的类（POJO），因为前端控制器对浏览器所有请求进行统一的处理，但具体请求又需要不同的处理方式，所以需要请求控制器来完成该工作，同时控制器中添加多个控制器方法，对每一个请求进行具体处理

💡 请求控制器本身是一个普通的Java类（POJO），需要在类上添加@Controller注解（使用注解前需要在springmvc配置文件开启组件扫描），将该类标识为控制层组件，交给Spring IOC容器管理，这样Spring MVC才能识别出请求控制器

@Controller
public class HelloController {
    // code...
}

2.3 创建Spring MVC配置文件

① 在src/main/resource目录下创建Spring MVC配置文件，文件名与web.xml配置的名称保持一致（这里设置为springmvc.xml）

💡 这里创建的不是普通的xml文件，而是“Spring Config”类型的xml文件

② 使用<context:component-scan>标签开启控制器的组件扫描

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

③ 添加thymeleaf视图解析器

💡 对于thymeleaf视图解析器的配置，只关心内部bean中设置视图前缀和视图后缀，其他不用修改

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

2.4 测试HelloWord

2.4.1 访问首页

① 在WEB-INF目录下创建templates目录，再在template目录下创建首页（index.html）

💡 因为配置的视图解析器中，视图前缀值设置为/WEB-INF/templates/，所以首页必须建立在/WEB-INF/templates下，不然无法访问，其他页面的创建也一样

<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>首页</title>
    </head>
    <body>
        <h1>HelloWord</h1>
    </body>
</html>

② 在请求控制器中添加对应的控制器方法String toIndex()，方法上添加@RequestMapping注解，注解中添加value属性，属性值为"/"，即当前请求地址，返回值为视图名称（页面名），即"index"

🔺 分析控制器方法

• RequestMapping注解：注解的作用是将当前请求和控制器方法创建映射关系，注解中的value属性值就是当前请求地址，这里只设置value一个属性，所以可以省略value不写。后面会再讲解该注解
• 返回类型：返回类型必须是String类型
• 返回值：返回值对应视图名称，该视图名称就决定了要访问的页面，因为thymeleaf视图解析器会对该返回值进行解析，在返回值前后加上视图前缀（“/WEB-INF/templates/”）和视图后缀（“.html”），从而得到完整的页面路径（“/WEB-INF/templates/index.html”），最后根据完整的路径请求转发到对应页面
• 方法名：控制器方法名是任意的，因为当前请求匹配到对应的控制器方法与方法名无关

@RequestMapping("/")
public String toIndex() {
    // 返回视图名称
    return "index";
}

2.4.2 访问目标页面

① 在WEB-INF/templates目录下创建目标页面（target.html）

<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>目标页面</title>
    </head>
    <body>
        <span>目标页面!</span>
    </body>
</html>

② 在首页index.html中添加超链接，实现跳转到目标页面target.html，跳转的链接使用thymeleaf语法设置为绝对路径

🔺 关于路径的设置：推荐使用绝对路径，在超链接中设置的绝对路径由浏览器解析，而浏览器会将最前面的/解析成http://ip地址：端口号，因此需要在路径前加上工程路径（上下文路径、虚拟目录），而工程路径是可以修改的，所以需要动态获取，使用thymeleaf语法就可以动态获取工程路径（jsp指令、EL表达式也可以动态获取，但该页面是html，所以不支持jsp语法）

🔺 thymeleaf语法的使用：在页面的头标签<html>中添加thymeleaf命名空间xmlns:th="http://www.thymeleaf.org"

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
    <head>
        <meta charset="UTF-8">
        <title>首页</title>
    </head>
    <body>
        <h1>HelloWord</h1> <br/>

        <!-- 使用thymeleaf语法实现页面跳转，可以动态获取工程路径 -->
        <a th:href="@{/target}">目标页面</a>
    </body>
</html>

③ 在控制器中添加对应的控制器方法toTarget()，方法对应的请求地址为/target，与index.html中设置的保持一致，返回值为"target"，也要与目标视图的名称保持一致

@RequestMapping("/target")
public String toTarget() {
    // 返回视图名
    return "target";
}

2.5 执行流程