Spring MVC 框架搭建配置方法及详解

现在主流的web mvc框架除了struts这个主力 外，其次就是spring mvc了，因此这也是作为一名程序员需要掌握的主流框架，框架选择多了，应对多变的需求和业务时，可实行的方案自然就多了。不过要想灵活运用spring mvc来应对大多数的web开发，就必须要掌握它的配置及原理。

一、spring mvc环境搭建：（spring 2.5.6 + hibernate 3.2.0）

1. jar包引入

　　spring 2.5.6：spring.jar、spring-webmvc.jar、commons-logging.jar、cglib-nodep-2.1_3.jar

　　hibernate 3.6.8：hibernate3.jar、hibernate-jpa-2.0-api-1.0.1.final.jar、antlr-2.7.6.jar、commons-collections-3.1、dom4j-1.6.1.jar、javassist-3.12.0.ga.jar、jta-1.1.jar、slf4j-api-1.6.1.jar、slf4j-nop-1.6.4.jar、相应数据库的驱动jar包

2. web.xml配置（部分）

<!-- spring mvc配置 -->
<!-- ====================================== -->
<servlet> 
  <servlet-name>spring</servlet-name> 
  <servlet-class>org.springframework.web.servlet.dispatcherservlet</servlet-class> 
  <!-- 可以自定义servlet.xml配置文件的位置和名称，默认为web-inf目录下，名称为[<servlet-name>]-servlet.xml，如spring-servlet.xml 
  <init-param> 
    <param-name>contextconfiglocation</param-name> 
    <param-value>/web-inf/spring-servlet.xml</param-value> 默认 
  </init-param> 
  -->
  <load-on-startup>1</load-on-startup> 
</servlet> 
 
<servlet-mapping> 
  <servlet-name>spring</servlet-name> 
  <url-pattern>*.do</url-pattern> 
</servlet-mapping> 
  
 
 
<!-- spring配置 -->
<!-- ====================================== -->
<listener> 
  <listener-class>org.springframework.web.context.contextloaderlistener</listener-class> 
</listener> 
  
 
<!-- 指定spring bean的配置文件所在目录。默认配置在web-inf目录下 -->
<context-param> 
  <param-name>contextconfiglocation</param-name> 
  <param-value>classpath:config/applicationcontext.xml</param-value> 
</context-param>

3. spring-servlet.xml配置

　　spring-servlet这个名字是因为上面web.xml中<servlet-name>标签配的值为spring（<servlet-name>spring</servlet-name>），再加上“-servlet”后缀而形成的spring-servlet.xml文件名，如果改为springmvc，对应的文件名则为springmvc-servlet.xml。

<?xml version="1.0" encoding="utf-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans"   
    xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:p="http://www.springframework.org/schema/p"   
    xmlns:context="http://www.springframework.org/schema/context"   
  xsi:schemalocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd  
    http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.0.xsd  
    http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.0.xsd  
    http://www.springframework.org/schema/context <a href="http://www.springframework.org/schema/context/spring-context-3.0.xsd">http://www.springframework.org/schema/context/spring-context-3.0.xsd</a>"> 
 
  <!-- 启用spring mvc 注解 -->
  <context:annotation-config /> 
 
  <!-- 设置使用注解的类所在的jar包 -->
  <context:component-scan base-package="controller"></context:component-scan> 
 
  <!-- 完成请求和注解pojo的映射 -->
  <bean class="org.springframework.web.servlet.mvc.annotation.annotationmethodhandleradapter" /> 
 
  <!-- 对转向页面的路径解析。prefix：前缀， suffix：后缀 -->
  <bean class="org.springframework.web.servlet.view.internalresourceviewresolver" p:prefix="/jsp/" p:suffix=".jsp" /> 
</beans>

4. applicationcontext.xml配置

<?xml version="1.0" encoding="utf-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"
    xmlns:aop="http://www.springframework.org/schema/aop"
    xmlns:tx="http://www.springframework.org/schema/tx"
    xsi:schemalocation=" 
      http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd 
      http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-2.5.xsd 
      http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-2.5.xsd"> 
 
  <!-- 采用hibernate.cfg.xml方式配置数据源 -->
  <bean id="sessionfactory" class="org.springframework.orm.hibernate3.localsessionfactorybean"> 
    <property name="configlocation"> 
      <value>classpath:config/hibernate.cfg.xml</value> 
    </property> 
  </bean> 
   
  <!-- 将事务与hibernate关联 -->
  <bean id="transactionmanager" class="org.springframework.orm.hibernate3.hibernatetransactionmanager"> 
    <property name="sessionfactory"> 
      <ref local="sessionfactory"/> 
    </property> 
  </bean> 
   
  <!-- 事务（注解 ）-->
  <tx:annotation-driven transaction-manager="transactionmanager" proxy-target-class="true"/> 
 
  <!-- 测试service -->
  <bean id="loginservice" class="service.loginservice"></bean> 
 
  <!-- 测试dao -->
  <bean id="hibernatedao" class="dao.hibernatedao"> 
    <property name="sessionfactory" ref="sessionfactory"></property> 
  </bean> 
</beans>

二、详解

