springMVC学习篇 - 搭建环境及关键点
springMVC是spring家族中一个重要的组件，和struts一样作为一套前台框架被广泛的应用于各种项目。
之前在很多项目组都用到springMVC，只感觉很强大，但是对这套框架的知识了解比较少。这几天项目组没那么忙正学习下，过程中遇到很多问题也查找不少资料，整理出来与大家共享。
本文介绍简单springmvc框架环境搭建和我在学习中遇到问题查找资料时间比较长的一些点，这里这称之为关键点。
一、搭建环境
1、下载需要的jar包
①需要的最少spring mvc jar包
②maven pom.xml配置
1 <dependencies> 2 <dependency> 3 <groupId>org.springframework</groupId> 4 <artifactId>spring-webmvc</artifactId> 5 <version>3.0.1.RELEASE</version> 6 </dependency> 7 <dependency> 8 <groupId>jstl</groupId> 9 <artifactId>jstl</artifactId> 10 <version>1.2</version> 11 </dependency> 12 </dependencies>
2、web.xml
1 <?xml version="1.0" encoding="UTF-8"?> 2 <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 3 xmlns="http://java.sun.com/xml/ns/javaee" 4 xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" 5 id="WebApp_ID" version="2.5"> 6 <display-name>deposit</display-name> 7 8 <servlet-mapping> 9 <servlet-name>default</servlet-name> 10 <url-pattern>/scripts/*</url-pattern> 11 <url-pattern>/styles/*</url-pattern> 12 </servlet-mapping> 13 14 <!--初始化spring的配置文件--> 15 <context-param> 16 <param-name>contextConfigLocation</param-name> 17 <param-value>classpath:spring/applicationContext.xml</param-value> 18 </context-param> 19 <!--启动spring容器--> 20 <listener> 21 <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> 22 </listener> 23 24 <!-- 初始化DispatcherServlet --> 25 <servlet> 26 <servlet-name>springmvc</servlet-name> 27 <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> 28 <!--springmvc框架在 web应用程序WEB-INF目录中寻找一个名为[servlet-name]-servlet.xml的文件,可通过<init-param>修改默认文件路径配置 29 <init-param> 30 <param-name>contextConfigLocation</param-name> 31 <param-value>classpath:spring/springmvc/springmvc-servlet.xml</param-value> 32 </init-param>--> 33 <load-on-startup>1</load-on-startup> 34 </servlet> 35 <servlet-mapping> 36 <servlet-name>springmvc</servlet-name> 37 <url-pattern>/*</url-pattern> 38 </servlet-mapping> 39 </web-app>
3、springmvc-servlet.xml
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:context="http://www.springframework.org/schema/context" 5 xmlns:mvc="http://www.springframework.org/schema/mvc" 6 xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd 7 http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd 8 http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd"> 9 10 <!-- 启用spring mvc 注解 --> 11 <context:annotation-config /> 12 <!-- 设置使用注解的类所在的jar包，注入view层控制类 --> 13 <context:component-scan base-package="cn.tancp.framework.springmvc.controller" /> 14 15 <!-- 对转向页面的路径解析。prefix：前缀， suffix：后缀 --> 16 <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> 17 <property name="prefix" value="/WEB-INF/"/> 18 <property name="suffix" value=".jsp"></property> 19 </bean> 20 21 <!--注册springmvc拦截类--> 22 <mvc:interceptors> 23 <bean class="cn.tancp.framework.springmvc.interceptor.CommonInterceptor" /> 24 </mvc:interceptors> 25 </beans>
4、applicationContext.xml
1 <?xml version="1.0" encoding="UTF-8"?> 2 <beans 3 xmlns="http://www.springframework.org/schema/beans" 4 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 5 xmlns:context="http://www.springframework.org/schema/context" 6 xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd 7 http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd"> 8 9 <!-- 设置使用注解的类所在的jar包，注入service层类 --> 10 <context:component-scan base-package="cn.tancp.framework.springmvc.service" /> 11 </beans>
5、controller类
1 package cn.tancp.framework.springmvc.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 public class SystemController { 9 10 @RequestMapping(value = "/",method = RequestMethod.GET) 11 public String home() { 12 return "index"; 13 } 14 15 @RequestMapping(value = "/login", method = RequestMethod.GET) 16 public String login() { 17 return "login"; 18 } 19 }
6、springmvc拦截器
1 package cn.tancp.framework.springmvc.interceptor; 2 3 import javax.servlet.http.HttpServletRequest; 4 import javax.servlet.http.HttpServletResponse; 5 import org.springframework.web.servlet.ModelAndView; 6 import org.springframework.web.servlet.handler.HandlerInterceptorAdapter; 7 8 public class CommonInterceptor extends HandlerInterceptorAdapter { 9 10 @Override 11 public boolean preHandle(HttpServletRequest arg0, HttpServletResponse arg1, 12 Object arg2) throws Exception { 13 System.out.println("Pre-Handle"); 14 return true; 15 } 16 17 @Override 18 public void afterCompletion(HttpServletRequest arg0, 19 HttpServletResponse arg1, Object arg2, Exception arg3) 20 throws Exception { 21 System.out.println("After-Completion"); 22 } 23 24 @Override 25 public void postHandle(HttpServletRequest arg0, HttpServletResponse arg1, 26 Object arg2, ModelAndView arg3) throws Exception { 27 System.out.println("Post-Handle"); 28 } 29 }
二、关键点
1、使用xml标签需要引用相应模式文档，否则报错
2、DispatcherServlet路径配置
在研究springmvc拦截器时，想配置映射为“/”访问项目根路径方法，但始终会访问到index.jsp页面上去，后来发现这个路径配置成了*.shtml
原因：之前以为配置*.shtml只会让后缀名为shtml的链接访问，而实际只会将*.shtml springMVC容器内。
3、xml中classpath:
classpath 代表 /WEB-INF /classes/ 这个路径 常用的场景： 在SSH架构中，配置spring的上下文环境： <context-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:applicationContext.xml</param-value> </context-param> 里面的 classpath:applicationContext.xml 也可以使用 /WEB-INF /classes/ applicationContext.xml 代替 注意： classpath 和 classpath* 区别： classpath：只会到你的class路径中查找找文件; classpath*：不仅包含class路径，还包括jar文件中(class路径)进行查找
4、HandlerInterceptor接口preHandle方法返回值
在配置springmvc拦截器时如果preHandle方法的返回值是false，则不会跳到相应被拦截的页面，也不会进入下一个拦截器
5、SpringMVC的springmvc-servlet.xml文件中配置扫描包，不要包含 service的注解，Spring的applicationContext.xml文件中配置扫描包，不要包含controller的注解。
如下：
springmvc-servlet.xml的配置：
<!-- 设置使用注解的类所在的jar包，注入view层控制类 --> <context:component-scan base-package="cn.tancp.framework.springMVC.controller" />
Spring MVC启动时的配置文件，包含组件扫描、url映射以及设置freemarker参数，让spring不扫描带有@Service注解的类。
因为springmvc-servlet.xml与applicationContext.xml不是同时加载，加载springmvc-servlet.xml时spring会将所有带@Service注解的类都扫描到容器中，等到加载applicationContext.xml的时候，会因为容器已经存在Service类，使得cglib将不对Service进行代理，直接导致的结果就是在applicationContext 中的事务配置不起作用。
同样applicationContext.xml的配置如下：
<!-- 设置使用注解的类所在的jar包，注入service层类 --><context:component-scan base-package="cn.tancp.framework.springmvc.service" />
扫描包路径，不扫描带有@Controller注解的类。因为这些类已经随容器启动时，在springmvc.xml中扫描过一遍了。
