从零开始学JAVA(07)-使用SpringMVC4写helloworld
一、关于开发环境
- Eclipse IDE for Java EE Developers
- Jdk 1.7 (32位版本)
- SpringMVC 4.1.5.RELEASE
- 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)
二、关于开发文档
- 官方好多文档,但都是英文的。所以多学点英语,有好处。
- 俺英语不好,不说了,一直百度。
三、写在前面
调试时,请使用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运行程序时是正常的。
四、步骤
- 新建一个动态网页工程,File-New-Dynamic Web Project,如下图:
- 在弹出的窗口中,输入工程名hellomvc,并选择一个位置存置项目中的文件,如下图配置后,点Finish创建工程文件,Eclipse会自动帮忙生成相关的文件夹
- 将Spring MVC相关的包(另外需要从http://commons.apache.org/proper/commons-logging/download_logging.cgi下载commons-logging-1.2.jar)拷贝到WebContent\WEB-INF\lib中,并按F5刷新列表,或在工程名hellomvc上右键点Refresh。
- 新建一个包com.web.controller,在src文件夹上右键,new-package,包名为com.web.controller
- 新建一个类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 } }
- 新建一个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>
- 编辑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
- 新建一个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点相关联。
五、调试运行
- 第一次运行时,点击运行按钮,选择 Run on Server
- 在弹出来的窗口中选择Tomcat v7.0 Server,并勾选下方的Always use this server when running this project,这样eclipse会自动帮你建立tomcat的配置文件。
- 点finish运行,在ie中输入http://127.0.0.1:8080/hellomvc/hello或http://127.0.0.1:8080/hellomvc/hello?name=lin557,效果如下
- 配置tomcat后出现HttpServlet was not found on the Java错误时,可以参考http://jingyan.baidu.com/article/f79b7cb34f40569144023ef9.html进行处理。
- 目录结构