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

2019-09-23 09:05:25来源：博客园阅读 ()

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映射，现在问题来了，我们如何查看代码的运行效果呢？

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