SpringMVC入门及HelloWorld工程实例

矫情吗；* 2022-07-16 18:53 215阅读 0赞

MVC是什么

模型—视图—控制器（MVC）是一个众所周知的以设计界面应用程序为基础的设计模式。它主要通过**分离模型、视图及控制器在应用程序中的角色将业务逻辑从界面中解耦**。通常，模型负责封装应用程序数据在视图层展示。视图仅仅只是展示这些数据，不包含任何业务逻辑。控制器负责接收来自用户的请求，并调用后台服务（manager或者dao）来处理业务逻辑。处理后，后台业务层可能会返回了一些数据在视图层展示。控制器收集这些数据及准备模型在视图层展示。MVC模式的核心思想是将业务逻辑从界面中分离出来，允许它们单独改变而不会相互影响。

![20170304202954829][]

# Spring Web MVC是什么 #

Spring Web MVC是一种基于Java的实现了Web MVC设计模式的**请求驱动类型的轻量级Web框架**，即使用了MVC架构模式的思想，将web层进行职责解耦，基于请求驱动指的就是**使用请求—响应模型**，框架的目的就是帮助我们简化开发，Spring Web MVC也是要简化我们日常Web开发的。

另外还有一种基于组件的、事件驱动的Web框架在此就不介绍了，如Tapestry、JSF等。

Spring Web MVC也是服务到工作者模式的实现，但可进行优化。前端控制器是DispatcherServlet；应用控制器其实拆为处理器映射器（Handler Mapping）和视图解析器（View Resolver），前者进行处理器管理，后者进行视图管理；页面控制器（动作/处理器）为Controller接口（仅包含Model And View handleRequest(request,response)方法）的实现（也可以是任何的POJO类）；支持本地化（Locale）解析、主题（Theme）解析及文件上传等；提供了非常灵活的数据验证、格式化和数据绑定机制；提供了强大的约定大于配置（惯例优先原则）的契约式编程支持。

在Spring MVC应用程序中，**模型通常由POJO对象组成，它在业务层中被处理，在持久层中被持久化。视图通常是用JSP标准标签库（JSTL）编写的JSP模板。控制器部分是由DispatcherServlet负责。**

# Spring Web MVC能做什么 #

√让我们能非常简单的设计出干净的Web层和薄薄的Web层；

√进行更简洁的Web层的开发；

√天生与Spring框架集成（如IoC容器、AOP等）；

√提供强大的**约定大于配置的契约式编程**支持；

√能简单的**进行Web层的单元测试**；

√支持灵活的URL到页面控制器的映射；

√非常容易与其他视图技术集成，如Velocity、FreeMarker等等，因为模型数据不放在特定的API里，而是放在一个Model里（Map数据结构实现，因此很容易被其他框架使用）；

√非常灵活的数据验证、格式化和数据绑定机制，能使用任何对象进行数据绑定，不必实现特定框架的API；

√提供一套强大的JSP标签库，简化JSP开发；

√支持灵活的本地化、主题等解析；

√更加简单的异常处理；

√对静态资源的支持；

√支持Restful风格。

# Spring Web MVC架构 #

Spring Web MVC框架也是一个基于请求驱动的Web框架，并且也使用了前端控制器模式来进行设计，再根据请求映射规则分发给相应的页面控制器（动作/处理器）进行处理。首先让我们整体看一下Spring Web MVC处理请求的流程：

![20170304203159405][]

具体执行步骤如下：

1、首先用户发送请求—>前端控制器，前端控制器根据请求信息（如URL）来决定选择哪一个页面控制器进行处理并把请求委托给它，即以前的控制器的控制逻辑部分；上图中的1、2步骤；

2、页面控制器接收到请求后，进行功能处理，首先需要收集和绑定请求参数到一个对象，这个对象在Spring Web MVC中叫命令对象，并进行验证，然后将命令对象委托给业务对象进行处理；处理完毕后返回一个ModelAndView（模型数据和逻辑视图名）；上图中的3、4、5步骤；

3、前端控制器收回控制权，然后根据返回的逻辑视图名，选择相应的视图进行渲染，并把模型数据传入以便视图渲染；上图中的步骤6、7；

4、前端控制器再次收回控制权，将响应返回给用户，上图中的步骤8；至此整个结束。

针对以上过程，整理问题如下：

1、请求如何给前端控制器？

2、前端控制器如何根据请求信息选择页面控制器进行功能处理？

3、如何支持多种页面控制器呢？

4、页面控制器如何使用业务对象？

