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

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中所经历的每个流程：

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

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

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

3. 搭建Spring MVC项目

我们仍然延用之前博客中新建的spring-action项目，有兴趣的同学可以看下本系列的前11篇博客或者直接下载源码：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>

<!-- 其他Web依赖 -->

<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文件模板，就像下面这样：

解决方案如下所示：

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

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

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

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/。

如果编译完成该目录下没有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：

然后再点击package：

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

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

4.2 Tomcat安装及部署

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

什么是Tomcat？
Tomcat如何安装？

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

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

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

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

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

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

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

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

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

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

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

变量名：CATALINA_HOME

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

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

;%CATALINA_HOME%\lib;%CATALINA_HOME%\bin

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

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

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

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

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

4.3 将war包部署到Tomcat中

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

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

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

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

5. 源码及参考

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

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

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

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

Tomcat安装及配置教程

Tomcat安装及后台运行的方法

原创不易，如果觉得文章能学到东西的话，欢迎点个赞、评个论、关个注，这是我坚持写作的最大动力。

如果有兴趣，欢迎添加我的微信：zwwhnly，等你来聊技术、职场、工作等话题（PS：我是一名奋斗在上海的程序员）。