Spring MVC学习(一) Spring MVC基本介绍以及配置

Spring MVC学习(一) Spring MVC基本介绍以及配置

  摘要：这篇笔记是对于Spring MVC的第一部分的学习中的整理，主要记录了Spring MVC的基础知识以及配置一个简单的Spring MVC项目的方法。

目录

• Spring MVC学习(一) Spring MVC基本介绍以及配置
  • 1.Java Web的发展历史
    • 1.1.Model I 和Model II
      • 1.1.1.Model I开发模式
      • 1.1.2.Model II开发模式
    • 1.2.MVC模式
  • 2.Spring MVC的入门案例
    • 1.工程创建
    • 2.导入坐标
    • 3.修改XML文档
      • 3.1.过滤器
      • 3.2.前端控制器
      • 3.3.重要的url-pattern标签
    • 4.配置springmvc.xml文件
    • 5.创建模拟操作
      • 5.1.创建index.html
      • 5.2.创建hello这个servelt
      • 5.3.创建suc.html
    • 6.配置tomcat并测试
      • 6.1.点击添加配置
      • 6.2.添加tomcat配置
      • 6.3.设置配置信息
      • 6.4.测试

1.Java Web的发展历史

1.1.Model I 和Model II

1.1.1.Model I开发模式

  Model I的开发模式是：JSP+JavaBean的模式，它的核心是Jsp页面，在这个页面中，Jsp负责整合页面与业务逻辑，并且渲染页面，其基本流程如下：

  我曾经在大学时代开发过这种结构的项目，上文提到的Jsp负责整合页面与业务逻辑说白了就是前端渲染的html标签信息和Java代码混在了一起，在Jsp页面中，我们会使用一种特殊的Java标签将Java语言嵌入到前端页面中，进而进行逻辑上的控制，这这一看非常方便，但是实际上这样的设计模式导致一个Jsp页面既负责视图的展示，有负责业务流程的控制，耦合度极高，后期在维护的时候也必然是十分复杂。

1.1.2.Model II开发模式

  在Model II开发模式下，利用Jsp页面、servlet和JavaBean组件分工协作共同完成系统的所有任务。其中Jsp页面负责数据显示逻辑任务，servlet负责程序的流程控制任务、JavaBean负责处理业务逻辑任务，其基本流程如下：

  这种模式的项目我也开发过，实际上就是加上一个Servlet部分，这个部分通常是用来进行前端和后端的数据交互，大部分与数据库交互的代码都存在于JavaBean中，Servlet是调用这些方法的一个集合地，而前端通常是通过表单或者按钮的形式(有时也可以用Ajax)向Servlet中进行请求的提交，这些请求就会触发相应的JavaBean中的逻辑方法，记得大学时在学习完Model I之后，我们就主要在学习这种模式，直到几个月前我还尝试写了几个这个模式的项目。对于Model I来说，职责分工更加明确了，在Model I中抽取出了Servlet层，基本上体现了分层的思想，这种开发模式是非常符合当年，注意是当年的大型项目开发的，现在这种模式也已经过时了，一些小型项目或者是大学生毕业设计仍然会采用这种开发模式，但是大型的应用级别项目已经不使用这种开发模式了。

1.2.MVC模式

  MVC模式是符合当今开发思想的开发模式，典型者如Spring MVC，实际上Spring MVC是Spring的一个模块，专门做web开发，也就是专门做网站的一种开发模式，我们可以理解为Servlet的升级模式，在Spring MVC框架中，Controller替代Servlet担负起控制器的职能。其中：

  M：指model(模型)层，指的是工程中的JavaBean，作用是数据处理，其中Java Bean也分为两类，一类是实体类Bean，专门存储业务数据用；一类为业务处理Bean，指的是Servlet或者Dao对象，专门处理业务逻辑和数据。

  V：View(视图)层，视图层指项目当中的html或者Jsp等页面，作用是与用户进行交互，展示数据等。

  C：Controller(控制)层，指工程当中的Servlet，作用是接收请求和相应数据，需要注意的是，model层专门指实体类Bean，我们的一些实体类的模型都会放在model层中。

  MVC思想不是专门指某一个语言特有的设计模式，也不是web开发中所特有的思想，而是一种规范。MVC思想将一个应用分成三个基本部分：Model(模型)、View(视图)和Controller(控制器)，这三个部分以最少的耦合协同工作，进而提升了应用的可扩展性和可维护性。

