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
中去了。
配置文件
在 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>