Spring 4 MVC HelloWorld 纯注解方式（带源码）

#项目下载地址：http://websystique.com/?smd_process_download=1&download_id=1714#。

特别说明：此系列教程有的童鞋下载下来运行 经常404 或者改成xml方式以后

缺少org.springframework.web.context.ContextLoaderServlet等

参见：http://blog.csdn.net/w605283073/article/details/52126347

本节介绍Spring MVC 4接触，使用典型的hello world 但是没有忽略任何步骤。

下一节 将讲述完全基于Java注解的hello world例子。

----------------------------

本例使用了以下技术：

• Spring 4.0.6.RELEASE
• Maven 3
• JDK 1.6
• Eclipse JUNO Service Release 2
• M2Eclipse plugin (Optional)

如果你已经熟悉了怎么样在eclipse里创建maven项目，你可以忽略第一步。

第1步 :在eclipse中创建 Maven webapp 项目

File-> New -> Maven Project,

如果你想在其他文件夹创建项目 不要选择“Use default Workspace location”

点击下一步

选择maven web app archetyp，然后点击next

填入 Group Id, Artifact Id 以及版本。然后点击Finish

将会得到如下结构：

注意: 如果你没有看向项目结构里的 src/main/java 和 src/test/java 文件夹, 点击Project>Properties>Java BuildPath>Libraries, 选择或者切换java版本, 点击 ok, 那就可以看到上面的项目结构了.

注意:在Eclipse 最新的几个版本中你不再需要使用 mvn eclise:eclipse,这个方法在m2e eclipse 插件默认帮我们执行了.

第2步:在Maven pom.xml文件中添加Spring 依赖

因为这是一个maven项目，所有依赖(jar)都在pom.xml中进行配置，maven将自动帮我们下载所有的对应依赖（jar包）。

下面是pom.xml文件内容：

[html] view plain copy

1. <project  
2.     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"  
3.     xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
4.    
5.     <modelVersion>4.0.0</modelVersion>  
6.     <groupId>com.websystique.springmvc</groupId>  
7.     <artifactId>Spring4MVCHelloWorldDemo</artifactId>  
8.     <packaging>war</packaging>  
9.     <version>1.0.0</version>  
10.     <name>Spring4MVCHelloWorldDemo Maven Webapp</name>  
11.    
12.     <properties>  
13.         <springframework.version>4.0.6.RELEASE</springframework.version>  
14.     </properties>  
15.    
16.     <dependencies>  
17.         <dependency>  
18.             <groupId>org.springframework</groupId>  
19.             <artifactId>spring-webmvc</artifactId>  
20.             <version>${springframework.version}</version>  
21.         </dependency>  
22.    
23.         <!-- Below declared dependencies are included for the servers who may complain about servlet/jstl missing dependency -->  
24.         <dependency>  
25.             <groupId>javax.servlet</groupId>  
26.             <artifactId>javax.servlet-api</artifactId>  
27.             <version>3.1.0</version>  
28.         </dependency>  
29.         <dependency>  
30.             <groupId>javax.servlet.jsp</groupId>  
31.             <artifactId>javax.servlet.jsp-api</artifactId>  
32.             <version>2.3.1</version>  
33.         </dependency>  
34.         <dependency>  
35.             <groupId>javax.servlet</groupId>  
36.             <artifactId>jstl</artifactId>  
37.             <version>1.2</version>  
38.         </dependency>  
39.     </dependencies>  
40.    
41.     <build>  
42.         <pluginManagement>  
43.             <plugins>  
44.                 <plugin>  
45.                     <groupId>org.apache.maven.plugins</groupId>  
46.                     <artifactId>maven-compiler-plugin</artifactId>  
47.                     <version>3.2</version>  
48.                     <configuration>  
49.                         <source>1.6</source>  
50.                         <target>1.6</target>  
51.                     </configuration>  
52.                 </plugin>  
53.             </plugins>  
54.         </pluginManagement>  
55.         <finalName>Spring4MVCHelloWorldDemo</finalName>  
56.     </build>  
57. </project>  

