从零开始学JAVA(07)-使用SpringMVC4写helloworld

一、关于开发环境

1. Eclipse IDE for Java EE Developers
2. Jdk 1.7 (32位版本)
3. SpringMVC 4.1.5.RELEASE
4. apache-tomcat-7.0.53

• Eclipse：官网(http://www.eclipse.org/downloads/)。使用Eclipse IDE for Java EE Developers版本更合适，自行下载安装。
• JDK，官网(http://www.oracle.com/technetwork/java/javase/downloads/index-jsp-138363.html#javasejdk)。
• SpringMVC4，官网(http://maven.springframework.org/release/org/springframework/spring/4.1.5.RELEASE/)，实际上http://maven.springframework.org/release/org/springframework/ 这个地址可以下载spring的很多东西。
• Tomcat，官网(http://tomcat.apache.org/download-70.cgi)

二、关于开发文档

1. 官方好多文档，但都是英文的。所以多学点英语，有好处。
2. 俺英语不好，不说了，一直百度。

三、写在前面

调试时，请使用Tomcat来运行代码，使用自带的J2EE Preview将出现很多问题（困扰了我很长时间才发现的，原因不明，未解决），错误如下

2015-03-17 11:18:20.372:INFO:oejs.Server:jetty-8.1.14.v20131031
2015-03-17 11:18:21.006:WARN:oejw.StandardDescriptorProcessor:Could not instantiate listener org.springframework.web.context.ContextLoaderListener
java.lang.ClassNotFoundException: org.springframework.web.context.ContextLoaderListener
    at java.net.URLClassLoader$1.run(URLClassLoader.java:366)
    at java.net.URLClassLoader$1.run(URLClassLoader.java:355)
    at java.security.AccessController.doPrivileged(Native Method)

以上说是没找到类，所以我把spring的jar加到classpath后，解决了这个问题，但又出现以下错误提示

2015-03-17 11:21:44.450:INFO:oejs.Server:jetty-8.1.14.v20131031
2015-03-17 11:21:45.128:INFO:/hello1:Initializing Spring root WebApplicationContext
三月 17, 2015 11:21:45 上午 org.springframework.web.context.ContextLoader initWebApplicationContext
信息: Root WebApplicationContext: initialization started
三月 17, 2015 11:21:45 上午 org.springframework.context.support.AbstractApplicationContext prepareRefresh
信息: Refreshing Root WebApplicationContext: startup date [Tue Mar 17 11:21:45 CST 2015]; root of context hierarchy
三月 17, 2015 11:21:45 上午 org.springframework.beans.factory.xml.XmlBeanDefinitionReader loadBeanDefinitions
信息: Loading XML bean definitions from ServletContext resource [/WEB-INF/dispatcher-servlet.xml]
三月 17, 2015 11:21:45 上午 org.springframework.web.context.ContextLoader initWebApplicationContext
严重: Context initialization failed
org.springframework.beans.factory.BeanDefinitionStoreException: Unexpected exception parsing XML document from ServletContext resource [/WEB-INF/dispatcher-servlet.xml]; nested exception is org.springframework.beans.FatalBeanException: Class [org.springframework.context.config.ContextNamespaceHandler] for namespace [http://www.springframework.org/schema/context] does not implement the [org.springframework.beans.factory.xml.NamespaceHandler] interface
    at org.springframework.beans.factory.xml.XmlBeanDefinitionReader.doLoadBeanDefinitions(XmlBeanDefinitionReader.java:414)
    at org.springframework.beans.factory.xml.XmlBeanDefinitionReader.loadBeanDefinitions(XmlBeanDefinitionReader.java:336)
    at org.springframework.beans.factory.xml.XmlBeanDefinitionReader.loadBeanDefinitions(XmlBeanDefinitionReader.java:304)
    at org.springframework.beans.factory.support.AbstractBeanDefinitionReader.loadBeanDefinitions(AbstractBeanDefinitionReader.java:181)
    at org.springframework.beans.factory.support.AbstractBeanDefinitionReader.loadBeanDefinitions(AbstractBeanDefinitionReader.java:217)
    at org.springframework.beans.factory.support.AbstractBeanDefinitionReader.loadBeanDefinitions(AbstractBeanDefinitionReader.java:188)
    at org.springframework.web.context.support.XmlWebApplicationContext.loadBeanDefinitions(XmlWebApplicationContext.java:125)
    at org.springframework.web.context.support.XmlWebApplicationContext.loadBeanDefinitions(XmlWebApplicationContext.java:94)

org.springframework.beans.factory.BeanDefinitionStoreException: Unexpected exception parsing XML document from ServletContext resource [/WEB-INF/dispatcher-servlet.xml]; nested exception is org.springframework.beans.FatalBeanException: Class [org.springframework.context.config.ContextNamespaceHandler] for namespace [http://www.springframework.org/schema/context] does not implement the [org.springframework.beans.factory.xml.NamespaceHandler] interface

 这个错误百度了很多方法，但都不能解决。排除了代码的问题，最后发现使用tomcat运行程序时是正常的。

四、步骤

1. 新建一个动态网页工程，File-New-Dynamic Web Project，如下图:
   
2. 在弹出的窗口中，输入工程名hellomvc，并选择一个位置存置项目中的文件，如下图配置后，点Finish创建工程文件，Eclipse会自动帮忙生成相关的文件夹
   
3. 将Spring MVC相关的包(另外需要从http://commons.apache.org/proper/commons-logging/download_logging.cgi下载commons-logging-1.2.jar)拷贝到WebContent\WEB-INF\lib中，并按F5刷新列表，或在工程名hellomvc上右键点Refresh。
   
4. 新建一个包com.web.controller，在src文件夹上右键，new-package，包名为com.web.controller
   
5. 新建一个类helloController放在包com.web.controller中。这是mvc中的c，当访问网址时，spring mvc将先解析网址后转到这里执行相应的controller
   

   package com.web.controller;
   
   import org.springframework.stereotype.Controller;
   import org.springframework.ui.Model;
   import org.springframework.web.bind.annotation.RequestMapping;
   import org.springframework.web.bind.annotation.RequestParam;
   
   @Controller
   public class helloController {
       @RequestMapping("/hello")
       public String hello(@RequestParam(value = "name", required = false, defaultValue = "World") String name,
                   Model model) {
               model.addAttribute("name", name);
               return "helloworld"; // 通过这里跳转到helloworld.jsp
       }
   }

6. 新建一个WEB-INF下新建一个views文件夹，用于存储jsp网页。并将新建一个helloworld.jsp放在views中

   <%@ page language="java" contentType="text/html; charset=utf-8" pageEncoding="utf-8"%>
   <!doctype html>
   <html lang="en">
   <head>
       <meta charset="UTF-8">
       <title>Spring MVC Tutorial</title>
   </head>
   <body>
       <h1>Hello ${name}</h1>
   </body>
   </html>

7. 编辑web.xml，因为程序启动是从这个配置开始的，我们需要让默认的配置转向springmvc的配置

   <?xml version="1.0" encoding="UTF-8"?>
   <web-app id="WebApp_ID" version="2.5"
       xmlns="http://java.sun.com/xml/ns/javaee"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
       http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
    
       <display-name>Spring MVC 测试</display-name>
    
       <servlet>
           <servlet-name>mydispatcher</servlet-name>
           <servlet-class>
               org.springframework.web.servlet.DispatcherServlet
           </servlet-class>
           <load-on-startup>1</load-on-startup>
       </servlet>
    
       <servlet-mapping>
           <servlet-name>mydispatcher</servlet-name>
           <url-pattern>/</url-pattern>
       </servlet-mapping>
    
       <context-param>
           <param-name>contextConfigLocation</param-name>
           <param-value>/WEB-INF/mydispatcher-servlet.xml</param-value>
       </context-param>
    
       <listener>    
           <listener-class>
               org.springframework.web.context.ContextLoaderListener
           </listener-class>
       </listener>
   </web-app>

   这里我们创建的servlet名为mydispatcher，记得springmvc的配置必须一致，格式为[servlet名称]-servlet.xml；这里我的配置名为mydispatcher-servlet.xml

8. 新建一个mydispatcher-servlet.xml放在WEB-INF中，因为在web.xml中配置了在这个路径。这是springmvc的配置。

   <?xml version="1.0" encoding="UTF-8"?>
   <beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       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-4.0.xsd
           http://www.springframework.org/schema/mvc
           http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd
           http://www.springframework.org/schema/context
           http://www.springframework.org/schema/context/spring-context-4.0.xsd">
    
       <context:component-scan base-package="com.web.controller" />
       <bean
           class="org.springframework.web.servlet.view.InternalResourceViewResolver">
           <property name="prefix">
               <value>/WEB-INF/views/</value>
           </property>
           <property name="suffix">
               <value>.jsp</value>
           </property>
       </bean>
   </beans>

   其中<context:component-scan base-package="com.web.controller" />就表示让springmvc扫描包com.web.controller所有相关的controller，我们新建的helloController.java就是此类东西。<value>/WEB-INF/views/</value>是让controller在views文件夹找相关的文件，这里与上面的第5点相关联。

五、调试运行

1. 第一次运行时，点击运行按钮，选择 Run on Server
   
2. 在弹出来的窗口中选择Tomcat v7.0 Server，并勾选下方的Always use this server when running this project，这样eclipse会自动帮你建立tomcat的配置文件。
   
3. 点finish运行，在ie中输入http://127.0.0.1:8080/hellomvc/hello或http://127.0.0.1:8080/hellomvc/hello?name=lin557，效果如下
   
4. 配置tomcat后出现HttpServlet was not found on the Java错误时，可以参考http://jingyan.baidu.com/article/f79b7cb34f40569144023ef9.html进行处理。
5. 目录结构