【转】spring3 MVC实战,手工搭建Spring3项目demo

时间:2023-12-11 11:27:02

更新:这几天对spring3的理解又进了一步,今天抽空把这篇文章中的错误和不当之处做了修改。

最近的项目在用Spring3,涉及到了基于注解的MVC,事务管理,与hibernate的整合开发等内容,我打算写一个系列出来,记录下这个痛苦但又充满成就感的过程----网上实在太难找能让新手快速理解掌握的文章了

这篇文章专门针对使用Spring3进行开发的新手,高手就请绕道吧,也欢迎拍个砖再走...

我打算从这几个方面写:1.开发环境确认    2.Spring3的jar包    3.Spring3项目配置    4.其他

一、开发环境确认

    1.工具及版本

jdk我用的是1.6的;jdk的下载安装和配置就不讲了,如果这个还搞不定还谈什么spring啊

myeclipse用的是6.0(实在太落后啦,还是8.X舒服)不过这里是手工搭建不使用自动生成工具,所以版本无所谓的;使用eclipse for     javaEE也ok,不过跟myeclipse可能在项目目录上会有少许的不同,eclipse的web跟目录是WebContent,而myeclipse通常是WebRoot

tomcat是6的,666,大顺哈【转】spring3 MVC实战,手工搭建Spring3项目demo

2.确认

为了保证开发环境正常请做一下确认,在运行里输入cmd打开命令行,输入java -version命令,显示类似如下内容:

java version "1.6.0_23"
    Java(TM) SE Runtime Environment (build 1.6.0_23-b05)
    Java HotSpot(TM) Client VM (build 19.0-b09, mixed mode, sharing)

然后,启动tomcat6,请确认控制台没有报错信息,控制台输出类似如下:

2011-1-19 14:58:27 org.apache.coyote.http11.Http11Protocol init
信息: Initializing Coyote HTTP/1.1 on http-8080
2011-1-19 14:58:27 org.apache.catalina.startup.Catalina load
信息: Initialization processed in 255 ms
2011-1-19 14:58:27 org.apache.catalina.core.StandardService start
信息: Starting service Catalina
2011-1-19 14:58:28 org.apache.catalina.core.StandardEngine start
信息: Starting Servlet Engine: Apache Tomcat/6.0.20
2011-1-19 14:58:29 org.apache.coyote.http11.Http11Protocol start
信息: Starting Coyote HTTP/1.1 on http-8080
2011-1-19 14:58:29 org.apache.jk.common.ChannelSocket init
信息: JK: ajp13 listening on /0.0.0.0:8009
2011-1-19 14:58:29 org.apache.jk.server.JkMain start
信息: Jk running ID=0 time=0/15  config=null
2011-1-19 14:58:29 org.apache.catalina.startup.Catalina start
信息: Server startup in 1401 ms

确认myeclipse或eclipse下server视图下有你的tomcat6且可以正常启动关闭,如果没有自行配置,如果不知道自己网上搜

确认你的myeclipse或eclipse下的java平台是刚才确认过的jdk1.6

这一部分最后一步,新建一个webProject,如果你用的是是eclipse for javaEE那么项目类型选择Static web project

注意,eclipse新建web项目需要选择target runtime,如果没有就配上你的tomcat6,myeclipse新建项目j2EE Specification Level项要选择javaEE5.0

 二、Spring3的jar包

   1.下载Spring3

先到官网现在吧,上网址:http://www.springsource.org/download 现在最新版本是3.0.5,看图,点圈住区域的链接

【转】spring3 MVC实战,手工搭建Spring3项目demo

现在点击之后需要注册用户才能下载,那就注册一下吧,spring这么伟大的开源项目,能不支持吗?当然你也可以选择下图所示的链接跳过【转】spring3 MVC实战,手工搭建Spring3项目demo
之后跳转到文件下载选择页面,需要下载两个文件:

spring-framework-3.0.5.RELEASE-with-docs.zip  和   spring-framework-3.0.5.RELEASE-dependencies.zip

但是现在官方已经没有了 spring-framework-3.0.5.RELEASE-dependencies.zip的下载链接(这些依赖我们都可以分别到各自相关的开源项目下载),不知为何,你可以分别网上搜

spring-framework-3.0.5.RELEASE-with-docs.zip  解压后目录结构如下:

【转】spring3 MVC实战,手工搭建Spring3项目demo
dependency的目录结构基本上全是以com.XX org.XX为名字的目录,太长了就不截图了。

下面就是导入了,导入前先说明白两点:

1. spring3开始jar包不再包含全能的spring.jar了,而是分成20多个jar包了,配置可以按需引入了

2. 项目中使用spring除了引入dist目录下的jar包,还需要dependencies下的一些依赖包,下面再具体说。

2.引入dist目录下除了下面三个其余所有包

org.springframework.web.struts-3.0.5.RELEASE.jar

org.springframework.spring-library-3.0.5.RELEASE.libd

org.springframework.web.portlet-3.0.5.RELEASE.jar

如何引入jar包,对项目鼠标右键选择【Build Path】,选择【Add Extenal Archives】,浏览到jar包的位置,打开即可

3.接下来,还必须导入日志相关的一个jar包---commons logging和一个名为com.springsource.org.aopalliance-1.0.0.jar的jar包

分别在spring-framework-3.0.5.RELEASE-dependencies\org.apache.commons\com.springsource.org.apache.commons.logging\1.1.1

