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配置（部分）

[html] view plain copy

print?

1. <!– Spring MVC配置 –>  
2. <!– ====================================== –>  
3. <servlet>  
4.     <servlet-name>spring</servlet-name>  
5.     <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>  
6.     <!– 可以自定义servlet.xml配置文件的位置和名称，默认为WEB-INF目录下，名称为[<servlet-name>]-servlet.xml，如spring-servlet.xml  
7.     <init-param>  
8.         <param-name>contextConfigLocation</param-name>  
9.         <param-value>/WEB-INF/spring-servlet.xml</param-value>  默认  
10.     </init-param>  
11.     –>  
12.     <load-on-startup>1</load-on-startup>  
13. </servlet>  
14.   
15. <servlet-mapping>  
16.     <servlet-name>spring</servlet-name>  
17.     <url-pattern>*.do</url-pattern>  
18. </servlet-mapping>  
19.     
20.   
21.   
22. <!– Spring配置 –>  
23. <!– ====================================== –>  
24. <listener>  
25.     <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>  
26. </listener>  
27.     
28.   
29. <!– 指定Spring Bean的配置文件所在目录。默认配置在WEB-INF目录下 –>  
30. <context-param>  
31.     <param-name>contextConfigLocation</param-name>  
32.     <param-value>classpath:config/applicationContext.xml</param-value>  
33. </context-param>  

<!-- 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。

[html] view plain copy

print?

1. <?xml version=“1.0” encoding=“UTF-8”?>  
2. <beans xmlns=“http://www.springframework.org/schema/beans”       
3.        xmlns:xsi=“http://www.w3.org/2001/XMLSchema-instance” xmlns:p=“http://www.springframework.org/schema/p”       
4.         xmlns:context=“http://www.springframework.org/schema/context”       
5.    xsi:schemaLocation=”http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd     
6.        http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.0.xsd     
7.        http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.0.xsd     
8.        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>”>  
9.   
10.     <!– 启用spring mvc 注解 –>  
11.     <context:annotation-config />  
12.   
13.     <!– 设置使用注解的类所在的jar包 –>  
14.     <context:component-scan base-package=“controller”></context:component-scan>  
15.   
16.     <!– 完成请求和注解POJO的映射 –>  
17.     <bean class=“org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter” />  
18.   
19.     <!– 对转向页面的路径解析。prefix：前缀， suffix：后缀 –>  
20.     <bean class=“org.springframework.web.servlet.view.InternalResourceViewResolver” p:prefix=“/jsp/” p:suffix=“.jsp” />  
21. </beans>  

<?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 http://www.springframework.org/schema/context/spring-context-3.0.xsd">    <!-- 启用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配置

[html] view plain copy

print?

1. <?xml version=“1.0” encoding=“UTF-8”?>  
2. <beans xmlns=“http://www.springframework.org/schema/beans”  
3.         xmlns:xsi=“http://www.w3.org/2001/XMLSchema-instance”  
4.         xmlns:aop=“http://www.springframework.org/schema/aop”  
5.         xmlns:tx=“http://www.springframework.org/schema/tx”  
6.         xsi:schemaLocation=”  
7.             http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd  
8.             http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-2.5.xsd  
9.             http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-2.5.xsd”>  
10.   
11.     <!– 采用hibernate.cfg.xml方式配置数据源 –>  
12.     <bean id=“sessionFactory” class=“org.springframework.orm.hibernate3.LocalSessionFactoryBean”>  
13.         <property name=“configLocation”>  
14.             <value>classpath:config/hibernate.cfg.xml</value>  
15.         </property>  
16.     </bean>  
17.       
18.     <!– 将事务与Hibernate关联 –>  
19.     <bean id=“transactionManager” class=“org.springframework.orm.hibernate3.HibernateTransactionManager”>  
20.         <property name=“sessionFactory”>  
21.             <ref local=“sessionFactory”/>  
22.         </property>  
23.     </bean>  
24.       
25.     <!– 事务（注解 ）–>  
26.     <tx:annotation-driven transaction-manager=“transactionManager” proxy-target-class=“true”/>  
27.   
28.    <!– 测试Service –>  
29.    <bean id=“loginService” class=“service.LoginService”></bean>  
30.   
31.     <!– 测试Dao –>  
32.     <bean id=“hibernateDao” class=“dao.HibernateDao”>  
33.         <property name=“sessionFactory” ref=“sessionFactory”></property>  
34.     </bean>  
35. </beans>  

<?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，处理完后跳转页面。看如下代码（注解）：

[java] view plain copy

print?

