SpringMVC框架学习03-SpringMVC入门程序

【作者：任小龙，叩丁狼高级讲师。原创文章，转载请注明出处。】

在上一篇文章中，我们讲了MVC思想和前端控制器的思想。在本文中，我们将会完成SpringMVC的第一个程序，想必小伙伴们已经等得太久，再开始之前我们还是得先说说本文的要点。
本文需要探讨的有两个点：
一、认识一下Spring MVC框架；
二、完成SpringMVC第一个程序；
注意：学习SpringMVC之前，除了需要掌握JavaWeb知识，至少得有Spring IoC基础

什么是Spring MVC

先来看Spring核心框架的架构图：

Spring MVC框架，严格上说应该称之为 Spring Web MVC，它是Spring FrameWork的子模块，是一个提供了构建 Web 应用的全功能 MVC 模块。在早期的时候，MVC框架还是Struts1和Struts2的天下，SpringMVC并不是特别引人注目，不过很快就验证了是金子总会闪光的真理，当Spring3.0之后，Spring MVC全面超越 Struts2成为最受欢迎的的 MVC 框架（此时大家可以搜搜Struts2漏洞），因为更安全，性能也更好。

Spring MVC采用了松散耦合可插拔组件结构，比其他 MVC 框架更具扩展性和灵活性，支持本地化解析、主题解析、文件上传、灵活的数据验证、支持 RESTful风格的 URL 请求 、数据绑定机制等等。不仅如此，Spring MVC提供了强大的约定优于配置的契约式编程支持，使开发更灵活，也更受欢迎。

在之前我们说了MVC框架都有一个前端控制器，Spring MVC框架的前端控制器是 DispatcherServlet，顾名思义是基于Servlet实现的，所以使用Spring MVC框架需要先在web.xml配置它（在前面先抛出这句话，怕你们忘了）。

从Spring5开始，Spring又推出了一个新的框架 Spring Web Flux，这是一个异步非阻塞Web框架。可以弥补Spring MVC是同步阻塞IO模型的，浪费资源比较严重的不足。如何选择、如何使用请先看官方文档。

Spring MVC的第一个程序

开发工具选用STS工具，Spring版本选用5.02版本，考虑大家可能没有学过Maven，所以采用直接拷贝jar的方式。
在本文中，我们且先不管什么原理，流程这些，霸王硬上弓，直接先做出第一个SpringMVC程序。

该程序的目标是-通过SpringMVC处理请求，在控制台打印一句话，并跳转到一个JSP页面，在JSP页面中显示出作用域中的共享数据。

第1步、新建Dynamic Web Project，拷贝依赖的jar包：

拷贝依赖的jar
1、添加Spring的核心包
com.springsource.org.apache.commons.logging-1.1.1.jar
spring-core-5.0.2.RELEASE.jar
spring-beans-5.0.2.RELEASE.jar
spring-context-5.0.2.RELEASE.jar
spring-expression-5.0.2.RELEASE.jar
2、添加SpringMVC的核心包
spring-web-5.0.2.RELEASE.jar spring 对web项目的支持
spring-webmvc-5.0.2.RELEASE.jar spring mvc核心包

项目结构如下：

第2步、在web.xml中配置前端控制器：

<servlet>
    <servlet-name>SpringMVC</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:mvc.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>SpringMVC</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

这里有几点需要注意的：

• contextConfigLocation配置

   <init-param>
     <param-name>contextConfigLocation</param-name>
     <param-value>classpath:mvc.xml</param-value>
  </init-param>
  

  该初始化化参数的目的是，在DispatcherServlet在初始化时候会去加载的一个初始化参数配置，该参数配置的目的就是去加载SpringMVC配置文件，比如此时就表示去classpath根目录去加载mvc.xml文件。

当然该初始化参数也可以不用配置，在缺省情况下，DispatcherServlet会去WEB-INF目录下去按照servletName-servlet.xml方式去加载SpringMVC配置文件。比如servlet-name元素文本内容是hello，则会去WEB-INF目录下寻找hello-servlet.xml文件。

一般的，我们从classpath路径，显示去加载SpringMVC的配置文件。

• load-on-startup配置

    <load-on-startup>1</load-on-startup>
  

在servlet元素配置中，load-on-startup元素是可选的，如果存在，则该Servlet程序会随着Web服务器的启动而创建对象并调用init方法做初始化操作；如不存在，则Servlet在第一次请求时创建和初始化。一般的，把这个值设置为1即可，值越小越优先启动。

• url-pattern配置

   <url-pattern>/</url-pattern>
  

  在Servlet程序中，url-pattern元素时用来设置URL访问的规则的。在Spring MVC中，该配置比较讲究，我们在后面的文章中会专门去讲解，现在就只需要配置成 / 即可。

