最全面的SpringMVC教程（一）——SpringMVC简介

前言

本文为SpringMVC相关教程，下边将对SpringMVC进行简单介绍，具体包含：对MVC架构的回顾，什么是SpringMVC，SpringMVC编程示例（包含配置版示例、注解版示例），初识SpringMVC（包含：组件说明、执行流程、三个上下文）等进行详尽介绍~

博主主页：小新要变强 的主页
Java全栈学习路线可参考：【Java全栈学习路线】最全的Java学习路线及知识清单，Java自学方向指引，内含最全Java全栈学习技术清单~
算法刷题路线可参考：算法刷题路线总结与相关资料分享，内含最详尽的算法刷题路线指南及相关资料分享~
Java微服务开源项目可参考：企业级Java微服务开源项目（开源框架，用于学习、毕设、公司项目、私活等，减少开发工作，让您只关注业务！）

---

目录

一、回顾MVC架构

1️⃣什么是MVC

• MVC是模型(Model)、视图(View)、控制器(Controller)的简写，是一种软件设计规范。
• MVC架构将业务逻辑、数据、显示分离的方法来组织代码。
• MVC主要作用是降低了视图与业务逻辑间的双向偶合。
• MVC不是一种设计模式，MVC是一种架构模式。当然不同的MVC存在差异。

Model（模型）： 数据模型，提供要展示的数据，因此包含数据和行为，可以认为是领域模型或JavaBean组件（包含数据和行为），不过现在一般都分离开来：Value Object（数据Dao） 和 服务层（行为Service）。也就是模型提供了模型数据查询和模型数据的状态更新等功能，包括数据和业务。
View（视图）： 负责进行模型的展示，一般就是我们见到的用户界面，客户想看到的东西。
Controller（控制器）： 接收用户请求，委托给模型进行处理（状态改变），处理完毕后把返回的模型数据返回给视图，由视图负责展示。 也就是说控制器做了个调度员的工作。

最典型的MVC就是JSP + servlet + javabean的模式：

2️⃣Model1时代

• 在web早期的开发中，通常采用的都是Model1。
• Model1中，主要分为两层，视图层和模型层。
  

Model1优点： 架构简单，比较适合小型项目开发；
Model1缺点： JSP职责不单一，职责过重，不便于维护；

3️⃣Model2时代

Model2把一个项目分成三部分，包括 视图、控制、模型 。

流程分析：（1）用户发请求；（2）Servlet接收请求数据，并调用对应的业务逻辑方法；（3）业务处理完毕，返回更新后的数据给servlet；（4）servlet转向到JSP，由JSP来渲染页面；（5）响应给前端更新后的页面。

职责分析：

• Controller： 控制器。取得表单数据；调用业务逻辑；转向指定的页面
• Model： 模型。业务逻辑；保存数据的状态。
• View： 视图。显示页面

Model2这样不仅提高的代码的复用率与项目的扩展性，且大大降低了项目的维护成本。Model 1模式的实现比较简单，适用于快速开发小规模项目，Model1中JSP页面身兼View和Controller两种角色，将控制逻辑和表现逻辑混杂在一起，从而导致代码的重用性非常低，增加了应用的扩展性和维护的难度。Model2消除了Model1的缺点。

二、什么是SpringMVC

Spring MVC 是Spring Framework的一部分，是基于Java实现MVC的轻量级Web框架。Spring MVC属于SpringFrameWork的后续产品，已经融合在Spring Web Flow里面。Spring 框架提供了构建 Web 应用程序的全功能 MVC 模块。使用 Spring 可插入的 MVC 架构，可以选择是使用内置的 Spring Web 框架还可以是 Struts 这样的 Web 框架。

Spring MVC官方文档： https://docs.spring.io/spring-framework/docs/5.2.0.RELEASE/spring-framework-reference/

Spring MVC的架构：

Spring MVC将传统的模型层被拆分为了业务层（Service）和数据访问层（DAO,Data Access Object）。同时，在 Service层下可以通过 Spring 的声明式事务操作数据访问层。

Spring MVC的特点：

• 轻量级，简单易学
• 高效 , 基于请求响应的MVC框架
• 松耦合，各个模块分离
• 与Spring兼容性好，无缝结合
• 约定优于配置
• 功能强大：RESTful、数据验证、格式化、本地化、主题等
• 简洁灵活