2.Spring MVC的入门案例

  接下来让我们搭建一个Spring MVC的项目，以此为学习Spring MVC的开端。

1.工程创建

  首先如下图所示，我们创建一个Maven项目，其中我们使用WEB模板：

  需要注意的是我们需要选择下边这个webapp，也就是这个：

  之后我们点击next，进行一些基本的配置，如设置项目名称，组织名称等，在学习阶段，这些都可以随心所欲他写：

  设置Maven路径：

  完成！

2.导入坐标

  在创建好项目之后，开发环境会为我们进行一个短暂的pom文件生成，这时会自动生成一些坐标与其他配置信息，我们需要注意下面这条信息：

  我们需要让这个packaging标签中的值为war，以保证我们打包出来的结果是一个war包，因为即将要被配置到服务器框架中的项目的打包结果我们一般都会让它是war包，服务器框架们一般也是只识别war包。之后我们将自己的坐标依赖导入到项目中，导入我们需要的所有jar包，坐标依赖如下：

<!--版本锁定-->
<properties>
  <spring.version>5.0.2.RELEASE</spring.version>
</properties>
<dependencies>
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-context</artifactId>
    <version>${spring.version}</version>
  </dependency>
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-web</artifactId>
    <version>${spring.version}</version>
  </dependency>
  <!--SpringMVC-->
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>${spring.version}</version>
  </dependency>
  <!--servlet API-->
  <dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>servlet-api</artifactId>
    <version>2.5</version>
    <scope>provided</scope>
  </dependency>
  <dependency>
    <groupId>javax.servlet.jsp</groupId>
    <artifactId>jsp-api</artifactId>
    <version>2.0</version>
    <scope>provided</scope>
  </dependency>
  <!--日志-->
  <dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.2.3</version>
  </dependency>
  <dependency>
    <groupId>org.thymeleaf</groupId>
    <artifactId>thymeleaf-spring4</artifactId>
    <version>3.0.9.RELEASE</version>
  </dependency>
</dependencies>

  导入成功：

3.修改XML文档

  我们将原有的xml文档用下边的配置信息完全替换：

<web-app version="3.0" xmlns="http://java.sun.com/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
   http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">
 </web-app>

  之后我们开始配置DispatcheServlet，Spring MVC是基于原生的Servlet的，通过强大的前端控制器DispatcheServlet，对请求和相应进行统一处理。Spring MVC本质上就是一个Servlet，是对原生的Servlet进行了封装，在以前我们浏览器的每一次请求都需要我们写一个对应的Servlet，现在我们只需要将浏览器的请求和相应交给DispatchServlet进行统一处理，我们在web.xml配置文件中配置核心控制器DispatcherServlet，配置信息如下：

<!--在web.xml中配置Spring提供的过滤器类 -->
<filter>
    <filter-name>encodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <async-supported>true</async-supported>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>encodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>
<!--不拦截所有是html的页面请求-->
<servlet-mapping>
    <servlet-name>default</servlet-name>
    <url-pattern>*.html</url-pattern>
</servlet-mapping>
<!--配置前端控制器，对浏览器发送的请求进行统一处理-->
<servlet>
    <servlet-name>dispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!--加载springmvc.xml配置文件的位置和名称，配置的是Spring配置-->
    <init-param>
        <!--contextConfigLocation:上下文配置路径，固定值-->
        <param-name>contextConfigLocation</param-name>
        <!--classpath:类路径，值得是Java和resources文件夹-->
        <!--springmvc.xml:指的是配置文件的名称：需要配置springmvc.xml，在下面-->
        <param-value>classpath:springmvc.xml</param-value>
    </init-param>
    <!--配置启动加载-->
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>
<!--开启项目时打开的页面-->
<welcome-file-list>
    <welcome-file>/index.html</welcome-file>