5、页面控制器如何返回模型数据？

6、前端控制器如何根据页面控制器返回的逻辑视图名选择具体的视图进行渲染？

7、不同的视图技术如何使用相应的模型数据？

首先我们知道有如上问题，那这些问题如何解决呢？请让我们先继续，在后边依次回答。

Spring Web MVC中DispatcherServlet的工作流程如图

![20170304203320999][]

DispatcherServlet核心代码如下：

//前端控制器分派方法  
    protected void doDispatch(HttpServletRequest request, HttpServletResponse response) throws Exception {  
            HttpServletRequest processedRequest = request;  
            HandlerExecutionChain mappedHandler = null;  
            int interceptorIndex = -1;  
            try {  
                ModelAndView mv;  
                boolean errorView = false;  
      
                try {  
                       //检查是请求是否是multipart（如文件上传），如果是将通过MultipartResolver解析  
                    processedRequest = checkMultipart(request);  
                       //步骤2、请求到处理器（页面控制器）的映射，通过HandlerMapping进行映射  
                    mappedHandler = getHandler(processedRequest, false);  
                    if (mappedHandler == null || mappedHandler.getHandler() == null) {  
                        noHandlerFound(processedRequest, response);  
                        return;  
                    }  
                       //步骤3、处理器适配，即将我们的处理器包装成相应的适配器（从而支持多种类型的处理器）  
                    HandlerAdapter ha = getHandlerAdapter(mappedHandler.getHandler());  
      
                      // 304 Not Modified缓存支持  
                    //此处省略具体代码  
      
                    // 执行处理器相关的拦截器的预处理（HandlerInterceptor.preHandle）  
                    //此处省略具体代码  
      
                    // 步骤4、由适配器执行处理器（调用处理器相应功能处理方法）  
                    mv = ha.handle(processedRequest, response, mappedHandler.getHandler());  
      
                    // Do we need view name translation?  
                    if (mv != null && !mv.hasView()) {  
                        mv.setViewName(getDefaultViewName(request));  
                    }  
                    // 执行处理器相关的拦截器的后处理（HandlerInterceptor.postHandle）  
                    //此处省略具体代码  
                }  
                catch (ModelAndViewDefiningException ex) {  
                    logger.debug("ModelAndViewDefiningException encountered", ex);  
                    mv = ex.getModelAndView();  
                }  
                catch (Exception ex) {  
                    Object handler = (mappedHandler != null ? mappedHandler.getHandler() : null);  
                    mv = processHandlerException(processedRequest, response, handler, ex);  
                    errorView = (mv != null);  
                }  
      
                //步骤5 步骤6、解析视图并进行视图的渲染  
    			//步骤5 由ViewResolver解析View（viewResolver.resolveViewName(viewName, locale)）  
    			//步骤6 视图在渲染时会把Model传入（view.render(mv.getModelInternal(), request, response);）  
                if (mv != null && !mv.wasCleared()) {  
                    render(mv, processedRequest, response);  
                    if (errorView) {  
                        WebUtils.clearErrorRequestAttributes(request);  
                    }  
                }  
                else {  
                    if (logger.isDebugEnabled()) {  
                        logger.debug("Null ModelAndView returned to DispatcherServlet with name '" + getServletName() +  
                                "': assuming HandlerAdapter completed request handling");  
                    }  
                }  
      
                // 执行处理器相关的拦截器的完成后处理（HandlerInterceptor.afterCompletion）  
                //此处省略具体代码  
            catch (Exception ex) {  
                // Trigger after-completion for thrown exception.  
                triggerAfterCompletion(mappedHandler, interceptorIndex, processedRequest, response, ex);  
                throw ex;  
            }  
            catch (Error err) {  
                ServletException ex = new NestedServletException("Handler processing failed", err);  
                // Trigger after-completion for thrown exception.  
                triggerAfterCompletion(mappedHandler, interceptorIndex, processedRequest, response, ex);  
                throw ex;  
            }  
      
            finally {  
                // Clean up any resources used by a multipart request.  
                if (processedRequest != request) {  
                    cleanupMultipart(processedRequest);  
                }  
            }  
        }

具体流程步骤如下：

1、首先用户发送请求—>DispatcherServlet，前端控制器收到请求后自己不进行处理，而是委托给其他的解析器进行处理，作为统一访问点，进行全局的流程控制；

2、DispatcherServlet—>HandlerMapping，HandlerMapping将会把请求映射为HandlerExecutionChain对象（包含一个Handler处理器（页面控制器）对象、多个HandlerInterceptor拦截器），通过这种策略模式，很容易添加新的映射策略；

3、HandlerExecutionChain—>HandlerAdapter，HandlerAdapter将会把处理器包装为适配器，从而支持多种类型的处理器，即**适配器设计模式的应用，从而很容易支持很多类型的处理器**；

4、HandlerAdapter—>处理器功能处理方法的调用，HandlerAdapter将会根据适配的结果调用真正的处理器的功能处理方法，完成功能处理；并返回一个ModelAndView对象（包含模型数据、逻辑视图名）；

5、ModelAndView的逻辑视图名——>ViewResolver，ViewResolver将把逻辑视图名解析为具体的View，通过这种策略模式，很容易更换其他视图技术；

6、View——>渲染，View会根据传进来的Model模型数据进行渲染，此处的Model实际是一个Map数据结构，因此很容易支持其他视图技术；

7、返回控制权给DispatcherServlet，由DispatcherServlet返回响应给用户，到此一个流程结束。

此处我们只是讲了核心流程，没有考虑拦截器、本地解析、文件上传解析等，后边再细述。到此，再来看我们前边提出的问题：

1、请求如何给前端控制器？这个应该在web.xml中进行部署描述，在HelloWorld工程实例中详细讲解。

2、前端控制器如何根据请求信息选择页面控制器进行功能处理？我们需要配置HandlerMapping进行映射。

3、如何支持多种页面控制器呢？配置HandlerAdapter从而支持多种类型的页面控制器。

4、页面控制器如何使用业务对象？可以预料到，肯定利用Spring IoC容器的依赖注入功能。

5、页面控制器如何返回模型数据？使用ModelAndView返回。

6、前端控制器如何根据页面控制器返回的逻辑视图名选择具体的视图进行渲染？使用ViewResolver进行解析。

7、不同的视图技术如何使用相应的模型数据？因为Model是一个Map数据结构，很容易支持其他视图技术。

## Spring Web MVC优势 ##

1、清晰的角色划分：前端控制器（DispatcherServlet）、请求到处理器映射（HandlerMapping）、处理器适配器（HandlerAdapter）、视图解析器（ViewResolver）、处理器或页面控制器（Controller）、验证器（Validator）、命令对象（Command请求参数绑定到的对象就叫命令对象）、表单对象（Form Object提供给表单展示和提交到的对象就叫表单对象）。

2、分工明确，而且扩展点相当灵活，可以很容易扩展，虽然几乎不需要；

3、由于命令对象就是一个POJO，无需继承框架特定API，可以使用命令对象直接作为业务对象；

4、和Spring其他框架无缝集成，是其它Web框架所不具备的；

5、可适配，通过HandlerAdapter可以支持任意的类作为处理器；

6、可定制性，HandlerMapping、ViewResolver等能够非常简单的定制；

7、功能强大的数据验证、格式化、绑定机制；

8、利用Spring提供的Mock对象能够非常简单的进行Web层单元测试；

9、本地化、主题的解析的支持，使我们更容易进行国际化和主题的切换。

10、强大的JSP标签库，使JSP编写更容易。

……还有比如RESTful风格的支持、简单的文件上传、约定大于配置的契约式编程支持、基于注解的零配置支持等等。

到此我们已经简单的了解了Spring Web MVC，接下来让我们来个实例来具体使用下这个框架。

Hello World工程

☆开发工具：Eclipse Java EE

☆运行环境：tomcat8.5

☆工程：动态web工程（工程名为SpringMVC\_Test）

☆Spring框架下载：

spring-framework-4.3.5.RELEASE-dist.zip

☆依赖jar包：

1、Spring框架jar包：

为了简单，将spring-framework-4.3.5.RELEASE-dist.zip/libs/下的所有jar包拷贝到项目的WEB-INF/lib目录下；

2、Spring框架依赖的logging和JSTL包：

需要添加Apache commons logging日志，此处使用的是Version1.2版本的commons-logging-1.2.jar；

需要添加jstl标签库支持，此处使用的是taglibs-standard-impl-1.2.5.jar和taglibs-standard-spec-1.2.5.jar；

### 1、前端控制器的配置 ###

在我们的web.xml中添加如下配置：

<servlet>  
         <servlet-name>test</servlet-name>  
         	<servlet-class>
     	org.springframework.web.servlet.DispatcherServlet
       </servlet-class>  
          <load-on-startup>1</load-on-startup>  
      </servlet>  
      <servlet-mapping>  
         <servlet-name>test</servlet-name>  
         <url-pattern>/</url-pattern>  
      </servlet-mapping>

load-on-startup：**表示启动容器时初始化该Servlet**；

url-pattern：表示**哪些请求交给Spring Web MVC处理**， “/” 是用来定义默认servlet映射的。也可以如“\*.html”表示拦截所有以html为扩展名的请求。

自此请求已交给Spring Web MVC框架处理，因此我们需要编写Spring的配置文件，默认DispatcherServlet会加载WEB-INF目录下名称为“DispatcherServlet的Servlet名字\]-servlet.xml”的配置文件。本示例中DispatcherServlet中的<servlet-name>标签中把DispatcherServlet的名字配置为“test”，所以Spring的配置文件为WEB-INF/ test-servlet.xml。

