springmvc+maven框架介绍

maven搭建springmvc框架介绍：

pom.xml文件：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.somnus</groupId>
  <artifactId>SpringMVC</artifactId>
  <packaging>war</packaging>
  <version>0.0.1-SNAPSHOT</version>
  <name>SpringMVC Maven Webapp</name>
  <url>http://maven.apache.org</url>
 <properties>
	<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
	</properties>
  <!-- 指定Maven仓库 -->
	<repositories>
		<!-- oschina的maven仓库 -->
		<repository>
			<id>oschinaRepository</id>
			<name>local private nexus</name>
			<url>http://maven.wozsz.com/content/groups/public/</url>
			<releases>
				<enabled>true</enabled>
			</releases>
			<snapshots>
				<enabled>true</enabled>
			</snapshots>
		</repository>
	</repositories>
  
  <!-- maven依赖包的书写是有顺序的，请不要更改下面dependency的顺序，避免造成JAR包冲突 -->
  <dependencies>
  	 <!-- servlet & jsp -->
	<dependency>
		<groupId>javax.servlet</groupId>
		<artifactId>servlet-api</artifactId>
		<version>2.5</version>
		<scope>provided</scope>
	</dependency>
	<dependency>
		<groupId>javax.servlet</groupId>
		<artifactId>jstl</artifactId>
		<version>1.2</version>
	</dependency>
	<dependency>
		<groupId>javax.servlet.jsp</groupId>
		<artifactId>jsp-api</artifactId>
		<version>2.2</version>
		<scope>provided</scope>
	</dependency>
	<!-- 加入springmvc依赖包 -->
	<dependency>
		<groupId>org.springframework</groupId>
		<artifactId>spring-webmvc</artifactId>
		<version>3.2.5.RELEASE</version>
	</dependency>
	<!-- xml -->
	<dependency>
		<groupId>org.springframework</groupId>
		<artifactId>spring-oxm</artifactId>
		<version>3.2.5.RELEASE</version>
	</dependency>
    <dependency>
           <groupId>com.thoughtworks.xstream</groupId>
           <artifactId>xstream</artifactId>
           <version>1.4.7</version>
    </dependency>
	<!-- 加入fileupload依赖包 -->
	<dependency>
		<groupId>commons-fileupload</groupId>
		<artifactId>commons-fileupload</artifactId>
		<version>1.3.1</version>
	</dependency>
	<!-- jackson -->
	<dependency>
		<groupId>com.fasterxml.jackson.core</groupId>
		<artifactId>jackson-databind</artifactId>
		<version>2.2.3</version>
	</dependency>
	<!-- bean validator -->
	<dependency>
		<groupId>org.hibernate</groupId>
		<artifactId>hibernate-validator</artifactId>
		<version>4.3.2.Final</version>
	</dependency>
	<!-- alibaba json -->
	<dependency>
   		<groupId>com.alibaba</groupId>
   		<artifactId>fastjson</artifactId>
   		<version>1.2.16</version>
	</dependency>
  </dependencies>
  
  <build>
    <finalName>SpringMVC</finalName>
    <plugins>
    	<plugin>
			<groupId>org.apache.maven.plugins</groupId>
			<artifactId>maven-compiler-plugin</artifactId>
			<configuration>
				<target>1.7</target>
				<resource>1.7</resource>
				<encoding>${project.build.sourceEncoding}</encoding>
			</configuration>
		</plugin>
    	
    	<!-- 配置maven集成jetty和tomcat插件 -->
    	<plugin>
			<groupId>org.mortbay.jetty</groupId>
			<artifactId>jetty-maven-plugin</artifactId>
			<version>8.1.9.v20130131</version>
			<configuration>
				<webAppConfig>
					<contextPath>/${project.build.finalName}</contextPath>
				</webAppConfig>
				<scanIntervalSeconds>5</scanIntervalSeconds>
				<!-- 设置端口号为8095默认为8080 -->
				<connectors>
					<connector implementation="org.eclipse.jetty.server.nio.SelectChannelConnector">
						<port>8095</port>
                        <maxIdleTime>60000</maxIdleTime>
					</connector>
				</connectors>
				<!-- 设置停止启动端口号9966 -->
				<stopKey>shutdown</stopKey>
				<stopPort>9966</stopPort>
			</configuration>
		</plugin>
			
		<plugin>
			<groupId>org.apache.tomcat.maven</groupId>
			<artifactId>tomcat7-maven-plugin</artifactId>
			<version>2.2</version>
			<configuration>
				<path>/${project.build.finalName}</path>
				<port>8080</port>
				<uriEncoding>UTF-8</uriEncoding>
				<finalName>${project.build.finalName}</finalName>
				<server>tomcat7</server>
			</configuration>
		</plugin>	
		
    </plugins>
  </build>
