Spring MVC复习 —— 搭建Spring MVC项目

??摘要：这篇笔记是关于Spring MVC的复习，内容是如何搭建Spring MVC项目。

??让我们快速的搭建一个Spring MVC项目。

1.点击创建项目

2.选择webapp模板并完成创建

??这里存在两个同名模板，我们选择下边这个：

3.导入依赖jar包

??昨天在导入依赖jar包的时候我遇到一个问题，就是在导入到一半的时候网断了，关于这种情况Maven没有像迅雷和百度网盘那样的下载断点机制，因而会出现严重的错误，关于这种问题我有一种解决办法，详情见链接：Maven项目中导入坐标依赖时报（Failure to transfer…）的错的问题 - 云杉木屋 - 博客园 (cnblogs.com)。

??接下来我们将下面的jar包依赖复制到我们的pom文件中：

<!--版本锁定-->
<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>

??如图所示：

4.修改XML文档

??我们将web.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>

??之后我们配置过滤器，前端控制器以及初始页面等信息，我们将下面的代码粘贴进web.xml文档中：

<!--在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>

??现在这里有个报错的地方：springmvc.xml这是因为我们还没有创建这个配置文档，我们现在就配置它。

5.配置springmvc.xml

??关于这个配置文件我们其实可以给他起任意的名字，只要是在web.xml中引用时名字一样即可。现在我们在main目录下创建两个重要的目录：java和resource。

??然后我们在resource中创建一个配置文件，取名为springmvc.xml，其实取什么都行，只要和web.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>

??我们注意到这里有个报错的地方，这是因为在这个位置使用的是Spring的IOC控制权反转支持，这个配置标签是用来扫描我们要被代理生成对象的包的，我们现在没创建这个包，所有报错了，因为这块配置信息是别人写的模板我拿来用了，因此会出现这种先有蛋后有鸡的错误。不管怎样我们现在配置好springmvc.xml了，我们现在赶紧创建那个包。

6.创建被代理的包以及controller层

??叮叮叮叮！创建好了，就这么简单，我们现在可以观察到springmvc里边不报错了：

??现在我们可以写一些简单的代码，并实现一些简单的逻辑了。我们做测试如下：

1.在controller包中创建名为HelloController的类

2.往里边放上如下代码，完成后效果如上图：

package com.spruce.controller;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;

//把当前类交给IOC容器进行管理
@Controller
public class HelloController {
    /**
     * 处理超链接发送出来的请求
     * @param model
     * @return
     */
    @RequestMapping(path = "/hello.do")
    public String sayHello(Model model){

        System.out.println("入门方法执行了2...");
        // 向模型中添加属性msg与值，可以在html页面中取出并渲染
        model.addAttribute("msg","hello,SpringMVC");
        // 配置了视图解析器后，写法
        return "suc";

    }
}

3.在webapp中创建index.html并粘贴上如下代码

<html>
<head>
    <meta charset="utf-8">
    <title>入门程序</title>
</head>
<body>
<h3>入门</h3><a href="/SpringMVCLearn/hello.do" >入门程序</a>
</body>
</html>

4.在webapp下创建html目录，在里边创建suc.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>