文章目录

  • 一、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分为两类

  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 执行流程

SpringMVC中DispatcherServlet的作用 springmvc的作用是什么_后端