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

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