1. package controller;  
2.   
3. import javax.servlet.http.HttpServletRequest;  
4.   
5. import org.springframework.stereotype.Controller;  
6. import org.springframework.web.bind.annotation.RequestMapping;  
7. import org.springframework.web.bind.annotation.RequestParam;  
8.   
9. import entity.User;  
10.   
11. @Controller  //类似Struts的Action  
12. public class TestController {  
13.   
14.     @RequestMapping(“test/login.do”)  // 请求url地址映射，类似Struts的action-mapping  
15.     public String testLogin(@RequestParam(value=“username”)String username, String password, HttpServletRequest request) {  
16.         // @RequestParam是指请求url地址映射中必须含有的参数(除非属性required=false)  
17.         // @RequestParam可简写为：@RequestParam(“username”)  
18.   
19.         if (!“admin”.equals(username) || !“admin”.equals(password)) {  
20.             return “loginError”; // 跳转页面路径（默认为转发），该路径不需要包含spring-servlet配置文件中配置的前缀和后缀  
21.         }  
22.         return “loginSuccess”;  
23.     }  
24.   
25.     @RequestMapping(“/test/login2.do”)  
26.     public ModelAndView testLogin2(String username, String password, int age){  
27.         // request和response不必非要出现在方法中，如果用不上的话可以去掉  
28.         // 参数的名称是与页面控件的name相匹配，参数类型会自动被转换  
29.           
30.         if (!“admin”.equals(username) || !“admin”.equals(password) || age < 5) {  
31.             return new ModelAndView(“loginError”); // 手动实例化ModelAndView完成跳转页面（转发），效果等同于上面的方法返回字符串  
32.         }  
33.         return new ModelAndView(new RedirectView(“../index.jsp”));  // 采用重定向方式跳转页面  
34.         // 重定向还有一种简单写法  
35.         // return new ModelAndView(“redirect:../index.jsp”);  
36.     }  
37.   
38.     @RequestMapping(“/test/login3.do”)  
39.     public ModelAndView testLogin3(User user) {  
40.         // 同样支持参数为表单对象，类似于Struts的ActionForm，User不需要任何配置，直接写即可  
41.         String username = user.getUsername();  
42.         String password = user.getPassword();  
43.         int age = user.getAge();  
44.           
45.         if (!“admin”.equals(username) || !“admin”.equals(password) || age < 5) {  
46.             return new ModelAndView(“loginError”);  
47.         }  
48.         return new ModelAndView(“loginSuccess”);  
49.     }  
50.   
51.     @Resource(name = “loginService”)  // 获取applicationContext.xml中bean的id为loginService的，并注入  
52.     private LoginService loginService;  //等价于spring传统注入方式写get和set方法，这样的好处是简洁工整，省去了不必要得代码  
53.   
54.     @RequestMapping(“/test/login4.do”)  
55.     public String testLogin4(User user) {  
56.         if (loginService.login(user) == false) {  
57.             return “loginError”;  
58.         }  
59.         return “loginSuccess”;  
60.     }  
61. }  

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的Actionpublic 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参数来区分访问不同的方法，代码如下：

[java] view plain copy

print?

1. package controller;  
2.   
3. import org.springframework.stereotype.Controller;  
4. import org.springframework.web.bind.annotation.RequestMapping;  
5. import org.springframework.web.bind.annotation.RequestMethod;  
6.   
7. @Controller  
8. @RequestMapping(“/test2/login.do”)  // 指定唯一一个*.do请求关联到该Controller  
9. public class TestController2 {  
10.       
11.     @RequestMapping  
12.     public String testLogin(String username, String password, int age) {  
13.         // 如果不加任何参数，则在请求/test2/login.do时，便默认执行该方法  
14.           
15.         if (!“admin”.equals(username) || !“admin”.equals(password) || age < 5) {  
16.             return “loginError”;  
17.         }  
18.         return “loginSuccess”;  
19.     }  
20.   
21.     @RequestMapping(params = “method=1”, method=RequestMethod.POST)  
22.     public String testLogin2(String username, String password) {  
23.         // 依据params的参数method的值来区分不同的调用方法  
24.         // 可以指定页面请求方式的类型，默认为get请求  
25.           
26.         if (!“admin”.equals(username) || !“admin”.equals(password)) {  
27.             return “loginError”;  
28.         }  
29.         return “loginSuccess”;  
30.     }  
31.       
32.     @RequestMapping(params = “method=2”)  
33.     public String testLogin3(String username, String password, int age) {  
34.         if (!“admin”.equals(username) || !“admin”.equals(password) || age < 5) {  
35.             return “loginError”;  
36.         }  
37.         return “loginSuccess”;  
38.     }  
39. }  

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请求关联到该Controllerpublic 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也可以这么写：

[java] view plain copy

print?

1. package controller;  
2.   
3. import org.springframework.stereotype.Controller;  
4. import org.springframework.web.bind.annotation.RequestMapping;  
5.   
6. @Controller  
7. @RequestMapping(“/test3/*”)  // 父request请求url  
8. public class TestController3 {  
9.   
10.     @RequestMapping(“login.do”)  // 子request请求url，拼接后等价于/test3/login.do  
11.     public String testLogin(String username, String password, int age) {  
12.         if (!“admin”.equals(username) || !“admin”.equals(password) || age < 5) {  
13.             return “loginError”;  
14.         }  
15.         return “loginSuccess”;  
16.     }  
17. }  

package controller;import org.springframework.stereotype.Controller;import org.springframework.web.bind.annotation.RequestMapping;@Controller@RequestMapping("/test3/*")  // 父request请求urlpublic 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 技术。

转自：http://blog.csdn.net/wangpeng047/article/details/6983027