Spring + Eclipse实现HelloWorld程序

初学Spring，就跟学习其他编程语言一样，当然要从最简单的hello world程序开始写起，毕竟我们小白的目标是熟练编写各版本的hello world！

创建web工程

Step 1: 新建动态网站工程 File->New->Dynamic Web Project

可能出现的问题：找不到Dynamic Web Project选项。
原因：Dynamic Web Project 属于J2EE技术，需要下载安装J2EE插件。
解决办法：
Help->Install New Software->Add

在弹出的对话框中输入上述内容，Name框随意输入一个名字，Location框输入上图中的地址。稍等片刻后勾选图中所示选项，完成安装。

Step 2: 为工程添加Spring的jar包支持

创建完成的项目的目录结构如下图所示：

因为我们这里创建的是最简单的hello world程序，所以需要关注的文件夹只有java Resources和WebContent两个。顾名思义，java Resources文件夹存放的是java源代码和运行时的库文件等，WebContent文件夹存放的是所有与网站相关的运行时的库文件，显示时用的页面文件等。经测试过可以保证程序成功运行起来的jar包列表如下：

大家可以从网络上下载相应的jar包，这些包可以理解成运行spring的基础支持库。
下面说明如何导入包
直接复制所有的jar包，然后在eclipse中的项目目录下面的WEB-INF目录下的lib目录上点击右键，选择粘贴即可。执行完成后的WebContent目录结构如下图所示：

Step 3: 添加关键配置文件及java文件和jsp文件

右键点击WEB-INF文件夹->New->Other…->XML->XML File。
新建两个xml文件，其中 web.xml文件是必须的，且必须命名为web.xml，注意大小写！，另外一个配置文件HelloWorld-servlet.xml可以任意取名，但前缀HelloWorld必须与web.xml文件中servlet-name标签里的名字一致（参见下文web.xml文件的内容）！

配置文件添加完成后还要添加用于页面显示的jsp文件，右键点击WEB-INF文件夹->New->Floder。命名为jsp，用来存放jsp文件。右键点击刚新建的jsp文件夹->New->JSP File，命名为hello.jsp（可以随意命名，但要与java文件中的返回值内容对应，参见下文MyHelloController.java文件的内容）。

创建完成后的WebContent文件夹目录结构如下所示：

处理完WebContent文件夹，接下来要为java Resources文件夹添加java文件了。右键点击java Resources文件夹下的src文件夹->New->Package，创建一个包命名为testHello（包名任取，但要与HelloWorld-servlet.xml文件中的context:component-scan标签里的路径一致，参见下文HelloWorld-servlet.xml文件中的内容）。然后右键点击testHello->New->Class，创建一个java文件命名为MyHelloController.java（类名任取）。

创建完成后的java Resources文件夹目录结构如下图所示：

Step 4: 为第三步中的文件添加代码

web.xml

<?xml version="1.0" encoding="UTF-8"?><web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"         xmlns="http://java.sun.com/xml/ns/javaee"         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"         id="WebApp_ID" version="2.5">   <!-- 配置 DispatcherServlet -->   <servlet>      <!-- 设置servlet的名字，名字任取为XX, 但是lib下的配置文件一定要与之对应命名为XX-servlet.xml -->      <servlet-name>HelloWorld</servlet-name>      <!-- 配置servlet的种类，一定是下面所示的DispatcherServlet种类-->      <servlet-class>        org.springframework.web.servlet.DispatcherServlet      </servlet-class>      <load-on-startup>1</load-on-startup>   </servlet>   <!-- servlet映射，将根目录"/"下的所有请求映射到分发器（DispatcherServlet）HelloWorld处理-->   <servlet-mapping>      <servlet-name>HelloWorld</servlet-name>      <url-pattern>/</url-pattern>   </servlet-mapping></web-app>

HelloWorld-servlet.xml

<?xml version="1.0" encoding="UTF-8"?><beans xmlns="http://www.springframework.org/schema/beans"   xmlns:context="http://www.springframework.org/schema/context"   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"   xsi:schemaLocation="   http://www.springframework.org/schema/beans        http://www.springframework.org/schema/beans/spring-beans-3.0.xsd   http://www.springframework.org/schema/context    http://www.springframework.org/schema/context/spring-context-3.0.xsd">   <!-- HelloWorld-servlet的配置 -->   <!-- 指定扫描目录，当请求分发到HelloWorld-servlet时从下面标签指定的目录开始扫描java文件并执行-->   <!-- 这里指定的包是我们在java Resources文件夹下的src文件夹下新建的包testHello -->   <context:component-scan base-package="testHello" />   <!-- 指定用来在浏览器中显示的文件路径和文件类型-->   <!-- 这里我们指定的显示用的文件是/WEB-INF/jsp文件夹下的.jsp文件-->   <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">      <property name="prefix" value="/WEB-INF/jsp/" />      <property name="suffix" value=".jsp" />   </bean></beans>

MyHelloController.java

package testHello;import org.springframework.stereotype.Controller;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RequestMethod;import org.springframework.ui.ModelMap;@Controller/*对浏览器中输入的地址url中的requestHello字段进行映射行*/@RequestMapping("/requestHello")public class MyHelloController {    /*对requestHello进行处理，返回字符串hello      这个hello对应WEB-INF/jsp/hello.jsp文件      其中前缀WEB-INF/jsp和后缀.jsp都在分发器配置文件Hello-World-servlet.xml中配置好了。*/    @RequestMapping(method = RequestMethod.GET)    public String printHello(ModelMap model) {        model.addAttribute("message", "Hello Spring MVC Framework!");        return "hello";   }}

hello.jsp

<%@ page contentType="text/html; charset=UTF-8" %><html><head><title>Hello World</title></head><body>   <%-- 在MyHelloController.java文件中返回hello字符串之后跳转到本hello.jsp文件   hello.jsp文件在浏览器中显示的内容是写入到message模型中的字符串Hello Spring MVC Framework! --%>   <h2>${message}</h2></body></html>

运行结果
配置好tomcat服务器（具体教程网络查找），右键点击工程->run as->run on Server，在浏览器地址栏中输入如下图所示地址，运行结果如下图所示：

至此，一个最简单的HelloWorld程序编写完毕。

总结

1. 整个流程我们需要编写的文件只有四个：
   web.xml 配置整个web，指定服务的servlet；
   HelloWorld-servlet.xml 配置servlet，指定接收到请求后扫寻java文件的路径和用于浏览器页面显示的文件的路径及类型；
   MyHelloController.java 控制文件，映射url请求，指定接收到请求后执行的操作，并将操作结果映射到相应的jsp文件；
   hello.jsp 设计操作结果在页面上显示的格式；

   请求到达后的处理流程web.xml -> HelloWorld-servlet.xml -> MyHelloController.java -> hello.jsp 。

2. 对jar包的依赖需要我们事先解决好，办法就是将jar包复制到WebContent/WEB-INF/lib文件夹下，这些包在我们项目发布的时候将随项目一起发布。

3. xml文件的头部内容基本相同，因此编写xml文件时头部内容可以直接从已经确保正确的其他xml文件中复制粘贴。