　　spring mvc与struts从原理上很相似（都是基于mvc架构），都有一个控制页面请求的servlet，处理完后跳转页面。看如下代码（注解）：

package controller; 
 
import javax.servlet.http.httpservletrequest; 
 
import org.springframework.stereotype.controller; 
import org.springframework.web.bind.annotation.requestmapping; 
import org.springframework.web.bind.annotation.requestparam; 
 
import entity.user; 
 
@controller //类似struts的action 
public class testcontroller { 
 
  @requestmapping("test/login.do") // 请求url地址映射，类似struts的action-mapping 
  public string testlogin(@requestparam(value="username")string username, string password, httpservletrequest request) { 
    // @requestparam是指请求url地址映射中必须含有的参数(除非属性required=false) 
    // @requestparam可简写为：@requestparam("username") 
 
    if (!"admin".equals(username) || !"admin".equals(password)) { 
      return "loginerror"; // 跳转页面路径（默认为转发），该路径不需要包含spring-servlet配置文件中配置的前缀和后缀 
    } 
    return "loginsuccess"; 
  } 
 
  @requestmapping("/test/login2.do") 
  public modelandview testlogin2(string username, string password, int age){ 
    // request和response不必非要出现在方法中，如果用不上的话可以去掉 
    // 参数的名称是与页面控件的name相匹配，参数类型会自动被转换 
     
    if (!"admin".equals(username) || !"admin".equals(password) || age < 5) { 
      return new modelandview("loginerror"); // 手动实例化modelandview完成跳转页面（转发），效果等同于上面的方法返回字符串 
    } 
    return new modelandview(new redirectview("../index.jsp")); // 采用重定向方式跳转页面 
    // 重定向还有一种简单写法 
    // return new modelandview("redirect:../index.jsp"); 
  } 
 
  @requestmapping("/test/login3.do") 
  public modelandview testlogin3(user user) { 
    // 同样支持参数为表单对象，类似于struts的actionform，user不需要任何配置，直接写即可 
    string username = user.getusername(); 
    string password = user.getpassword(); 
    int age = user.getage(); 
     
    if (!"admin".equals(username) || !"admin".equals(password) || age < 5) { 
      return new modelandview("loginerror"); 
    } 
    return new modelandview("loginsuccess"); 
  } 
 
  @resource(name = "loginservice") // 获取applicationcontext.xml中bean的id为loginservice的，并注入 
  private loginservice loginservice; //等价于spring传统注入方式写get和set方法，这样的好处是简洁工整，省去了不必要得代码 
 
  @requestmapping("/test/login4.do") 
  public string testlogin4(user user) { 
    if (loginservice.login(user) == false) { 
      return "loginerror"; 
    } 
    return "loginsuccess"; 
  } 
}

以上4个方法示例，是一个controller里含有不同的请求url，也可以采用一个url访问，通过url参数来区分访问不同的方法，代码如下：

package controller; 
 
import org.springframework.stereotype.controller; 
import org.springframework.web.bind.annotation.requestmapping; 
import org.springframework.web.bind.annotation.requestmethod; 
 
@controller
@requestmapping("/test2/login.do") // 指定唯一一个*.do请求关联到该controller 
public class testcontroller2 { 
   
  @requestmapping
  public string testlogin(string username, string password, int age) { 
    // 如果不加任何参数，则在请求/test2/login.do时，便默认执行该方法 
     
    if (!"admin".equals(username) || !"admin".equals(password) || age < 5) { 
      return "loginerror"; 
    } 
    return "loginsuccess"; 
  } 
 
  @requestmapping(params = "method=1", method=requestmethod.post) 
  public string testlogin2(string username, string password) { 
    // 依据params的参数method的值来区分不同的调用方法 
    // 可以指定页面请求方式的类型，默认为get请求 
     
    if (!"admin".equals(username) || !"admin".equals(password)) { 
      return "loginerror"; 
    } 
    return "loginsuccess"; 
  } 
   
  @requestmapping(params = "method=2") 
  public string testlogin3(string username, string password, int age) { 
    if (!"admin".equals(username) || !"admin".equals(password) || age < 5) { 
      return "loginerror"; 
    } 
    return "loginsuccess"; 
  } 
}

其实requestmapping在class上，可看做是父request请求url，而requestmapping在方法上的可看做是子request请求url，父子请求url最终会拼起来与页面请求url进行匹配，因此requestmapping也可以这么写：

package controller; 
 
import org.springframework.stereotype.controller; 
import org.springframework.web.bind.annotation.requestmapping; 
 
@controller
@requestmapping("/test3/*") // 父request请求url 
public class testcontroller3 { 
 
  @requestmapping("login.do") // 子request请求url，拼接后等价于/test3/login.do 
  public string testlogin(string username, string password, int age) { 
    if (!"admin".equals(username) || !"admin".equals(password) || age < 5) { 
      return "loginerror"; 
    } 
    return "loginsuccess"; 
  } 
}

三、结束语

　　掌握以上这些spring mvc就已经有了很好的基础了，几乎可应对与任何开发，在熟练掌握这些后，便可更深层次的灵活运用的技术，如多种视图技术，例如 jsp、velocity、tiles、itext 和 poi。spring mvc框架并不知道使用的视图，所以不会强迫您只使用 jsp 技术。