三、Hello SpringMVC

1️⃣配置版

（1）新建一个Moudle： springmvc–hello ， 添加web的支持

（2）导入了SpringMVC 的依赖

（3）配置web.xml ， 注册DispatcherServlet

<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>springmvcservlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServletservlet-class>
        
        <init-param>
            <param-name>contextConfigLocationparam-name>
            <param-value>classpath:springmvc-servlet.xmlparam-value>
        init-param>
        
        <load-on-startup>1load-on-startup>
    servlet>
    
    
    <servlet-mapping>
        <servlet-name>springmvcservlet-name>
        <url-pattern>/url-pattern>
    servlet-mapping>
web-app>

（4）编写SpringMVC 的 配置文件！名称：springmvc-servlet.xml : [servletname]-servlet.xml

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd">
beans>

添加处理映射器：

<bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"/>

添加处理器适配器：

<bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter"/>

添加视图解析器：

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" id="InternalResourceViewResolver">
    
    <property name="prefix" value="/WEB-INF/jsp/"/>
    
    <property name="suffix" value=".jsp"/>
bean>

（5）编写我们要操作业务Controller

要么实现Controller接口，要么增加注解；需要返回一个ModelAndView，装数据，封视图。

package com.wang.controller;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
//注意：这里我们先导入Controller接口
public class HelloController implements Controller {
    public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
        //ModelAndView 模型和视图
        ModelAndView mv = new ModelAndView();
        //封装对象，放在ModelAndView中。Model
        mv.addObject("msg","HelloSpringMVC!");
        //封装要跳转的视图，放在ModelAndView中
        mv.setViewName("hello"); //: /WEB-INF/jsp/hello.jsp
        return mv;
    }
}

（6）将自己的类交给SpringIOC容器，注册bean

<bean id="/hello" class="com.wang.controller.HelloController"/>

（7）写要跳转的jsp页面，显示ModelandView存放的数据，以及我们的正常页面。

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>springMVCtitle>
head>
<body>
    ${msg}
body>
html>

（8）配置Tomcat 启动测试

2️⃣注解版

（1）新建一个Moudle：springmvc-hello2，并添加web支持！

（2）建立包结构 com.wang.controller

（3）由于Maven可能存在资源过滤的问题，需要进行相关配置

<build>
    <resources>
        <resource>
            <directory>src/main/javadirectory>
            <includes>
                <include>**/*.propertiesinclude>
                <include>**/*.xmlinclude>
            includes>
            <filtering>falsefiltering>
        resource>
        <resource>
            <directory>src/main/resourcesdirectory>
            <includes>
                <include>**/*.propertiesinclude>
                <include>**/*.xmlinclude>
            includes>
            <filtering>falsefiltering>
        resource>
    resources>
build>

（4）在pom.xml文件引入相关的依赖

主要有Spring框架核心库、Spring MVC、servlet , JSTL等。

（5）配置web.xml

<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>SpringMVCservlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServletservlet-class>
        
        <init-param>
            <param-name>contextConfigLocationparam-name>
            <param-value>classpath:springmvc-servlet.xmlparam-value>
        init-param>
        
        <load-on-startup>1load-on-startup>
    servlet>
    
    <servlet-mapping>
        <servlet-name>SpringMVCservlet-name>
        <url-pattern>/url-pattern>
    servlet-mapping>
web-app>

注意点：

