HelloWorld of Spring MVC

使用 IntelliJ IDEA 可以快速创建一个 Spring MVC HelloWorld (参本站的 HelloWorld of Spring MVC by IntelliJ IDEA)

项目结构分析

Spring MVC 的 web 项目，比标准的 Java Web 项目，在 WEB-INF 下多了一个 mvc-dispatcher-servlet.xml 文件，jsp 页面也放到 WEB-INF/pages 中去了。

architecture of code of helloworld of spring mvc

配置文件

在 web.xml 中设置 Spring MVC 入口

<servlet>

    <servlet-name>mvc-dispatcher</servlet-name>

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

    <load-on-startup>1</load-on-startup>

</servlet>

<servlet-mapping>

    <servlet-name>mvc-dispatcher</servlet-name>

    <url-pattern>/</url-pattern>

</servlet-mapping>

以上定义了一个名为 mvc-dispatcher 的 servlet，需要注意匹配模式，是 / 不是 /*。按 Spring MVC 的约定，需要在这个目录中建一个 {servlet name}-servlet.xml 的配置文件，即 mvc-dispather-servlet.xml，内容如下：

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

    <mvc:annotation-driven/>

    <mvc:default-servlet-handler/>

    <context:component-scan base-package="com.springapp.mvc"/>

    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">

        <property name="prefix" value="/WEB-INF/pages/"/>

        <property name="suffix" value=".jsp"/>

    </bean>

</beans>

以上设置了 Controller 所在的目录，即 context:component 元素中定义的 com.springapp.mvc, 另外一个 bean 定义了寻找资源的前缀和后缀。

以上加粗的三句需要特别注意！

1. <mvc:annotation-driven/> 和 <mvc:default-servlet-handler/> 必须有，否则会报错，更严重的是，不能在 tomcat 8 中部署。

2. <context:component-scan base-package="com.springapp.mvc"/> 不能改成<context:component-scan base-package="com.springapp.mvc.*"/>。

Controller

package com.springapp.mvc;

import org.springframework.stereotype.Controller;

import org.springframework.ui.ModelMap;

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

import org.springframework.web.bind.annotation.RequestMethod;

@Controller

@RequestMapping("/")

public class HelloController {

@RequestMapping(method = RequestMethod.GET)

public String printWelcome(ModelMap model) {

model.addAttribute("message", "Hello world!");

return "hello";

}

注意这个 Controller 的注解，@Controller 说明它是一个 Controller, @RequestMapping 的属性定义了访问路径, 方法的返回值是 hello, 这个会作为完整的访问路径的一部分，结合前面提到的访问路径的前后缀，最终的访问路径将是 /hello 访问路径的后缀在前面的 model 设置了返回值。下面再看页面代码：

hello.jsp

位于 WEB-INF/pages/hello.jsp

<html>

<body>

<h1>${message}</h1>

</body>

</html>

超简单，其中用到了 el 表达式，message 就是前面 Controller 里设置的 model 里的值。

以上是通过注解方式完成的 HelloWorld，实际上，还可以不用注解，这里不做记录。

pom.xml

本项目用到的 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.springapp</groupId>

    <artifactId>helloworld</artifactId>

    <packaging>war</packaging>

    <version>1.0-SNAPSHOT</version>

    <name>helloworld</name>

    <properties>

        <spring.version>4.1.1.RELEASE</spring.version>

    </properties>

    <dependencies>

        <dependency>

            <groupId>org.springframework</groupId>

            <artifactId>spring-core</artifactId>

            <version>${spring.version}</version>

        </dependency>

        <dependency>

            <groupId>org.springframework</groupId>

            <artifactId>spring-web</artifactId>

            <version>${spring.version}</version>

        </dependency>

        <dependency>

            <groupId>javax.servlet</groupId>

            <artifactId>servlet-api</artifactId>

            <version>2.5</version>

        </dependency>

        <dependency>

            <groupId>javax.servlet.jsp</groupId>

            <artifactId>jsp-api</artifactId>

            <version>2.1</version>

            <scope>provided</scope>

        </dependency>

        <dependency>

            <groupId>org.springframework</groupId>

            <artifactId>spring-webmvc</artifactId>

            <version>${spring.version}</version>

        </dependency>

        <dependency>

            <groupId>org.springframework</groupId>

            <artifactId>spring-test</artifactId>

            <version>${spring.version}</version>

            <scope>test</scope>

        </dependency>

        <dependency>

            <groupId>junit</groupId>

            <artifactId>junit</artifactId>

            <version>4.11</version>

            <scope>test</scope>

        </dependency>

    </dependencies>

    <build>

        <finalName>helloworld</finalName>

        <plugins>

            <plugin>

                <artifactId>maven-compiler-plugin</artifactId>

                <configuration>

                    <source>1.6</source>

                    <target>1.6</target>

                </configuration>

            </plugin>

            <plugin>

                <artifactId>maven-surefire-plugin</artifactId>

                <configuration>

                    <includes>

                        <include>**/*Tests.java</include>

                    </includes>

                </configuration>

            </plugin>

        </plugins>

    </build>

</project>

Page updated

Google Sites

Report abuse