配置如 *.do、*.htm格式，传统方式，不会导致静态文件（jpg、 js、 css等）被拦截，但很难支持RESTful风格。
配置成 / 格式，支持流行的 RESTfull风格，但会导致静态文件（jpg、 js、 css等）被拦截后不能正常显示。
配置成 /* 格式，错误的配置方式，可以请求到 Controller 中，但调转到jsp时被拦截，不能渲染jsp视图。
后面再做细讲。

第3步、开发HelloController类

此时必须要求HelloController类实现于org.springframework.web.servlet.mvc.Controller接口，并覆盖接口中的handleRequest方法。

 public class HelloController implements Controller {
    public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response)            
          throws Exception {
        System.out.println("hello.....");
        //创建ModelAndView对象
        ModelAndView mv = new ModelAndView();
        //在request作用域设置需要共享的数据
        mv.addObject("helloMsg", "你好SpringMVC");
        //设置该请求处理完只有跳转到哪一个物理视图
        mv.setViewName("/WEB-INF/views/hello/welcome.jsp");
        return mv;
    }
}

这里的ModelAndView对象，其实就是模型数据（Model）和视图（View）的合体，所以ModelAndView对象既包含了需要共享的数据封装，也包含了需要跳转页面的封装。

• 共享数据：helloMg=你好SpringMVC
• 物理视图：/WEB-INF/views/hello/welcome.jsp

第4步、Spring MVC的bean配置

根据之前配置前端控制器DispatcherServlet的初始化参数contextConfigLocation，我们需要新建一个mvc.xml文件，并符合Spring配置文件的约束。

<?xml version="1.0" encoding="UTF-8"?>
<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">

    <!--1:处理器映射器 -->
    <bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping" />
    <!--2:处理器适配器 -->
    <bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter" />
    <!--3:视图解析器 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" />
    <!--4:配置我们自己编写的处理器 -->
    <bean id="/hello" class="cn.wolfcode.hello.HelloController" />
</beans>

接下来，我们针对mvc.xml中配置的每一个bean先做简单讲解和解释：

• 处理器映射器-BeanNameUrlHandlerMapping
  处理器映射器的作用是根据请求的url查去找Controller(处理器)，BeanNameUrlHandlerMapping表示按照请求的URL去匹配哪一个Controller。举个例子，在浏览器地址栏请求地址是：http://localhost/hello，那么此时请求的URL是/hello，此时框架就会去选择在容器中哪一个Controller的bean元素配置的id或name是/hello,如果找到，就表示找到了待会由这一个Controller来处理请求，找不到就报错。

• 处理器适配器-SimpleControllerHandlerAdapter
  处理器适配器的作用是按照特定规则（HandlerAdapter要求的规则）去执行匹配的Controller，我们查看SimpleControllerHandlerAdapter 部分源代码：

  public class SimpleControllerHandlerAdapter implements HandlerAdapter {
    public boolean supports(Object handler) {
        return (handler instanceof Controller);
    }
    @Nullable
    public ModelAndView handle(HttpServletRequest request, HttpServletResponse response, Object handler)  throws Exception {
        return ((Controller) handler).handleRequest(request, response);
    }
  }
  

  此时，我们发现在handle方法中会先把handler对象（其实就是处理请求的对象，也就是我们说的Controller）强制转换为Controller类型，然后，并调用handleRequest方法。

通过这段这里，我们知道了自定义的Controller类必须实现Controller接口并覆盖handleRequest方法。

• 视图解析器-InternalResourceViewResolver
  视图解析器的作用是进行视图解析，把逻辑视图名解析成真正的物理视图，选择一种模板引擎渲染视图。此时配置的InternalResourceViewResolver其实就是使用JSP模板引擎的视图解析器。

• 处理器-HelloController
  处理器的作用是接受用户请求信息，调用业务方法处理请求，也称之为后端控制器。在SpringMVC中说的Controller、Handler都表示它，说人话就是处理请求的对象。需要我们自行开发，但是必须符合HandlerAdapter规范，否则执行不了。

第5步、开发JSP

在HelloController类中我们指明了，处理完请求后，需要跳转到/WEB-INF/views/hello/welcome.jsp页面上显示作用域中的共享数据，共享数据的key为helloMsg（看上文）。
welcome.jsp核心代码如下：

<%@ page language="java" contentType="text/html; charset=UTF-8"%>
${helloMsg}

此时到这，SpringMVC的第一个程序就开发完了。

第6步、部署访问

部署和启动服务器后，使用浏览器访问http://localhost:80/hello资源，
此时控制台打印出hello…..，并且浏览器页面上显示出——你好SpringMVC。
OK，SpringMVC的第一个程序就到这里了，打完收工！

---

小结

1、按照本文的流程，开发出Spring MVC的第一个程序。

2、SpringMVC的执行流程、各个组件等尚未做详细介绍，后文会详细介绍。