【Spring MVC 4 教程 02】Hello Spring MVC

原创 springmvc spring 教程

在前面【Spring MVC 4 教程 01】基础概念一文中，简单介绍了 Spring MVC 的基础概念，框架的架构和执行流程，作为教程开篇。

示例演示如何使用 Spring MVC 框架编写一个简单的基于 Web 的 Hello World 应用程序。

新建工程

首先使用 IDEA，并按照以下步骤使用 Maven 创建一个动态 Web 应用程序：

新建工程，选择 Maven，在右侧勾选 create from archetype 选项，选择 org.apache.maven.archetypes:maven-archetype-webapp，点击 Next。

依次填写 maven 信息。

等待构建完成，查看目录，/src/main 下面很可能只有一个 webapp 目录。需要在 /src/main 下面手动创建源代码目录 /src/main/java 和配置资源文件目录 /src/main/resources，然后在 Project Structure 中依次 Mark AS Sources 和 Resources。

创建完成后，整个工程的目录结构如下图所示：

项目依赖

Hello World 工程，实现一个最简约的 Spring MVC 项目，请求后台，返回一个消息，在页面上显示，所需要的依赖：

pom.xml 文件 dependencies：

<dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.11</version>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1.0</version>
            <scope>provided</scope>
        </dependency>

        <dependency>
            <groupId>commons-logging</groupId>
            <artifactId>commons-logging</artifactId>
            <version>1.2</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-aop</artifactId>
            <version>4.3.18.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-beans</artifactId>
            <version>4.3.18.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>4.3.18.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
            <version>4.3.18.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-expression</artifactId>
            <version>4.3.18.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-web</artifactId>
            <version>4.3.18.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>4.3.18.RELEASE</version>
        </dependency>
    </dependencies>

Controller

创建一个 /hello 请求，直接返回一条消息。

HelloController.java

package com.daimafans.demo.hellospringmvc;

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

/**
 * Hello Spring MVC
 *
 * @author liuqianfei
 * @since 2018/8/16 14:01
 */
@Controller
@RequestMapping("hello")
public class HelloController
{
    @RequestMapping(method = RequestMethod.GET)
    public String printHello(ModelMap model)
    {
        model.addAttribute("message", "Hello Spring MVC Framework!");

        return "hello";
    }
}

web.xml

这里有个小插曲，我记录在 JSP EL 表达式 ${message} 不解析，原样输出问题中了。

<?xml version="1.0" encoding="UTF-8"?>

<web-app version="3.1" xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd">

    <display-name>Spring MVC Application</display-name>

    <servlet>
        <servlet-name>HelloWorld</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!-- DispatchServlet 相应的上下文配置，如果不配置，默认寻找 /WEB-INF/$servlet-name$-servlet.xml -->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:/configs/spring-mvc.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>HelloWorld</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
</web-app>

这里关注一下注释，我们的 Spring MVC XML 配置文件放在 classpath:/configs/spring-mvc.xml 这里了，并且配置文件名称是自定义的。

如果不配置 contextConfigLocation 选项，默认情况下，Spring MVC 会去 /WEB-INF/ 目录下寻找 <servlet-name> 配置的名称加上 -servlet.xml 文件，比如这里如果默认，就是 HelloWorld-servlet.xml。

spring-mvc.xml

简单配置组件扫描目录和 ViewResolver，按照一般约定习惯，视图文件放在 /WEB-INF/view/ 目录，Demo 视图使用 JSP。

<?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"
       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">

    <context:component-scan base-package="com.daimafans.demo.hellospringmvc"/>

    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/view/"/>
        <property name="suffix" value=".jsp"/>
    </bean>
</beans>

hello.jsp

注释掉的 isELIgnored 参见上面的小插曲。

<%@ page contentType="text/html; charset=UTF-8" %>
<%--<%@ page isELIgnored="false" %>--%>
<html>
<head>
    <title>Hello World</title>
</head>
<body>
    <h2>Hello, ${message}</h2>
</body>
</html>

运行结果

如果要获取 War 包，直接到项目根目录执行 mvn package 就可以了，我们直接使用 IDEA 来启动项目。

配置好 Tomcat，运行。

在浏览器上访问 http://localhost:8080/hello。

教程目录：Spring MVC 4 教程