文章目录
- 一、Spring MVC简介
- 1.1 MVC回顾
- 1.2 Spring MVC是神魔
- 二、HelloWord
- 2.1 相关文件的准备
- 2.2 创建请求控制器
- 2.3 创建Spring MVC配置文件
- 2.4 测试HelloWord
- 2.4.1 访问首页
- 2.4.2 访问目标页面
- 2.5 执行流程
学习视频🎥：https://www.bilibili.com/video/BV1Ry4y1574R
一、Spring MVC简介
1.1 MVC回顾
💡 详细解释可参见MVC开发模式&三层架构简记
💬概述：MVC 是一种软件架构的思想，将软件分为模型、视图和控制器
🔑各个组成部分
① M --> model 模型：表示工程中的JavaBean，作用是封装和处理数据
❓ 这里的JavaBean分为两类
- 实体类Bean：用于封装和存储业务数据
- 业务处理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目录下一般存放页面文件
❓ 关于/的疑问
为什么资源路径设置为
/：以前配置servlet资源路径时，都是一个请求对应一个servlet，所以servlet资源路径一般都是固定的，如/userServlet，前端控制器要对浏览器的请求进行统一处理，而不是只处理一个请求，不能把资源路径写成固定，所以需要设置为/
/表示什么：表示当前浏览器发起的所有请求，包括/login、/register、.html、.css、.js等请求路径，但不包括.jsp为后缀的请求路径为什么
/不能匹配.jsp请求路径：jsp文件本质上就是一个servelt，它需要服务器指定的servlet来处理，不需要前端控制器处理。如果请求路径中包括了jsp，Spring MVC（或者说前端控制器）会将它作为普通的请求进行处理，而不会去找jsp对应的页面
/*与/的区别：/*能匹配浏览器发起的所有请求，包括.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的作用
- 当值为0或者大于0时，表示容器在应用启动时就加载这个servlet
- 当是一个负数时或者没有指定时，则指示容器在该servlet被选择时才加载
- 正数的值越小，启动该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 执行流程