</welcome-file-list>

  我们将这段信息直接复制在web.xml内部，如图所示：

  其中有一个位置会报错：

  这是因为我们还需要一个Spring MVC配置文件，Spring MVC项目怎么能没有Spring MVC配置文件呢？不过现在让我们稍安勿躁，我们先来简单看看我们在web.xml中配置了些什么。

3.1.过滤器

<!--在web.xml中配置Spring提供的过滤器类 -->
<filter>
    <filter-name>encodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <async-supported>true</async-supported>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>encodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

  这部分是我们的过滤器配置信息，过滤器是专门过滤请求信息的，同时还可以对请求信息进行一系列的操作，这里在filter-mapping标签中定义了过滤的文件类型，以及过滤器主体的名字，进而做一个映射。filter是过滤器的实体，在里面规定了过滤器实体代码地址，是否支持异步，编码等信息，这些规定会对整个项目中的提交申请以及信息返回产生影响。

3.2.前端控制器

<servlet-mapping>
    <servlet-name>default</servlet-name>
    <url-pattern>*.html</url-pattern>
  </servlet-mapping>
<!--不拦截所有是html的页面请求-->
  <!--配置前端控制器，对浏览器发送的请求进行统一处理-->
  <servlet>
    <servlet-name>dispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!--加载springmvc.xml配置文件的位置和名称，配置的是Spring配置-->
    <init-param>
      <!--contextConfigLocation:上下文配置路径，固定值-->
      <param-name>contextConfigLocation</param-name>
      <!--classpath:类路径，值得是Java和resources文件夹-->
      <!--springmvc.xml:指的是配置文件的名称：需要配置springmvc.xml，在下面-->
      <param-value>classpath:springmvc.xml</param-value>
    </init-param>
    <!--配置启动加载-->
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>

  这个部分就是我们提到的最重要的前端控制器的部分。在这里我们配置了两个前端控制器的映射，其中一个是我们自己书写的前端控制器，一个是默认的前端控制器，在默认的前端控制器映射中规定了拦截模式，这里url-pattern标签为*.html意味着不拦截所有的html页面的请求，只要是请求html类型的文件一律放行。

  在我们自己书写的前端控制器中就精彩多了：

<servlet>
    <servlet-name>dispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!--加载springmvc.xml配置文件的位置和名称，配置的是Spring配置-->
    <init-param>
      <!--contextConfigLocation:上下文配置路径，固定值-->
      <param-name>contextConfigLocation</param-name>
      <!--classpath:类路径，值得是Java和resources文件夹-->
      <!--springmvc.xml:指的是配置文件的名称：需要配置springmvc.xml，在下面-->
      <param-value>classpath:springmvc.xml</param-value>
    </init-param>
    <!--配置启动加载-->
    <load-on-startup>1</load-on-startup>
  </servlet>

  首先加载了前端控制器的实体类，然后我们在里边加入了springmvc.xml的映射信息，以便于项目加载springmvc.xml中的信息，load-on-startup是启动加载模式。我们在自己书写的前端控制器映射中还限制了请求的类型：

<servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>

  servlet-mapping标签中的url-pattern为"/"，意思为不拦截任何信息，非常宽泛的一个拦截。

3.3.重要的url-pattern标签

  我发现很多部分中都存在url-pattern这个标签，这个标签是干什么用的呢？这个标签实际上就是进行请求拦截用的，它会对符合其内部格式的文件请求放行，否则将拦截，这里有一个对照说明表：

