文章目录
- 一、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 执行流程
一、Spring MVC简介
1.1 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 执行流程