maven  maven-compiler-plugin 插件也被添加进来，并且指明我们使用的java版本。注意这也迫使eclipse编译本项目时参考我们配置的版本。如果没有配置的话，eclipse 会自动的使用jdk 1.5版本。所以最好添加上去。

第3步: 添加Controller（控制器） 和 View（视图）

在 src/main/java [src/main/java->New->package] 下面创建一个新的包。

并添加一个新的Controller，如下面所示。它只是在模型中添加了一个字符串，并返回到视图。

com.websystique.springmvc.controller.HelloWorldController

[java] view plain copy

1. package com.websystique.springmvc.controller;  
2.    
3. import org.springframework.stereotype.Controller;  
4. import org.springframework.ui.ModelMap;  
5. import org.springframework.web.bind.annotation.RequestMapping;  
6. import org.springframework.web.bind.annotation.RequestMethod;  
7.    
8. @Controller  
9. @RequestMapping("/")  
10. public class HelloWorldController {  
11.    
12.     @RequestMapping(method = RequestMethod.GET)  
13.     public String sayHello(ModelMap model) {  
14.         model.addAttribute("greeting", "Hello World from Spring 4 MVC");  
15.         return "welcome";  
16.     }  
17.    
18.     @RequestMapping(value="/helloagain", method = RequestMethod.GET)  
19.     public String sayHelloAgain(ModelMap model) {  
20.         model.addAttribute("greeting", "Hello World Again, from Spring 4 MVC");  
21.         return "welcome";  
22.     }  
23.    
24. }  

让我们深入分析一下：

@Controller annotation marks this class as spring bean which may handle different HTTP requests based on mapping specified on class or individual controller methods.

@RequestMapping 注解用来映射web请求到指定的处理器类或者处理方法。 在本例中，我们在类级别也用了它，就是说此类是所有http“/”请求的默认处理器， @RequestMapping 也有很多属性 [value,method,params,..]能给用来更加详细的进行映射。

第一个方法，没有进行任何url映射声明，因此它将会继承类上面的映射声明，左右http Get请求的默认处理方法。

第二个方法（添加了带value的映射声明），它将用来处理带/helloagain 的请求。method 属性是用来指明此方法处理的http请求类型。

如果@RequestMapping  里面没有指明 method 则它将处理映射url的所有类型（GET POST等）的请求。

ModelMap  是一个Map 的实现类，它的目的是取代以前的 request.getAttribute/ request.setAttribute方法，

它提供一种 从request或者session中设置 或者获取属性的方式。

留意一下这些方法的返回值。这些值将是view resolver（看下面的 spring-servlet.xml） 的前缀或者后缀，来产生视图文件的真是名称。

在WEB-INF中创建views文件夹，在里面创建jsp页面如( WEB-INF/views/welcome.jsp) 。

在我们的例子中，只是简单的访问控制器发送来的模型值。

[html] view plain copy

1. <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>  
2. <!DOCTYPE html>  
3. <html lang="en">  
4. <head>  
5.  <meta charset="UTF-8">  
6. <title>演示页面</title>  
7. </head>  
8. <body>  
9.     Greeting : ${greeting}  
10. </body>  
11. </html>  

[html] view plain copy

1. </pre><pre>  

第4步:创建Spring配置文件

此处用xml方式进行配置，下一篇将讲述采用注解方式。

在  WEB-INF 文件夹下创建一个名为 spring-servlet.xml  的配置文件。

注意：此名字你可以随便起，但是要和web.xml里面声明的一致。

[html] view plain copy