精确匹配	/具体的名称	只有url路径是具体的名称时才会被通过并触发Servlet
后缀匹配	*.XXX	只要是后缀为XXX的请求就会被通过
通配符匹配	/*	匹配所用请求(在访问的时候，“/”后边些什么都能匹配到当前的资源，能够访问到服务器上的所有资源)
通配符匹配	/	匹配所有请求，能够访问到服务器上的所有资源，但是不包括.jsp文件

4.配置springmvc.xml文件

  项目中不自带这个文件，所有我们首先要自己创建一个，在此之前，我们要现在项目的main目录下创建两个重要的目录，分别是java源程序目录和resource资源目录：

  然后我们在resource目录下创建springmvc.xml文件：

  然后我们就创建好了：

  我们把下面的配置信息复制到springmvc.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.xsd
       http://www.springframework.org/schema/context
       http://www.springframework.org/schema/context/spring-context.xsd
       http://www.springframework.org/schema/mvc
       http://www.springframework.org/schema/mvc/spring-mvc.xsd">
    <!--配置spring创建容器时要扫描的包-->
    <context:component-scan base-package="com.spruce"></context:component-scan>
    <!--处理映射器-->
    <bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"/>
    <!--处理器适配器-->
    <bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter"/>
    <!--配置视图解析器-->
    <bean id="viewResolver" class="org.thymeleaf.spring4.view.ThymeleafViewResolver">
        <property name="order" value="1"/>
        <property name="characterEncoding" value="UTF-8"/>
        <property name="templateEngine" ref="templateEngine"/>
    </bean>
    <!-- templateEngine -->
    <bean id="templateEngine" class="org.thymeleaf.spring4.SpringTemplateEngine">
        <property name="templateResolver" ref="templateResolver"/>
    </bean>
    <bean id="templateResolver" class="org.thymeleaf.spring4.templateresolver.SpringResourceTemplateResolver">
        <property name="prefix" value="/html/" />
        <property name="suffix" value=".html" />
        <property name="templateMode" value="HTML5"/>
    </bean>
    <!-- 配置spring开启注解mvc的支持  默认就是开启的 ，要想让其他组件（不包含映射器、适配器、处理器）生效就必须需要配置了-->
    <mvc:annotation-driven></mvc:annotation-driven>
</beans>

  关于这个配置信息的结构我已经在之前的一篇笔记中记载过了，这里暂且不再深究，以后有时间我们慢慢品读，在此附上跳转链接，点击跳转。唯一一点需要注意的就是这个标签：<mvc:annotation-driven></mvc:annotation-driven>，如果引用地址写的不具体，我们在书写这个标签的时候会有多个选择，也就是可以从不同的地址中书写同样的这一个标签，这里我们注意，我们选择那个地址的末尾是mvc的，否则会报错。

5.创建模拟操作

5.1.创建index.html

  在上面的配置信息中我们把欢迎页面设置成为了index.html，在这个项目中只有一个index.jsp，因为jsp落后了我们暂且不学它了，所有把它替换成下面的index.html：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>欢迎来到米奇妙妙屋</title>
</head>
<body>
	<h3>入门</h3><a href="/SpringMVCStudy/hello" >入门程序</a>
</body>
</html>

5.2.创建hello这个servelt

  我们开始书写hello这个servlet，我们需要在Java中创建com.spruce包，然后再其下边创建一个controller包，然后在其下面创建这个servlet，其名字为HelloController:

package com.spruce.controller;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class HelloController {
    /**
     * 处理超链接发送出来的请求
     * @param model
     * @return
     */
    @RequestMapping(path = "/hello")
    public String sayHello(Model model){
        System.out.println("入门方法执行了2...");
        // 向模型中添加属性msg与值，可以在html页面中取出并渲染
        model.addAttribute("msg","hello,SpringMVC");
        // 配置了视图解析器后，写法
        return "suc";
    }
}

5.3.创建suc.html

  这是我们的跳转目的地，代码如下，我们将其创建在webapp下的html目录中，因为刚才的配置文件中对其的路径检索就是html目录下：

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>成功</title>
</head>
<body>
<h1>Hello <b th:text="${msg}"></b></h1>
</body>
<script>
</script>
</html>

6.配置tomcat并测试

  现在让我们配置一个tomcat然后对这个项目进行测试吧，下面是配置tomcat的过程：

6.1.点击添加配置

6.2.添加tomcat配置

6.3.设置配置信息

  在该页面下我们可以设置自己的tomcat路径，然后修改其访问路径：

  然后点击ok就完成了，完成后项目中会出现这样的东西：

6.4.测试

  点击运行按钮，就会自动触发浏览器并进入下面的页面：

  点击这个名为入门程序的按钮，就可以进入如下页面：

  能够进入如下页面则视为成功。