及spring-framework-3.0.5.RELEASE-dependencies\org.aopalliance\com.springsource.org.aopalliance\1.0.0下

目录下。如果不引入部署项目tomcat会报如下错误:严重: Exception sending context initialized event to listener instance of class org.springframework.web.context.ContextLoaderListener
java.lang.NoClassDefFoundError: org/apache/commons/logging/LogFactory

三、spring3配置

1.web.xml配置

web.xml内容如下:

<?xml version="1.0" encoding="UTF-8"?>
<web-app 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">
 <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/spring-servlet.xml</param-value>
  </context-param>
 <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
 </listener>
 <!-- 对像js,css,gif等静态文件的访问,需要映射到默认的servlet -->

<!-- 这里省去对静态资源url的配置,当然这样的话tomcat控制台就会报警告了,对html的请求、页面中的图片及css效果也是无法访问的

不过我们这是搭基本环境嘛,就先不要图片吧,如果想解决这个问题,可以看我另外一篇文章
 -->
 <!-- 配置spring核心servlet -->
 <servlet>
  <servlet-name>spring</servlet-name>
  <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  <load-on-startup>1</load-on-startup>
 </servlet>
 <servlet-mapping>
  <servlet-name>spring</servlet-name>
  <url-pattern>/</url-pattern>
  <!-- url配置为/,不带文件后缀,会造成其它静态文件(js,css等)不能访问。如配为*.do,则不影响静态文件的访问 -->
 </servlet-mapping>

</web-app>

2.Spring应用上下文配置,在web.xml中我们配置了spring的servlet -----<servlet-name>spring</servlet-name>

web.xml里有这一段

<context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/spring-servlet.xml</param-value>
    </context-param>

用于开启基于注解的springMVC功能那么我们需要在跟web.xml同一目录下新建一个spring-servlet.xml文件,内容为:

<beans xmlns="http://www.springframework.org/schema/beans"
 xmlns:context="http://www.springframework.org/schema/context"
 xmlns:p="http://www.springframework.org/schema/p"
 xmlns:mvc="http://www.springframework.org/schema/mvc"
 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.xsd
      http://www.springframework.org/schema/mvc
      http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd">
     <!-- 启动注解驱动的Spring MVC功能,注册请求url和注解POJO类方法的映射-->
     <mvc:annotation-driven />

<!-- 启动包扫描功能,以便注册带有@Controller、@Service、@repository、@Component等注解的类成为spring的bean -->
     <context:component-scan base-package="com.mvc.rest" />

<!-- 对模型视图名称的解析,在请求时模型视图名称添加前后缀 -->
     <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" p:prefix="/WEB-INF/view/" p:suffix=".jsp" />
</beans>

配置是不是很清爽?多亏spring3增加的mvc、context、tx等几个命名空间了

四、其他

1.建包

新建一个包,包名就是我们Spring-mvc.xml里 <context:component-scan base-package="com.mvc.rest"></context:component-scan> 
里的com.mvc.rest

2.建立Constroller

在com.mvc.rest包下新建一个java类,代码如下:

package com.mvc.rest;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.springframework.stereotype.Controller;
import org.springframework.ui.ModelMap;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.servlet.ModelAndView;

@Controller
public class RestConstroller {
 
 public RestConstroller() {
 }
 
 @RequestMapping(value = "/login/{user}", method = RequestMethod.GET)
 public ModelAndView myMethod(HttpServletRequest request,
   HttpServletResponse response, @PathVariable("user")
   String user, ModelMap modelMap) throws Exception {
  
  modelMap.put("loginUser", user);
  return new ModelAndView("/login/hello", modelMap);
 }

@RequestMapping(value = "/welcome", method = RequestMethod.GET)
 public String registPost() {
  return "/welcome";
 }
}

3.建视图

正如spring-servlet.xml里

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" p:prefix="/WEB-INF/view/" p:suffix=".jsp" />所配置的视图路径,我们需要在WEB-INF下建立view目录,在view下建立jsp文件;

正如RestConstroller里两个方法的返回语句:return new ModelAndView("/login/hello", modelMap);和return "/welcome";所约定,我们需要在view下建立相应的login目录并在其下建立hello.jsp,在/WEB-INF/view下建立welcome.jsp
hello.jsp内容如下:

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%
String path = request.getContextPath();
String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/";
%>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <base href="<%=basePath%>">
   
    <title>My JSP 'hello.jsp' starting page</title>
   
 <meta http-equiv="pragma" content="no-cache">
 <meta http-equiv="cache-control" content="no-cache">

</head>
 
  <body>
    你好:<%=request.getAttribute("loginUser") %>,现在时间是<%= new Date() %>
  </body>
</html>

welcome.jsp就随意吧,测试嘛.

4.部署访问

在myeclipse下部署项目并运行

打开浏览地址栏输入:http://localhost:8080/sandDemo001/login/heamer 这里的heamer是自定义的,作为请求参数解析

输入:http://localhost:8080/sandDemo001/welcome  则显示你welcome.jsp应该显示的内容。

整个过程已经完成,需要注意的有几方面,1.环境一定要是可用的  2.jar包正确的引入到项目中   3.配置文件要小心修改,不要犯括号不配对类似的低级错误

关于Constroller里的注解的用法这里暂不做讲解,以后有时间再发文;搭建配置过程已经亲测,如有谬误敬请指正。