### 2、在Spring配置文件中配置HandlerMapping、HandlerAdapter ###

具体配置在WEB-INF/ test-servlet.xml文件中：

<?xml version="1.0" encoding="UTF-8"?>
    <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-4.3.xsd
          http://www.springframework.org/schema/context               		
          http://www.springframework.org/schema/context/spring-context-4.3.xsd
          http://www.springframework.org/schema/mvc                		
          http://www.springframework.org/schema/mvc/spring-mvc-4.3.xsd">	
    
    	  
    	<bean 		class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping	"/>
    	
     
    	<bean 		class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter"/	>	
    </beans>

BeanNameUrlHandlerMapping表示**将请求的URL和Bean名字映射**，如URL为“上下文/hello”，则Spring配置文件必须有一个名字为“/hello”的Bean，上下文默认忽略。

SimpleControllerHandlerAdapter表示所有实现了Controller接口的Bean都可以作为Spring Web MVC中的处理器（指的是org.springframework.web.servlet.mvc包下的Controller接口），如果需要其他类型的处理器可以通过实现HandlerAdapter来解决。

### 3、在Spring配置文件中配置ViewResolver ###

具体配置在WEB-INF/ test-servlet.xml文件中：

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

InternalResourceViewResolver用于**支持Servlet、JSP视图解析**；

