SpringMVC Hello World

这一节里创建一个最简的 SpringMVC 的 Web 项目，也是 SpringMVC 配置的核心。

resources 目录用于存储资源文件，例如 spring-mvc.xml 等。
它里面的文件在项目编译时会自动的复制到 classes 目录。

简单的先看一下 SpringMVC 的处理流程

现在先看一下项目的目录结构，如图

接下来开始 SpringMVC 项目的创建。

1. 配置 pom.xml

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.tur</groupId>
    <artifactId>Training</artifactId>
    <packaging>war</packaging>
    <version>1.0-SNAPSHOT</version>
    <name>Training Maven Webapp</name>
    <url>http://maven.apache.org</url>

    <properties>
        <!-- 定义变量, 保存各个 jar 包的版本, ⽅方便修改 -->
        <spring.version>4.1.1.RELEASE</spring.version>
        <servlet.version>3.1.0</servlet.version>
        <jstl.version>1.2</jstl.version>
        <tomcat.version>2.2</tomcat.version>
    </properties>

    <!-- 统⼀一管理 Spring 的版本 -->
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-framework-bom</artifactId>
                <version>${spring.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <dependencies>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>${servlet.version}</version>
            <!--注意 scope 用的是 provided-->
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>jstl</artifactId>
            <version>${jstl.version}</version>
        </dependency>

        <!-- For Spring MVC -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
        </dependency>
    </dependencies>

    <build>
        <finalName>Training</finalName>
        <plugins>
            <plugin>
                <!--嵌入式的 Tomcat Web Server-->
                <groupId>org.apache.tomcat.maven</groupId>
                <artifactId>tomcat7-maven-plugin</artifactId>
                <version>${tomcat.version}</version>
                <configuration>
                    <path>/</path>
                    <!--Content Path用 /，而不是项目名-->
                    <uriEncoding>UTF-8</uriEncoding>
                    <!--处理 GET 请求的编码-->
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

2.创建 resources/spring-mvc.xml

为了方便管理，把资源文件都放在 resources 目录里。

<?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:p="http://www.springframework.org/schema/p"
       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">

    <!-- ⾃自动扫描的包名:
         在包名 controller 下的标记为 @Controller, @Service, @Component 的类
         都会⾃动的生成一个对象存储到 Spring Container ⾥
    -->
    <context:component-scan base-package="controller"></context:component-scan>

    <!-- 默认的注解映射支持 -->
    <mvc:annotation-driven/>

    <!-- 视图解析器中没有⽤ suffix 是为了可以根据 suffix ⾃动选择视图解析器，为了同时支持多种视图解析器 -->
    <!-- JSP 视图解析器，JSP 文件放在目录 WEB-INF/view/jsp 下 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
        <property name="prefix" value="/WEB-INF/view/jsp/"/>
        <property name="order" value="1"/>
    </bean>

    <!--<mvc:default-servlet-handler/> 我们不使用默认的 servlet-handler 处理资源访问 -->
    <!-- 对静态资源的访问，如 js, css, jpg, png -->
    <!-- 如 HTML 里访问 /js/jquery.js, 则实际访问的是 /WEB-INF/resources/js/jquery.js -->
    <mvc:resources mapping="/js/**" location="/WEB-INF/resources/js/" cache-period="31556926"/>
    <mvc:resources mapping="/css/**" location="/WEB-INF/resources/css/" cache-period="31556926"/>
    <mvc:resources mapping="/images/**" location="/WEB-INF/resources/images/" cache-period="31556926"/>
</beans>

3. 配置 WEB-INF/web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app
        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"
        version="3.0"
        metadata-complete="false">

    <servlet>
        <servlet-name>springmvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>

        <init-param>
            <param-name>contextConfigLocation</param-name>
            <!-- classes 目录中的文件可以用前缀 classpath: 来访问 -->
            <param-value>classpath:spring-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>
</web-app>

4. 创建 WEB-INF/view/jsp/helloworld-springmvc.jsp

Welcome to SpringMVC!

5. 创建 `Controller`: java/controller/HelloWorldController.java

还记不记得目录 java 是用来存储 java 源文件的？

package controller;

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

@Controller
public class HelloWorldController {

    @RequestMapping("/helloworld-springmvc")
    public String helloWorld() {
        return "helloworld-springmvc.jsp";
    }
}

到这里，SpringMVC 项目的文件和配置都已经准备好了，我们再来看一下项目的目录结构

6. 在浏览器里输入 http://localhost:8080/helloworld-springmvc

注：我们没有直接访问 ~~helloworld-springmvc.jsp~~，而且出于安全的考虑， WEB-INF 目录下的文件都不能从浏览器端直接访问。
访问 /helloworld-springmvc，SpringMVC 框架会查找 Controller 使用 @RequestMapping 注册的 URL 与其对应的 view 这里即 jsp 文件，然后访问这个 jsp 文件，输出到浏览器，所以我们看到了 helloworld-springmvc.jsp 输出的内容。

7. 热部署工具 `SpringLoaded`

开发的时候需要经常修改类，添加类。如果不支持热部署的话，修改后就需要重启 Server 才能看到修改后的内容。JVM 默认已经提供了基本热部署的功能，但是只限于修改已有的方法，对于新添加的方法，类等就无能为力了。SpringLoaded 是一个免费的热部署工具，功能挺不错的，能满足我们绝大部分的需求。

SpringLoaded 允许

添加新的类
添加和修改类的方法
添加新字段和构造函数
修改注解

等等修改都能即时生效，而不是需要重启应用。默认情况下，每隔一秒种，SpringLoaded 就会扫描类路径，自动加载改变过的类。

SpringLoaded 的使用也很简单，在启动程序的时候添加如下 JVM 参数即可：

-javaagent:<pathTo>/springloaded-{VERSION}.jar -noverify

IDEA里使用 SpringLoaded 设置如图：

设置好后使用 Debug 模式启动 Web Server，然后添加新方法，新类，注解等，然后编译，可以看到修改立即生效。

SpringMVC Architecture

Spring工作流程描述

用户向服务器发送请求，请求被 Spring 前端控制 Servelt DispatcherServlet 捕获；
DispatcherServlet 对请求 URL 进行解析，得到请求资源标识符（URI）。然后根据该 URI，调用HandlerMapping 获得该 Handler 配置的所有相关的对象（包括 Handler 对象以及 Handler 对象对应的拦截器），最后以 HandlerExecutionChain 对象的形式返回；
DispatcherServlet 根据获得的 Handler，选择一个合适的 HandlerAdapter。（附注：如果成功获得HandlerAdapter 后，此时将开始执行拦截器的 preHandler(...)方法）
提取 Request 中的模型数据，填充 Handler 入参，开始执行 Handler（Controller)。在填充Handler 的入参过程中，根据你的配置，Spring 将帮你做一些额外的工作： HttpMessageConveter：将请求消息（如 Json、xml 等数据）转换成一个对象，将对象转换为指定的响应信息
数据转换：对请求消息进行数据转换。如 String 转换成 Integer、Double 等
数据根式化：对请求消息进行数据格式化。如将字符串转换成格式化数字或格式化日期等
数据验证：验证数据的有效性（长度、格式等），验证结果存储到 BindingResult 或 Error 中
Handler 执行完成后，向 DispatcherServlet 返回一个 ModelAndView 对象；
根据返回的 ModelAndView，选择一个适合的 ViewResolver（必须是已经注册到 Spring 容器中的ViewResolver）返回给 DispatcherServlet ；
ViewResolver 结合 Model 和 View，来渲染视图
将渲染结果返回给客户端。

Spring MVC 教程,快速入门,深入分析