1. <beans xmlns="http://www.springframework.org/schema/beans"  
2.     xmlns:context="http://www.springframework.org/schema/context"  
3.     xmlns:mvc="http://www.springframework.org/schema/mvc"  
4.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
5.     xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.0.xsd  
6.     http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd  
7.     http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd">  
8.    
9.     <context:component-scan base-package="com.websystique.springmvc" />  
10.    
11.     <mvc:annotation-driven />  
12.        
13.     <bean  
14.         class="org.springframework.web.servlet.view.InternalResourceViewResolver">  
15.         <property name="prefix">  
16.             <value>/WEB-INF/views/</value>  
17.         </property>  
18.         <property name="suffix">  
19.             <value>.jsp</value>  
20.         </property>  
21.     </bean>  
22.    
23. </beans>  

spring 配置详解：

<mvc:annotation-driven /> 意思是说我们可以不在xml中声明该bean，

或者实现一个借口或者继承一个bean类或者其他类的情况下定义bean的依赖。

例如仅仅在类上加上一个  @Controller注解（我们上面的控制器类就是这么用的），这样就不需要再在xml中

配置bean，spring就会知道我们带了此注解的类包含响应http请求的处理器。

<context:component-scan base-package="com.websystique.springmvc" />意思是说

spring 自动扫描此包下面的组件 base-package [com.websystique.springmvc]，

看看它们有没有带 [@Controller, @Service,@Repository, @Component, 等等]这些注解。

如果有这些注解spring将自动的将它们在bean 工厂里面注册，和在xml中配置bean效果是一样的。

通过上面我们声明了一个view resolver，帮助控制器（controller）代理响应到正确的视图(view).







 

第4步: 配置(web.xml) 文件

[html] view plain copy

1. <web-app id="WebApp_ID" version="2.4"  
2.     xmlns="http://java.sun.com/xml/ns/j2ee"  
3.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
4.     xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee  
5.    
6. http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">  
7.    
8.  <display-name>Spring4MVCHelloWorldDemo Web Application</display-name>  
9.    
10.  <servlet>  
11.     <servlet-name>dispatcher</servlet-name>  
12.     <servlet-class>  
13.         org.springframework.web.servlet.DispatcherServlet  
14.     </servlet-class>  
15.     <init-param>  
16.         <param-name>contextConfigLocation</param-name>  
17.         <param-value>/WEB-INF/spring-servlet.xml</param-value>  
18.     </init-param>  
19.     <load-on-startup>1</load-on-startup>  
20.  </servlet>  
21.    
22.  <servlet-mapping>  
23.     <servlet-name>dispatcher</servlet-name>  
24.     <url-pattern>/</url-pattern>  
25.  </servlet-mapping>  
26.    
27. </web-app>  

配合主要从 DispatcherServlet & contextConfigLocation.DispatcherServlet 这个是前置控制器，来接收每个请求(看url pattern) 然后引导请求到对应的控制器（controller）.同时也负责引导controller中的响应到对应的是视图。

仔细看看 contextConfigLocation的 init-param. 多亏了这个参数，你可以在项目的任何位置存放配置文件也可以随意命名，而且你甚至都可以配置多个配置文件。 In absence of this parameter, you are obliged to name the file as ABC-servlet.xml where ABC is the dispatcher servlet name.

如果没有这个参数，你就不得不以ABC-servlet.xml 形式命名此配置文件，这里的ABC就是你的 dispatcher servlet name。

你将得到下面的项目文件结构:

第6步:部署 &运行你的应用

project ->Run as-> maven  install 如下

【译者建议直接run as - run on server 选择tomcat 运行即可】

然后你将看到多了一个war文件

将其放到tomcat webapp目录下 运行tomcat即可。

为了快速起见, 我用eclipse 的jetty插件run-jetty-run 在 jetty中跑此项目.

邮件此war->run as->run-jetty.

打开浏览器

JSP页面顶端出现“红色”的报错参见：http://blog.csdn.NET/w605283073/article/details/52221592

本文结束。下一篇文章 将讲述  Sping 4 MVC 完全基于注解的hello world教程。