</project>

web.xml文件：

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="3.0" 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_3_0.xsd">

  <display-name>SpringMVC</display-name>
  
  <!--字符过滤器及编码utf-8-->
  <filter>
  	<filter-name>characterEncodingFilter</filter-name>
  	<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
  	<init-param>
  		<param-name>encoding</param-name>
  		<param-value>UTF-8</param-value>
  	</init-param>
  	<init-param>
  		<param-name>forceEncoding</param-name>
  		<param-value>true</param-value>
  	</init-param>
  </filter>
  <filter-mapping>
  	<filter-name>characterEncodingFilter</filter-name>
  	<url-pattern>/*</url-pattern>
  </filter-mapping>
  <servlet>
  	<servlet-name>spring</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!-- <init-param>  
    	<param-name>contextConfigLocation</param-name>  
    	<param-value>classpath:/spring-servlet.xml</param-value>  
	</init-param> -->
	<!-- 不写,使用默认值:/WEB-INF/[servlet-name]-servlet.xml -->
	<!-- <param-value>/WEB-INF/classes/spring-servlet.xml</param-value> -->
	<!-- <param-value>classpath:/spring-servlet.xml</param-value> -->
  	<load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
  	<servlet-name>spring</servlet-name>
  	<url-pattern>/</url-pattern>
  </servlet-mapping>
  
  <welcome-file-list>
		<welcome-file>index.jsp</welcome-file>
	</welcome-file-list>
</web-app>

我们在学SpringMVC的时候都知道，它需要一个spring配置文件，用来初始化SpringMVC子容器，既可以指定也可以不指定文件位置。
如果不指定，如上面所配置，那么org.springframework.web.servlet.DispatcherServlet会从默认位置（/WEB-INF/[servlet-name]-servlet.xml）加载，也就是/WEB-INF/spring-servlet.xml。如下截图：

如果需要指定呢，比如需要把spring配置文件放在src/main/resources中呢，如下图：

则配置方式如下：

<servlet>
    <servlet-name>spring</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>  
        <param-name>contextConfigLocation</param-name>  
        <param-value>classpath:/spring-mvc.xml</param-value>  
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>

springmvc的请求路径url后缀：

方式一：

<servlet-mapping>
    <servlet-name>spring</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

方式二：

<servlet-mapping>
    <servlet-name>dispatcher</servlet-name>
    <url-pattern>*.html</url-pattern>
</servlet-mapping>
<servlet-mapping>
    <servlet-name>dispatcher</servlet-name>
    <url-pattern>*.action</url-pattern>
</servlet-mapping>
<servlet-mapping>
    <servlet-name>dispatcher</servlet-name>
   <url-pattern>*.do</url-pattern>
</servlet-mapping>

它们有什么区别呢，以及在开发中注意的地方：
方式一：任意路径都会被映射，能够被org.springframework.web.servlet.DispatcherServlet处理
方式二：只有指定的路径才会被处理，如html、action、do结尾

两种方式其实任意一种都可以，但是使用方式二静态资源文件（js、css、images、plugins、fonts）就不能放在WEB-INF里面，只能放在webapp里面，因为映射里没有包含静态文件的路径。方式一就没问题，但是需要在springmvc配置文件中做静态资源映射。

方式一静态资源文件存放如下截图：

方式二静态资源文件存放如下截图：

方式一需要在springmvc配置文件中做静态资源映射如下：

spring-servlet.xml配置文件

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xmlns:context="http://www.springframework.org/schema/context"
    xmlns:mvc="http://www.springframework.org/schema/mvc"
    xsi:schemaLocation="
        http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.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.xsd">
        
	<!-- 启动注解驱动的Spring MVC功能，注册请求url和注解POJO类方法的映射--><!-- <mvc:annotation-driven /> -->
    <mvc:annotation-driven validator="validator" conversion-service="conversion-service" />
    
    <bean id="validator" class="org.springframework.validation.beanvalidation.LocalValidatorFactoryBean">
        <property name="providerClass"  value="org.hibernate.validator.HibernateValidator"/>
        <!--不设置则默认为classpath下的 ValidationMessages.properties -->
        <property name="validationMessageSource" ref="validatemessageSource"/>
    </bean>
    <bean id="conversion-service" class="org.springframework.format.support.FormattingConversionServiceFactoryBean" />
    <bean id="validatemessageSource" class="org.springframework.context.support.ReloadableResourceBundleMessageSource">  
        <property name="basename" value="classpath:message/validatemessages"/>  
        <property name="fileEncodings" value="utf-8"/>  
        <property name="cacheSeconds" value="120"/>  
	</bean> 
      
    <!-- 如果当前请求为"/"时，则转发到“/helloworld/index" -->
    <mvc:view-controller path="/" view-name="forward:/helloworld/index"/> 
    <!-- 静态资源映射 -->
    <mvc:resources mapping="/js/**" location="/WEB-INF/js/" />
    <mvc:resources mapping="/css/**" location="/WEB-INF/css/" />
    <mvc:resources mapping="/fonts/**" location="/WEB-INF/fonts/" />
    <mvc:resources mapping="/plugins/**" location="/WEB-INF/plugins/" />
    <mvc:resources mapping="images/**" location="/WEB-INF/images/" />
    <!-- 当上面要访问的静态资源不包括在上面的配置中时，则根据此配置来访问 -->
    <mvc:default-servlet-handler/>

	<!-- 开启controller注解支持 -->
    <!-- use-default-filters="false" 只扫描指定的注解 -->
    <context:component-scan base-package="com.somnus.controller" use-default-filters="false">
        <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
    </context:component-scan>
	
    <!-- 视图解析器 -->
    <!-- <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
       <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
       <property name="contentType" value="text/html"/>        
       <property name="prefix" value="/WEB-INF/views/"/>
       <property name="suffix" value=".jsp"/>
    </bean> -->
    <!-- 视图解析器 -->
	<bean id="viewResolver"
		class="org.springframework.web.servlet.view.ContentNegotiatingViewResolver">
		<property name="mediaTypes">
			<map>
				<entry key="html" value="text/html" />
				<entry key="json" value="application/json" />
				<entry key="xml" value="application/xml" />
			</map>
		</property>
		<property name="viewResolvers">
			<list>
				<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
					<property name="prefix" value="/WEB-INF/views/" />
					<property name="suffix" value=".jsp" />
				</bean>
			</list>
		</property>
		<property name="defaultViews">
			<list>
				<!-- 不加配置返回 {"account":{"username":"admin","password":"123456"}} -->
				<!-- 加配置返回 {"username":"admin","password":"123456"}-->
				<!--视图解析器解析json数据-->
				<bean class="org.springframework.web.servlet.view.json.MappingJackson2JsonView">
					<property name="extractValueFromSingleKeyModel" value="true" /> 
				</bean>
				<!--视图解析器解析xml数据-->
				<bean class="org.springframework.web.servlet.view.xml.MarshallingView"> 
                    <property name="marshaller"> 
                        <bean class="org.springframework.oxm.xstream.XStreamMarshaller"/> 
                    </property> 
                </bean> 
			</list>
		</property>
	</bean>
    
    <!-- 支持上传文件 -->  
    <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">  
	    <!-- 设置上传文件的最大尺寸为1MB -->  
	    <property name="maxUploadSize">  
	        <value>1048576</value>  
	    </property>
	    <property name="defaultEncoding"> 
			<value>UTF-8</value> 
		</property>
    </bean>
    
    <mvc:interceptors>
    	<mvc:interceptor>
    		<mvc:mapping path="/helloworld/*"/>
    		<!-- 如果不定义 mvc:mapping path 将拦截所有的URL请求 -->
        	<bean class="com.somnus.interceptor.AuthInterceptor"></bean>
    	</mvc:interceptor> 
        <!-- 国际化操作拦截器 如果采用基于（请求/Session/Cookie）则必需配置 --> 
        <bean class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor" />  
    </mvc:interceptors>
    
    <!-- ################################################################ -->
    <!--    注意：当spring-servlet.xml中使用<mvc:annotation-driven/>时，                               -->
    <!--    如果是3.1之前已经默认注入AnnotationMethodHandlerAdapter，                                                 -->
    <!--    3.1之后默认注入RequestMappingHandlerAdapter只需加上相关jackson的jar包即可! -->
    <!-- ################################################################ -->
    
    <!-- <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">  
        <property name="messageConverters">  
            <list>  
                <bean class="org.springframework.http.converter.json.MappingJacksonHttpMessageConverter"/>  
            </list>  
        </property>  
    </bean> -->
    
</beans>

开启注解映射支持，它是为了简化配置的缩写形式，它相当于以下2个配置：

<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"/>
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"/>

由于我们在web.xml文件里面配置的是拦截所有的请求到该servlet，所以我们在这里要对静态资源文件映射作一下配置，否则请求这些资源文件会返回 404：

<!-- 静态资源映射 -->  
<mvc:resources mapping="/js/**" location="/WEB-INF/js/" />  
<mvc:resources mapping="/css/**" location="/WEB-INF/css/" />  
<mvc:resources mapping="/fonts/**" location="/WEB-INF/fonts/" />  
<mvc:resources mapping="/plugins/**" location="/WEB-INF/plugins/" />  
<mvc:resources mapping="images/**" location="/WEB-INF/images/" />  
<!-- 当上面要访问的静态资源不包括在上面的配置中时，则根据此配置来访问 -->  
<mvc:default-servlet-handler/> 

开启Controller注解支持，并配置只扫描指定包下面的Controller：

<context:component-scan base-package="com.demo.web.controllers" use-default-filters="false">  
    <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>  
</context:component-scan> 

配置视图解析器，并指定视图所在的文件夹：

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">  
   <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>  
   <property name="contentType" value="text/html"/>          
   <property name="prefix" value="/WEB-INF/views/"/>  
   <property name="suffix" value=".jsp"/>  
</bean> 

springmvc数据绑定注解：
1.@RequestParam，绑定单个请求数据，可以是URL中的数据，表单提交的数据或上传的文件；

（经常使用如在请求的url中带参数url:basePath+'/SpringMVC/databand/queryByName.do?name='+name

    后台接受参数方法：public String queryByName(@RequestParam('name') String name){}

）
2.@PathVariable，绑定URL模板变量值；
3.@CookieValue，绑定Cookie数据；
4.@RequestHeader，绑定请求头数据；
5.@ModelAttribute，绑定数据到Model；
6.@SessionAttributes，绑定数据到Session；
7.@RequestBody，用来处理Content-Type不是application/x-www-form-urlencoded编码的内容，例如application/json, application/xml等；
8.@RequestPart，绑定“multipart/data”数据，并可以根据数据类型进项对象转换；

备注：

1.关于@RequestParam的参数，这是一个@RequestParam的完整写法
@RequestParam(value=”username”, required=true, defaultValue=”AAA”)。
value表示要绑定请求中参数的名字；
required表示请求中是否必须有这个参数，默认为true这是如果请求中没有要绑定的参数则返回404；
defaultValue表示如果请求中指定的参数值为空时的默认值；
要绑定的参数如果是值类型必须要有值否则抛异常，如果是引用类型则默认为null（Boolean除外，默认为false）；
2.关于@ModelAttribute绑定数据到模型中。modelAutoBind action中我们将表单提交的数据添加到Model中的代码如下：

@RequestMapping(value="/modelautobind", method = {RequestMethod.POST})  
public String modelAutoBind(HttpServletRequest request, Model model, AccountModel accountModel){  
    model.addAttribute("accountmodel", accountModel);  
    return "modelautobindresult";  
} 

而借助于@ModelAttribute 我们可以更简单的讲数据添加到Model中，把上面的代码修改为：

@RequestMapping(value="/modelautobind", method = {RequestMethod.POST})  
public String modelAutoBind(HttpServletRequest request, @ModelAttribute("accountmodel") AccountModel accountModel){  
    return "modelautobindresult";  
} 

2.关于@RequestBody，调用合适的MessageConvert来把非application/x-www-form-urlencoded请求中的内容转换为指定的对象，如请求类型content-type为“application/json”,它通常与@ResponseBody合用，@ResponseBody与@RequestBody刚好相反，他把指定的对象转换为合适的内容（请求头为Accept:application/json 则返回json数据）并返回。 注意Spring默认解析json用的是Jackson，让实体类继承Serializable接口并添加一个空的构造函数（为了Jackson做转换）。