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 文件。
步骤如下:
- 点击“-”号,移除现有的web结构,如下:
- 选中项目并点击“+”新增web结构:
- 如下操作,增加webapp资源路径到src/main:
- 如下操作,增加新的web.xml 文件到webapp目录下:
- 成功设置后,打开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>
如上配置关键点说明:
- “/*”能够匹配到jsp页面,“/”则不能匹配jsp页面。因为jsp 的本质就是Servlet ,jsp需要当前服务器中指定的特殊的Servlet 来处理的,所以".jsp" 为后缀的请求路径不需要SpringMVC 提供的 DispatcherServlet 来处理。因此这里不需要来匹配“.jsp”,所以这里用“/”。
- 如果这里用“/*”,那么“.jsp”为后缀的请求也会被DispatcherServlet 来处理。那么SpringMVC就会把当前的“.jsp”当作普通的请求来处理,而不会去找到相应的jsp 页面。所以我们访问相应的jsp,就找不到相应的jsp 页面了。
- 所以我们这里要用“/”将“.jsp”请求过滤掉,其它所有请求都交给前端控制器。
- /*则能够匹配所有请求,例如在使用过滤器时,若需要对所有请求进行过滤,就需要使用/*的写法
(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对视图进行渲染,最终转发到视图所对应页面。(从上面的例子可以看到,请求后跳转的页面上的地址发生了改变,证明是转发方式)