Spring入门(十二)：Spring MVC使用讲解

今天药忘吃喽~ 2023-10-11 11:28 31阅读 0赞

## 1. Spring MVC介绍 ##

提到MVC，参与过Web应用程序开发的同学都很熟悉，它是展现层(也可以理解成直接展现给用户的那一层)开发的一种架构模式，M全称是Model，指的是数据模型，V全称是View，指的是视图页面，如JSP、Thymeleaf等，C全称是Controller，指的是控制器，用来处理用户在客户端（浏览器）发起的请求。

Spring MVC就是基于MVC模式实现，能够帮你构建像Spring框架那样灵活和松耦合的Web应用程序。

也就是说，Spring MVC是基于Spring的，它主要用来开发Web应用程序。

## 2. Spring MVC请求流程 ##

在Web应用程序中，请求是必不可少的，每次请求由用户(客户端)发起，到用户(客户端)接收到响应结束，下图展示了一个请求在Spring MVC中所经历的每个流程：

![format_png][]

接下来我们对图中的每个流程做下讲解：

1.  请求离开浏览器时（图中的①），会带有用户所请求内容的信息，比如请求的URL和提交的表单信息。
2.  然后进入到请求的第一站，即Spring的DispatcherServlet，它的任务是将请求发送给Spring MVC控制器。
3.  因为在应用程序中会有多个控制器，因此DispatcherServlet会查询一个或多个处理器映射(handler mapping)，处理器映射会根据请求所携带的URL来确定应该将请求发送给哪个控制器（图中的②）。
4.  确定好控制器后，DispatcherServlet会将请求发送给确定好的控制器，然后等待控制器处理用户提交的信息，不过一般情况下，控制器本身几乎不处理工作，而是将业务逻辑委托给一个或多个服务对象进行处理（图中的③）。
5.  控制器完成业务逻辑处理后，通常会产生一些模型(Model)信息，这些信息需要返回给用户并在浏览器上显示，为了更友好的展示这些信息，比如以Html形式展示，我们需要将信息发送给一个视图(View)，比如JSP、Thymeleaf。
6.  控制器所做的最后一件事就是将模型数据打包，并且标示出用于渲染输出的视图名，它会将请求连同模型和视图名发送回DispatcherServlet（图中的④），不过控制器只会返回一个视图的逻辑名称，而不是返回具体的某个特定视图，这个逻辑名称将会用来查找产生结果的真正视图。DispatcherServlet会使用视图解析器(view resolver)来将逻辑视图名匹配为某个特定视图（图中的⑤），比如JSP或者Thymeleaf。
7.  请求的最后一站是视图的实现（图中的⑥），在这里视图将使用模型数据渲染输出，这个输出会通过响应对象传递给用户/客户端（图中的⑦）。

了解了Spring MVC的请求流程后，我们来接着了解下如何搭建和配置Spring MVC项目。

## 3. 搭建Spring MVC项目 ##