viewClass：JstlView表示JSP模板页面需要使用JSTL标签库，因此本工程的classpath中必须包含jstl的相关jar包，否则会报错；

prefix和suffix：查找视图页面的前缀和后缀（前缀\[逻辑视图名\]后缀），此处前缀指定为“WEB-INF/jsp/”，后缀指定为“.jsp”。表示如果传进来的逻辑视图名为hello，则该jsp视图页面文件是“WEB-INF/jsp/hello.jsp”；

### 4、开发处理器/页面控制器 ###

在工程的Java Resources/src目录下新建文件HelloWorldController.java

package cn.javass.test.web.controller;  
    import javax.servlet.http.HttpServletRequest;  
    import javax.servlet.http.HttpServletResponse;  
    import org.springframework.web.servlet.ModelAndView;  
    import org.springframework.web.servlet.mvc.Controller;  
    public class HelloWorldController implements Controller {  
        @Override  
    public ModelAndView handleRequest(HttpServletRequest req, 
    HttpServletResponse resp) throws Exception {  
           //1、收集参数、验证参数  
           //2、绑定参数到命令对象  
           //3、将命令对象传入业务对象进行业务处理  
           //4、选择下一个页面  
           ModelAndView mv = new ModelAndView();  
           //添加模型数据 可以是任意的POJO对象  
           mv.addObject("message", "Hello World!");  
           //设置逻辑视图名，视图解析器会根据该名字解析到具体的视图页面  
           mv.setViewName("hello");  
           return mv;  
        }  
    }

org.springframework.web.servlet.mvc.Controller：**页面控制器/处理器必须实现Controller接口**，注意别选错了，还有其他的处理器实现方式；

public ModelAndView handleRequest(HttpServletRequest req,HttpServletResponse resp)：**功能处理方法，实现相应的功能处理**，比如收集参数、验证参数、绑定参数到命令对象、将命令对象传入业务对象进行业务处理、最后返回ModelAndView对象；

ModelAndView：包含了视图要实现的模型数据和逻辑视图名；mv.addObject("message","Hello World!")**表示添加模型数据，此处可以是任意POJO对象**；mv.setViewName("hello")表示**设置逻辑视图名为“hello”**，视图解析器会将其解析为具体的视图，如前边的视图解析器InternalResourceVi。wResolver会将其解析为“WEB-INF/jsp/hello.jsp”。