• 注意web.xml版本问题，要最新版！
• 注册DispatcherServlet
• 关联SpringMVC的配置文件
• 启动级别为1
• 映射路径为 / 【不要用/*，会404】

/ 和/ *的区别：

• < url-pattern > / 不会匹配到.jsp， 只针对我们编写的请求；即：.jsp 不会进入spring的 DispatcherServlet类 。
• < url-pattern > / 会匹配 .jsp，会出现返回 jsp视图时再次进入spring的DispatcherServlet 类，导致找不到对应的controller所以报404错。

（6）添加Spring MVC配置文件

• 让IOC的注解生效
• 静态资源过滤 ：HTML . JS . CSS . 图片 ， 视频 ……
• MVC的注解驱动
• 配置视图解析器

在resource目录下添加springmvc-servlet.xml配置文件，配置的形式与Spring容器配置基本类似，为了支持基于注解的IOC，设置了自动扫描包的功能，具体配置信息如下：

<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"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       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
        http://www.springframework.org/schema/mvc
        https://www.springframework.org/schema/mvc/spring-mvc.xsd">
    
    <context:component-scan base-package="com.wang.controller"/>
    
    <mvc:default-servlet-handler />
    
    <mvc:annotation-driven />
    
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"
          id="internalResourceViewResolver">
        
        <property name="prefix" value="/WEB-INF/jsp/" />
        
        <property name="suffix" value=".jsp" />
    bean>
beans>

在视图解析器中我们把所有的视图都存放在/WEB-INF/目录下，这样可以保证视图安全，因为这个目录下的文件，客户端不能直接访问。

（7）创建Controller

编写一个Java控制类： com.wang.controller.HelloController.

package com.wang.controller;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
@RequestMapping("/HelloController")
public class HelloController {
    //真实访问地址 : 项目名/HelloController/hello
    @RequestMapping("/hello")
    public String sayHello(Model model){
        //向模型中添加属性msg与值，可以在JSP页面中取出并渲染
        model.addAttribute("msg","hello,SpringMVC");
        //web-inf/jsp/hello.jsp
        return "hello";
    }
}

• @Controller是为了让Spring IOC容器初始化时自动扫描到；
• @RequestMapping是为了映射请求路径，这里因为类与方法上都有映射所以访问时应该是/HelloController/hello；
• 方法中声明Model类型的参数是为了把Action中的数据带到视图中；
• 方法返回的结果是视图的名称hello，加上配置文件中的前后缀变成WEB-INF/jsp/hello.jsp。

（8）创建视图层

在WEB-INF/ jsp目录中创建hello.jsp ， 视图可以直接取出并展示从Controller带回的信息；
可以通过EL表示取出Model中存放的值，或者对象。

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>SpringMVCtitle>
head>
<body>
    ${msg}
body>
html>

（9）配置Tomcat运行

配置Tomcat ， 开启服务器 ， 访问 对应的请求路径。

四、初识SpringMVC

1️⃣组件说明

（1）DispatcherServlet：中央控制器，前端控制器

用户请求到达前端控制器（dispatcherServlet），他是整个流程控制的中心，由它负责调用其它组件处理用户的请求，dispatcherServlet的存在降低了组件之间的耦合性。

这玩意可以理解成一个【咨询处】，你去某个地方办事，先去咨询处问问我们应该先干什么，等第一件事做完了，可以接着去咨询处咨询，你的下一步工作应该是什么。

（2）handler： 处理器

Handler也叫后端控制器，在DispatcherServlet的控制下Handler对【具体的用户请求】进行处理，由于Handler涉及到【具体的用户业务请求】，所以一般情况需要程序员【根据业务需求开发Handler】。这玩意就是你写的controller，别把他想成啥高级玩意，你也能写个处理器。

（3）View： 视图

一般情况下，需要通过【页面标签或页面模版技术】将模型数据通过页面展示给用户，需要由程序员根据业务需求开发具体的页面。目前我们接触过得视图技术就是jsp，当然还有Freemarker，Thymeleaf等。

（4）HandlerMapping： 处理器映射器

HandlerMapping负责根据【用户请求url】找到【Handler】即处理器，springmvc提供了不同的【处理器映射器】实现，如配置文件方式，实现接口方式，注解方式等。

（5）HandlAdapter： 处理器适配器

HandlerAdapter负责调用具体的处理器，这是适配器模式的应用，通过扩展适配器可以对更多类型的处理器进行执行。我们写的controller中的方法，将来就是会由处理器适配器调用。

（6）ViewResolver： 视图解析器

View Resolver负责将处理结果生成View视图，View Resolver首先根据【逻辑视图名】解析成【物理视图名】即具体的页面地址，再生成View视图对象，最后对View进行渲染将处理结果通过页面展示给用户。

2️⃣执行流程

Springmvc的是围绕DispatcherServlet进行设计的

• DispatcherServlet的作用是将请求分发到不同的处理器。从Spring 2.5开始，使用Java5或者以上版本的用户可以采用基于注解的controller声明方式。
• Spring MVC框架像许多其他MVC框架一样, 以【请求为驱动】 ,围绕一个【核心Servlet】进行请求分派及提供其他功能，DispatcherServlet仅仅是一个的Servlet（它继承自HttpServlet）。

分发的流程大致如下

处理过程简单总结如下

• （1）通过url匹配一个过滤器链，其中包含多个过滤器和一个处理器
• （2）第一步调用拦截器的preHandle方法
• （3）第二步执行handler方法
• （4）第三部调用拦截器的postHandle方法
• （5）将结果给视图解析器进行处理
• （6）处理完成后调用afterCompletion

3️⃣三个上下文

在我们的web项目中存在至少三个上下文，分别是【servlet上下文】，【spring上下文】以及【springmvc上下文】，具体如下：

（1）ServletContext

对于一个web应用，其部署在web容器中，web容器提供其一个全局的上下文环境，这个上下文就是我们的ServletContext，其为后面的spring IoC容器提供一个宿主环境。

（2）spring上下文

• 在web.xml的配置中，我们需要提供一个监听器【ContextLoaderListener】。在web容器启动时，会触发【容器初始化】事件，此时contextLoaderListener会监听到这个事件，其contextInitialized方法会被调用。
• 在这个方法中，spring会初始化一个【上下文】，这个上下文被称为【根上下文】，即【WebApplicationContext】，这是一个接口类，其实际的实现类是XmlWebApplicationContext。这个就是spring的IoC容器，其对应的Bean定义的配置由web.xml中的【context-param】配置指定，默认配置文件为【/WEB-INF/applicationContext.xml】。
• 在这个IoC容器初始化完毕后，spring以【WebApplicationContext.ROOTWEBAPPLICATIONCONTEXTATTRIBUTE】为属性Key，将其存储到ServletContext中，便于将来获取。

相关配置：

<listener>
    <listener-class>org.springframework.web.context.ContextLoaderListenerlistener-class>
listener>
<context-param>
    <param-name>contextConfigLocationparam-name>
    <param-value>/WEB-INF/app-context.xmlparam-value>
context-param>

（3）springmvc上下文

• contextLoaderListener监听器初始化完毕后，开始初始化web.xml中配置的Servlet，这个servlet可以配置多个，通常只配置一个，以最常见的DispatcherServlet为例，这个servlet实际上是一个【标准的前端控制器】，用以转发、匹配、处理每个servlet请求。
• DispatcherServlet在初始化的时候会建立自己的IoC上下文，用以持有【springmvc相关的bean】。在建立DispatcherServlet自己的IoC上下文时，会利用【WebApplicationContext.ROOTWEBAPPLICATIONCONTEXTATTRIBUTE】先从ServletContext中获取之前的【根上下文】作为自己上下文的【parent上下文】。有了这个parent上下文之后，再初始化自己持有的上下文，这个上下文本质上也是XmlWebApplicationContext，默认读取的配置文件是【/WEB-INF/springmvc-servlet.xml】，当然我们也可以使用init-param标签的【contextConfigLocation属性】进行配置。
• DispatcherServlet初始化自己上下文的工作在其【initStrategies】方法中可以看到，大概的工作就是初始化处理器映射、视图解析等。这个servlet自己持有的上下文默认实现类也是xmlWebApplicationContext。初始化完毕后，spring以【“org.springframework.web.servlet.FrameworkServlet.CONTEXT”+Servlet名称】为Key，也将其存到ServletContext中，以便后续使用。这样每个servlet就持有自己的上下文，即拥有自己独立的bean空间，同时各个servlet还可以共享相同的bean，即根上下文(第2步中初始化的上下文)定义的那些bean。

注意： springMVC容器只负责创建Controller对象，不会创建service和dao，并且他是一个子容器。而spring的容器只负责Service和dao对象，是一个父容器。子容器可以看见父容器的对象，而父容器看不见子容器的对象，这样各司其职。

我们可以通过debug，使用ServletContext servletContext = req.getServletContext()查方法看ServletContext，如下：

---

后记

Java全栈学习路线可参考：【Java全栈学习路线】最全的Java学习路线及知识清单，Java自学方向指引，内含最全Java全栈学习技术清单~
算法刷题路线可参考：算法刷题路线总结与相关资料分享，内含最详尽的算法刷题路线指南及相关资料分享~