我们仍然延用之前博客中新建的spring-action项目，有兴趣的同学可以看下本系列的前11篇博客或者直接下载源码：[https://github.com/zwwhnly/spring-action.git][https_github.com_zwwhnly_spring-action.git]。

### 3.1 添加依赖 ###

要想使用Spring MVC，首先我们需要在pom.xml中添加如下依赖：

<dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>4.3.18.RELEASE</version>
    </dependency>
    
    
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>jstl</artifactId>
        <version>1.2</version>
    </dependency>
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>4.0.1</version>
        <scope>provided</scope>
    </dependency>

因为后面要将项目部署到Tomcat，所以我们在pom.xml中配置下打包方式为war包：

<packaging>war</packaging>
    
    <build>
        <plugins>
            
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-war-plugin</artifactId>
                <version>3.2.3</version>
                <configuration>
                    <failOnMissingWebXml>false</failOnMissingWebXml>
                </configuration>
            </plugin>
        </plugins>
    </build>

### 3.2 新建演示页面 ###

在src/main/resources下新建views目录，然后在此目录下新建index.jsp页面如下所示：

<%@ page contentType="text/html;charset=UTF-8" language="java" pageEncoding="UTF-8" %>
    <html>
    <head>
        <title>Spring MVC</title>
    </head>
    <body>
        <pre>
            Welcome to Spring MVC world
        </pre>
    </body>
    </html>

这里可能存在的问题是，右键新建JSP文件时，没有JSP文件模板，就像下面这样：

![format_png 1][]

解决方案如下所示：

依次点击File–Project Structure，打开Project Structure对话框，左侧选中Modules，然后点击+号，选择Web

![format_png 2][]

![format_png 3][]

![format_png 4][]

此时再次右键新增JSP文件，就会看到JSP文件模板：

![format_png 5][]

此时项目根目录会生成1个web文件夹，可以将其删除。

![format_png 6][]

![format_png 7][]

### 3.3 Spring MVC配置 ###

新建配置类MyMvcConfig如下所示：

package chapter05.config;
    
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.ComponentScan;
    import org.springframework.context.annotation.Configuration;
    import org.springframework.web.servlet.config.annotation.EnableWebMvc;
    import org.springframework.web.servlet.view.InternalResourceViewResolver;
    import org.springframework.web.servlet.view.JstlView;
    
    /** * Spring MVC配置 */
    @Configuration
    @EnableWebMvc
    @ComponentScan("chapter05")
    public class MyMvcConfig { 
        /** * 视图解析器配置 * * @return */
        @Bean
        public InternalResourceViewResolver viewResolver() { 
            InternalResourceViewResolver viewResolver = new InternalResourceViewResolver();
    
            viewResolver.setPrefix("/WEB-INF/classes/views/");
            viewResolver.setSuffix(".jsp");
            viewResolver.setViewClass(JstlView.class);
    
            return viewResolver;
        }
    }

注意事项：

1)该配置类使用了`@EnableWebMvc`注解来启用Spring MVC，它会开启一些默认配置。

2)该配置类配置了视图解析器，这里我们配置的是JSP的视图解析器。

> 视图解析器中，我们设置了前缀和后缀，如果控制器中返回的逻辑视图名称是index，实际渲染时找的视图就是/WEB-INF/classes/views/index.jsp，为什么设置的前缀是/WEB-INF/classes/views/而不是/src/main/resources/views/呢，那是因为项目编译完运行时的目录是/WEB-INF/classes/views/。

![format_png 8][]

如果编译完成该目录下没有jsp文件，则需要在pom.xml中添加如下配置：

