笔记来源：【尚硅谷】SpringMVC教程丨一套快速上手spring mvc
课程介绍
什么是 MVC？
MVC 是一种软件架构思想，将软件分为模型、视图、控制器三部分
- M（Model，模型层）：处理数据的 JavaBean 类
- 实体类 Bean：存储业务数据
- 业务处理 Bean：Service 或 Dao，处理业务逻辑和数据访问
- V（View，视图层）：展示数据的 HTML 页面，与用户进行交互
- C（Controller，控制层）：接受请求和响应的 Servlet
MVC 工作流程
- 用户通过视图层发送请求到服务器，在服务器中请求被Controller 接收
- Controller 调用相应的 Model 层处理请求
- Model 层处理完毕将结果返回到 Controller
- Controller 再根据请求处理的结果找到相应的 View 视图
- View 视图渲染数据后最终响应给浏览器
什么是 SpringMVC？
SpringMVC 是 Spring 的一个后续产品，是Spring的一个子项目
SpringMVC 是 Spring 为表述层开发提供的一整套完备的解决方案。在表述层框架历经 Struts、WebWork、Strust2 等诸多产品的历代更迭之后，目前业界普遍选择了 SpringMVC 作为 JavaEE 项目表述层开发的首选方案
注：三层架构分为表述层（或表示层）、业务逻辑层、数据访问层，表述层表示前台页面和后台 Servlet
SpringMVC 的特点
- Spring 家族原生产品：与 IOC 容器等基础设施无缝对接
- 基于原生的 Servlet：通过了功能强大的前端控制器 DispatcherServlet，对请求和响应进行统一处理
- 全面解决方案：表述层各细分领域需要解决的问题全方位覆盖
- 代码清新简洁：大幅度提升开发效率
- 即插即用：内部组件化程度高，组件可插拨，想要什么功能配置相应组件即可
- 性能卓著：尤其适合现代大型、超大型互联网项目要求
HelloWorld
开发环境
- IDE：idea 2021.1
- 构建工具：maven-3.8.3
- 服务器：tomcat7
- Spring版本：5.3.16
创建 Maven 工程
1）新建工程，默认 NEXT
2）填写工程名称、保存为止和 GAV 坐标，点击 FINISH
3）pom.xml中添加并导入依赖
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
| <dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.3.16</version>
</dependency>
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.2.11</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>4.0.1</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>org.thymeleaf</groupId>
<artifactId>thymeleaf-spring5</artifactId>
<version>3.0.15.RELEASE</version>
</dependency>
</dependencies>
|
根据依赖的传递性，相关的依赖也会被导入
4）项目工程结构中添加 web 模块，注意web.xml的路径要放在src\main\webapp下
完成后的目录结构
配置 web.xml
为什么要配置web.xml？注册 SpringMVC 的前端控制器 DispatcherServlet
1）默认配置方式
此配置作用下，SpringMVC 的配置文件默认位于 WEB-INF 下，默认名称为<servlet-name>-servlet.xml
例如，以下配置所对应 SpringMVC 的配置文件位于 WEB-INF 下，文件名为springMVC-servlet.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
<servlet>
<servlet-name>springMVC</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>springMVC</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
|
默认配置方式对位置和名称都是默认的，这样并不好！Maven 工程配置文件应该统一放置在resources下，应该如何来实现呢？来看下面的“扩展配置方式”
2）扩展配置方式
- 通过
init-param标签设置 SpringMVC 配置文件的位置和名称
- 通过
load-on-startup标签设置 SpringMVC 前端控制器 DispatcherServlet 的初始化时间
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
|
<servlet>
<servlet-name>springMVC</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<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>
|
注：<url-pattern>标签中使用/和/*的区别：
/所匹配的请求可以是/login或.html或.js或.css方式的请求路径，但是/不能匹配.jsp请求路径的请求
因此就可以避免在访问.jsp页面时，该请求被 DispatcherServlet 处理，从而找不到相应的页面的情况
/*则能够匹配所有请求，例如在使用过滤器时，若需要对所有请求进行过滤，就需要使用/*的写法
创建请求控制器
由于前端控制器对浏览器发送的请求进行了统一的处理，但是具体的请求有不同的处理过程，因此需要创建处理具体请求的类，即请求控制器
请求控制器中每一个处理请求的方法称为控制器方法
因为 SpringMVC 的控制器由一个 POJO（普通 Java 类）担任，因此需要通过@Controller注解将其标识为一个控制层组件，交给 Spring 的 IOC 容器管理，此时 SpringMVC 才能够识别控制器的存在
1
2
3
| @Controller
public class HelloController {
}
|
创建 SpringMVC 配置文件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
|
<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
http://www.springframework.org/schema/context/spring-context.xsd">
<context:component-scan base-package="com.vectorx.springmvc"></context:component-scan>
<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>
|
测试
1）访问首页
创建首页 src/main/webapp/WEB-INF/templates/index.html
1
2
3
4
5
6
7
8
9
10
| <!doctype html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<title>首页</title>
</head>
<body>
<h1>首页</h1>
</body>
</html>
|
在请求控制器中创建处理请求的方法
1
2
3
4
5
6
7
8
|
@RequestMapping("/")
public String index() {
return "index";
}
|
访问首页
2）访问指定页面
在主页index.html创建超链接
1
| <a href="/target">访问指定页面target.html</a>
|
但是这种写法是不行的，可以看到，当鼠标悬浮在超链接上时，左下角的跳转路径提示信息从 8080 下访问的
这是因为我们是以/开头的，它分为浏览器解析和服务器解析两种方式，而超链接中的绝对路径就是由浏览器解析的，而不是从上下文路径访问
虽然我们可以通过添加上下文的方式实现，因为上下文路径可以改，所以这种方式肯定是杜绝的
1
| <a href="/SpringMVC/target">访问指定页面target.html</a>
|
那应该如何处理呢？这里就可以使用thymeleaf来动态获取上下文路径
- 首先需要在
<html>标签中引入thymeleaf的命名空间xmlns:th="http://www.thymeleaf.org"
- 然后使用
th:前缀修饰标签属性，这里使用th:href来修饰<a>标签的<href>属性
- 最后
th:href中的属性值中包裹一层@{}，这里值为@{/target.html}
1
2
3
4
5
6
7
8
9
10
11
| <!doctype html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8" />
<title>首页</title>
</head>
<body>
<h1>首页</h1>
<a th:href="@{/target}">访问指定页面target.html</a>
</body>
</html>
|
同时，后台请求控制器也要加上对target请求进行处理的控制器方法
1
2
3
4
| @RequestMapping("/target")
public String toTarget() {
return "target";
}
|
访问指定页面
跳转成功
SpringMVC 请求处理底层原理
- 浏览器发送请求，若请求地址符合前端控制器的
url-pattern，该请求就会被前端控制器 DispatcherServlet 处理
- 前端控制器会读取 SpringMVC 的核心配置文件，通过扫描组件找到控制器，将请求地址和控制器中
@RequestMapping注解的value属性值进行匹配。若匹配成功，该注解所标识的控制器方法就是处理请求的方法
- 处理请求的方法需要返回一个字符串类型的视图名称，该视图名称会被视图解析器解析，加上前缀和后缀组成视图的路径，通过 Thymeleaf 对视图进行渲染，最终转发到视图所对应页面
附录：SpringMVC 工程创建整体流程
概览
- 1）配置
pom.xml、web.xml、springMVC.xml
- 2）创建前台页面和后台请求控制器
详解
1）添加pom.xml依赖
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
| <?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.vectorx</groupId>
<artifactId>springmvc-demo</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>war</packaging>
<properties>
<maven.compiler.source>8</maven.compiler.source>
<maven.compiler.target>8</maven.compiler.target>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.3.16</version>
</dependency>
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.2.11</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>4.0.1</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>org.thymeleaf</groupId>
<artifactId>thymeleaf-spring5</artifactId>
<version>3.0.15.RELEASE</version>
</dependency>
</dependencies>
</project>
|
2）创建web.xml配置文件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
| <?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">
<servlet>
<servlet-name>springMVC</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<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>
</web-app>
|
3）创建springMVC.xml配置文件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
| <context:component-scan base-package="com.vectorx.springmvc"></context:component-scan>
<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>
|
4）创建前台页面
index.html
1
2
3
4
5
6
7
8
9
10
11
| <!doctype html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8" />
<title>首页</title>
</head>
<body>
<h1>首页</h1>
<a th:href="@{/target}">访问指定页面target.html</a>
</body>
</html>
|
target.html
1
2
3
4
5
6
7
8
9
10
| <!doctype html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<title>HelloWorld</title>
</head>
<body>
<h1>Hello World!</h1>
</body>
</html>
|
5）创建Controller请求控制器
1
2
3
4
5
6
7
8
9
10
11
12
| @Controller
public class HelloController {
@RequestMapping("/")
public String index() {
return "index";
}
@RequestMapping("/target")
public String toTarget() {
return "target";
}
}
|
总结
最后奉上本节导图，内容仅供参考