我们需要将自己编写的处理器/页面控制器类添加到Spring配置文件(WEB-INF/test-servlet.xml)，让其接受Spring IoC容器的管理，具体配置在WEB-INF/ test-servlet.xml文件中：

<bean name="/hello" class="cn.javass.test.web.controller.HelloWorldController"/>

name="/hello"：前边配置的BeanNameUrlHandlerMapping，表示如过请求的URL为“上下文/hello”，则将会交给该Bean进行处理。

### 5、开发视图页面 ###

创建/WEB-INF/jsp/hello.jsp视图页面：

<%@ page language="java" contentType="text/html; charset=UTF-8"
        pageEncoding="UTF-8"%>
    <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
    <html>
    <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>Hello World</title>
    </head>
    <body>
    	<h1>
    		 ${message }
    	</h1>
    </body>
    </html><

$\{message\}：表示显示由HelloWorldController处理器传过来的模型数据。

### 6、启动服务器运行测试 ###

通过请求：http://localhost:9080/SpringMVC\_Test/hello，如果页面输出“Hello World!”就表明我们成功了。

### 7、运行流程分析 ###

如下图所示

![20170304204351927][]

运行步骤：

1、首先用户发送请求http://localhost:9080/SpringMVC\_Test/hello—>web容器，web容器根据“/hello”路径映射到DispatcherServlet（url-pattern为/）进行处理；

2、DispatcherServlet—>BeanNameUrlHandlerMapping进行请求到处理的映射，BeanNameUrlHandlerMapping将“/hello”路径直接映射到名字为“/hello”的Bean进行处理，即HelloWorldController，BeanNameUrlHandlerMapping将其包装为HandlerExecutionChain（只包括HelloWorldController处理器，没有拦截器）；

3、DispatcherServlet—>SimpleControllerHandlerAdapter，HelloWorldController处理器被包装在HandlerExecutionChain中，这一步骤将HelloWorldController处理器适配为SimpleControllerHandlerAdapter；

4、SimpleControllerHandlerAdapter—>HelloWorldController，处理器功能处理方法的调用，SimpleControllerHandlerAdapter将会调用处理器的handleRequest方法进行功能处理，该处理方法返回一个ModelAndView给DispatcherServlet；

5、hello（ModelAndView的逻辑视图名）—>InternalResourceViewResolver，InternalResourceViewResolver使用JstlView指明的使用JSTL标签库，具体视图页面在/WEB-INF/jsp/hello.jsp；

6、JstlView（/WEB-INF/jsp/hello.jsp）—>渲染，将处理器传入的模型数据(message=HelloWorld！)在视图中展示出来；

7、返回控制权给DispatcherServlet，由DispatcherServlet返回响应给用户，到此一个流程结束。

到此HelloWorld就完成了，步骤是不是有点多？而且回忆下我们主要进行了如下配置：

1、前端控制器DispatcherServlet；

2、HandlerMapping

3、HandlerAdapter

4、ViewResolver

5、处理器/页面控制器

6、视图

### 8、POST中文乱码解决方案 ###

springMVC框架提供了org.springframework.web.filter.CharacterEncodingFilter类用于解决POST方式造成的中文乱码问题，具体配置添加到web.xml中：

<filter>
    	<filter-name>CharacterEncodingFilter</filter-name>
    	<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    	<init-param>
    	  <param-name>encoding</param-name>
    	  <param-value>utf-8</param-value>
    </init-param>
    </filter>
    	 <filter-mapping>
    	 <filter-name>CharacterEncodingFilter</filter-name>
    	 <url-pattern>/*</url-pattern>
    </filter-mapping>

以后我们项目中所有页面的编码均为UTF-8。

至此我们可以看出具体的核心开发步骤：

1、DispatcherServlet在web.xml中的部署描述，从而拦截请求到Spring Web MVC

2、HandlerMapping的配置，从而将请求映射到处理器

3、HandlerAdapter的配置，从而支持多种类型的处理器

4、ViewResolver的配置，从而将逻辑视图名解析为具体视图技术

5、处理器（页面控制器）的配置，从而进行功能处理

[20170304202954829]: /images/20220709/d6faca7ea00547269de9e4aaca661500.png
[20170304203159405]: /images/20220709/9338548e04554fbab1976e0aabb21d98.png
[20170304203320999]: /images/20220709/bc0570fa6c0b43869a8eeb29677fb68b.png
[20170304204351927]: /images/20220709/6f61d6a6c8234ac786ec2d38a9fa8a79.png