<build>
        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.jsp</include>
                    <include>**/*.js</include>
                </includes>
            </resource>
        </resources>
    </build>

### 3.4 Web配置 ###

新建Web配置类WebInitializer如下所示：

package chapter05.config;
    
    import org.springframework.web.WebApplicationInitializer;
    import org.springframework.web.context.support.AnnotationConfigWebApplicationContext;
    import org.springframework.web.servlet.DispatcherServlet;
    
    import javax.servlet.ServletContext;
    import javax.servlet.ServletException;
    import javax.servlet.ServletRegistration.Dynamic;
    
    public class WebInitializer implements WebApplicationInitializer { 
        @Override
        public void onStartup(ServletContext servletContext) throws ServletException { 
            AnnotationConfigWebApplicationContext context = new AnnotationConfigWebApplicationContext();
            context.register(MyMvcConfig.class);
            context.setServletContext(servletContext);
    
            Dynamic servlet = servletContext.addServlet("dispatcher", new DispatcherServlet(context));
            servlet.addMapping("/");
            servlet.setLoadOnStartup(1);
        }
    }

这里重点要关注的是，该类实现了接口WebApplicationInitializer并重写了onStartup()方法，WebApplicationInitializer类是Spring提供用来配置Servlet 3.0+版本配置的接口，从而可以替代掉web.xml。

### 3.5 新建控制器 ###

新建控制器HelloController如下所示：

package chapter05.controller;
    
    import org.springframework.stereotype.Controller;
    import org.springframework.web.bind.annotation.RequestMapping;
    
    @Controller
    public class HelloController { 
        @RequestMapping("/index")
        public String hello() { 
            // 这里返回的逻辑视图名
            return "index";
        }
    }

上面代码中的`@Controller`注解声明这是1个控制器，`@RequestMapping("/index")`用来配置URL映射，现在问题来了，我们如何查看代码的运行效果呢？

这就涉及到了项目打包和项目部署，我们继续往下看。

## 4. 项目部署到Tomcat中 ##

### 4.1 打包(war包) ###

因为我们的项目是通过Maven管理的，在pom.xml中也配置了打包方式为war包和打包插件，所以我们可以在IDEA的右侧找到Maven资源管理器，然后如下图所示，点击clean：

![format_png 9][]

然后再点击package：

![format_png 10][]

![format_png 11][]

最后生成的war包如下所示：

![format_png 12][]

这就是我们要部署到Tomcat中的war包。

### 4.2 Tomcat安装及部署 ###

既然要部署到Tomcat中，那么就有2个问题需要解答：

1.  什么是Tomcat？
2.  Tomcat如何安装？

先回答第1个问题，Tomcat是一个免费的开放源代码的轻量级的Web应用服务器，如果你接触过.NET的Web开发，它就类似于IIS。

再回答第2个问题，可以参考如下步骤安装Tomcat。

打开[Tomcat官网][Tomcat]，找到你要下载的Tomcat版本，我这里选择的是Tomcat 8.5.45 Released版本：

![format_png 13][]

然后选择合适的版本下载，因为我的开发机器是Windows 64位操作系统，所以我选择的是如下所示的版本：

![format_png 14][]

下载完成后，将其解压到你喜欢的目录，我解压到的目录是E:\\Tools\\apache-tomcat-8.5.45-windows-x64\\apache-tomcat-8.5.45，解压完成后长如下这样：

![format_png 15][]

其中webapps就是网站要部署的目录。

安装完成后，考虑的问题就是如何启动Tomcat？

第1种方法是双击bin目录下的tomcat8.exe：

![format_png 16][]

![format_png 17][]

然后在浏览器输入地址http://localhost:8080/，看到如下界面，代表Tomcat安装部署成功。

![format_png 18][]

使用这种方法的缺点就是，如果把tomcat8.exe打开的窗口关闭了，Tomcat也就关闭了，非常不方便，因此建议使用第2种方法，将Tomcat安装成一个后台服务，让其在后台运行，操作方法如下所示：

依次打开计算机–属性–高级系统设置–高级–环境变量，新增系统变量：

> 变量名：CATALINA\_HOME
> 
> 变量值：E:\\Tools\\apache-tomcat-8.5.45-windows-x64\\apache-tomcat-8.5.45（你将Tomcat解压的目录）

![format_png 19][]

然后编辑系统变量Path，在其最后添加如下内容：

> ;%CATALINA\_HOME%\\lib;%CATALINA\_HOME%\\bin

![format_png 20][]

然后以管理员身份打开cmd窗口，切换到Tomcat的bin目录，执行命令：service.bat install。

![format_png 21][]

然后打开Windows的服务列表，会看到一个Tomcat8的服务：

![format_png 22][]

将服务修改成自动启动并启动该服务即可在后台一直运行Tomcat服务器。

![format_png 23][]

如果你好奇新建的系统变量为什么必须是CATALINA\_HOME，那么可以用记事本打开bin目录下的service.bat，看到如下内容你就明白了：

![format_png 24][]

从上图也可以看出，运行Tomcat需要依赖环境变量JAVA\_HOME（配置JAVA SDK路径），不过我之前已经配置过了，如下所示：

![format_png 25][]

### 4.3 将war包部署到Tomcat中 ###

将之前打包好的spring-action-1.0-SNAPSHOT.war复制到Tomcat的webapps目录：

![format_png 26][]

因为我们的Tomcat服务器设置成了后台运行，过一会该目录就会生成1个和war包名相同的spring-action-1.0-SNAPSHOT文件夹，目录结构如下所示：

![format_png 27][]

我们的代码和JSP视图文件都在WEB-INF目录下的classes文件夹下：

![format_png 28][]

在浏览器中输入地址http://localhost:8080/spring-action-1.0-SNAPSHOT/index，页面展示如下所示：

![format_png 29][]

## 5. 源码及参考 ##

源码地址：[https://github.com/zwwhnly/spring-action.git][https_github.com_zwwhnly_spring-action.git]，欢迎下载。

Craig Walls 《Spring实战（第4版）》

汪云飞《Java EE开发的颠覆者：Spring Boot实战》

[【IntelliJ IDEA】使用idea解决新建jsp文件而找不到jsp文件模版的新建选项][IntelliJ IDEA_idea_jsp_jsp]

[Tomcat安装及配置教程][Tomcat 1]

[Tomcat安装及后台运行的方法][Tomcat 2]

> 原创不易，如果觉得文章能学到东西的话，欢迎点个赞、评个论、关个注，这是我坚持写作的最大动力。
> 
> 如果有兴趣，欢迎添加我的微信：**zwwhnly**，等你来聊技术、职场、工作等话题（PS：我是一名奋斗在上海的程序员）。

[format_png]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkxOV8xNDI5MjcucG5n?x-oss-process=image/format,png
[https_github.com_zwwhnly_spring-action.git]: https://github.com/zwwhnly/spring-action.git
[format_png 1]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkxOV8xNjU5MzEucG5n?x-oss-process=image/format,png
[format_png 2]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDgyOF8xODA3NTMucG5n?x-oss-process=image/format,png
[format_png 3]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkxOV8xNzA3MzYucG5n?x-oss-process=image/format,png
[format_png 4]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkxOV8xNzA4MTUucG5n?x-oss-process=image/format,png
[format_png 5]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkxOV8xNzA5NTAucG5n?x-oss-process=image/format,png
[format_png 6]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkxOV8xNzEyNTIucG5n?x-oss-process=image/format,png
[format_png 7]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkxOV8xNzEzNTcucG5n?x-oss-process=image/format,png
[format_png 8]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkxOV8xNzIxNDMucG5n?x-oss-process=image/format,png
[format_png 9]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkyMF8wOTI0MjYucG5n?x-oss-process=image/format,png
[format_png 10]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkyMF8wOTI4MTcucG5n?x-oss-process=image/format,png
[format_png 11]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkyMF8wOTI4MzUucG5n?x-oss-process=image/format,png
[format_png 12]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkyMF8wOTI5NDAucG5n?x-oss-process=image/format,png
[Tomcat]: http://tomcat.apache.org/
[format_png 13]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkyMF8wOTQyMTMucG5n?x-oss-process=image/format,png
[format_png 14]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkyMF8wOTQyNTUucG5n?x-oss-process=image/format,png
[format_png 15]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkyMF8wOTQ5NTcucG5n?x-oss-process=image/format,png
[format_png 16]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkyMF8wOTU1MTIucG5n?x-oss-process=image/format,png
[format_png 17]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkyMF8xMDAwMDcucG5n?x-oss-process=image/format,png
[format_png 18]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkyMF8xMDAyMzQucG5n?x-oss-process=image/format,png
[format_png 19]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkxMF8xNTU1MzkucG5n?x-oss-process=image/format,png
[format_png 20]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkxMF8xNjAwMTIucG5n?x-oss-process=image/format,png
[format_png 21]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkxMF8xNjA0MzAucG5n?x-oss-process=image/format,png
[format_png 22]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkxMF8xNjA0NTMucG5n?x-oss-process=image/format,png
[format_png 23]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkxMF8xNjA1NDMucG5n?x-oss-process=image/format,png
[format_png 24]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkyMF8xMDIzMjgucG5n?x-oss-process=image/format,png
[format_png 25]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkyMF8xMDI2MzEucG5n?x-oss-process=image/format,png
[format_png 26]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkyMF8xMDI4NTYucG5n?x-oss-process=image/format,png
[format_png 27]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkyMF8xMDMwNTEucG5n?x-oss-process=image/format,png
[format_png 28]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkyMF8xMDQxNDUucG5n?x-oss-process=image/format,png
[format_png 29]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMuend3aG5seS5jb20vcGljdHVyZS9zbmlwYXN0ZV8yMDE5MDkyMF8xMDQ0MzQucG5n?x-oss-process=image/format,png
[IntelliJ IDEA_idea_jsp_jsp]: https://www.cnblogs.com/sxdcgaq8080/p/7676294.html
[Tomcat 1]: https://www.cnblogs.com/dgj15222301178/p/7834815.html
[Tomcat 2]: https://jingyan.baidu.com/article/77b8dc7f3e4fba2174eab6d9.html