【JavaEE】Springmvc搭建方法及example
现在介绍SSH的文章很多，但是适合自己需求的却经常找不到，这些东西呢，会了之后总会感觉别人的程序哪里哪里别扭，会之前呢就感觉很混乱，而且SSH的官方文档，至少在我看来是“会者勉强能看、不会者一片迷茫”的，最主要的是没有什么demo，也可能因为我太low了，高手勿喷，我的感觉就是根据文档呢很容易明白如果写了A就能怎么样写了B又能怎么样，但是这个A或者B到底写在哪能让程序跑起来呢，更是会者不难、难者不会。我隔了两年没有做这方面的项目，最近重新拾起来，不再用struts，用spring、spring mvc、hibernate、spring security、spring oauth2搭建网站，这篇包括下面几篇文章，我会简述我搭建最基本环境的过程并给出demo，然后再详细地讲一些配置。
在各个文章我会分别介绍，每篇都附有example，可以根据情况进行修改：
springmvc（本文）
springmvc+spring+hibernate+spring security
springmvc+spring+hibernate+spring security+spring oauth2
这篇文章就来介绍springmvc环境的搭建。
1. pom.xml
首先来看都需要加入哪些包，我使用maven来管理包的依赖。
<properties> <spring.version>4.0.4.RELEASE</spring.version> </properties> <dependencies> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>javax.servlet.jsp.jstl</groupId> <artifactId>javax.servlet.jsp.jstl-api</artifactId> <version>1.2.1</version> </dependency> <dependency> <groupId>taglibs</groupId> <artifactId>standard</artifactId> <version>1.1.2</version> </dependency> <dependency> <groupId>tomcat</groupId> <artifactId>servlet-api</artifactId> <version>5.5.23</version> <scope>provided</scope> </dependency> <dependency> <groupId>tomcat</groupId> <artifactId>jsp-api</artifactId> <version>5.5.23</version> <scope>provided</scope> </dependency> <dependency> <groupId>commons-fileupload</groupId> <artifactId>commons-fileupload</artifactId> <version>1.3.1</version> </dependency> <dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate-validator</artifactId> <version>5.1.2.Final</version> </dependency> <dependency> <groupId>org.codehaus.jackson</groupId> <artifactId>jackson-mapper-asl</artifactId> <version>1.9.13</version> </dependency> </dependencies>
核心的包就是spring-webmvc，这个包导入之后会自动导入spring-core，spring-web等它的依赖包；
后面jstl、taglibs等包的导入是为了在jsp页面中使用jstl等标签；
commons-fileupload是为了文件上传的需要，本demo中没有上传文件的部分，不过哪个网站能没有上传图片呢？
hibernate-validator的导入是为了正常使用springmvc的valid，springmvc的valid只有接口没有实现，如果要使用它的功能需要导入一个实现包，导入hibernate-validator就是为了这个目的，本文的demo里面没有用到validation，所以只是为了运行基本demo，这个可以不导入；
jackson-mapper的导入是为了使用springmvc返回json的功能，对于这个功能springmvc也是只有接口没有实现，如果不导入实现包，要返回json时会返回406错误。jackson-core包会作为依赖导入。
2. web.xml
springmvc和struts的一个机制上的区别就是，struts是一层一层的拦截器在过滤，springmvc是只有一个核心的Servlet，所以首先按照正常注册Servlet的方法，在web.xml中注册这个springmvc：
<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" metadata-complete="true" version="3.0"> <servlet> <servlet-name>spring-dispatcher</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>spring-dispatcher</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping> </web-app>
springmvc还要做很多配置，那些配置在单独的配置文件里，这个配置文件的默认位置就是在web.xml相同目录下的<servlet-name>-servlet.xml，比如我的servlet-name配置的是spring-dispatcher，那么我的springmvc配置文件的默认位置就是web.xml同目录下的spring-dispatcher-servlet.xml。
3. spring-dispatcher-servlet.xml
下一步就是配置springmvc，编辑WEB-INF/spring-dispatcher-servlet.xml：
<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-3.0.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd"> <context:component-scan base-package="org.zhangfc.demo4springmvc.mvc"/> <mvc:annotation-driven /> <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/pages/"/> <property name="suffix" value=".jsp"/> </bean> <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"> <property name="defaultEncoding" value="UTF-8"/> <property name="maxUploadSize" value="2000000"/> </bean> <mvc:resources mapping="/static/**" location="/resources/"/> <mvc:default-servlet-handler /> </beans>
Springmvc的虚拟路径与处理函数的映射，是通过annotation来设置的，这些类都在哪个包下面，就是那个component-scan属性配置的，并设置支持annotation支持，springmvc的每一个处理函数都会返回一个String类型的变量（有的函数返回值就是String，有的返回值是一个对象，对象里有一个viewResolver需要的字符串），我这个设置就是设置一个前缀和后缀，举个例子来说，对于函数返回的这个String，比如是abc，那么需要渲染的文件就是/pages/abc.jsp。
multipartResolver是上传文件需要的配置，还是那句话，本demo中用不到，不过还是写上，哪个项目里不需要上传点东西呢。
最后一个属性，是对静态资源的映射，经过这个映射之后，要访问/static/a.png时，实际访问的就是/resources/a.png。
4. HomeController.java
下面来写一个控制器，位置在上面component-scan配置的package下，springmvc用RequestMapping的annotation来指定虚拟路径，把类这一级的和方法级的加在一起就是最终的虚拟路径，看这段代码：
@Controller @RequestMapping("/") public class HomeController { @RequestMapping("") public String home(){ return "index"; } @RequestMapping("/json") @ResponseBody public Map<String, String> json(){ Map<String, String> result = new HashMap<String, String>(); result.put("zhangsan", "hello"); result.put("lisi", "world"); result.put("wangwu", "nihao"); return result; } }
这儿类这个级别的RequestMapping的值是"/"，home这个方法级别的呢值是空，两个加起来就是"/"，而json这个方法的RequestMapping是"/json"，所以，当访问的URL是"/"的时候，会调用home这个方法来处理，返回值是一个字符串index，还记得前面的viewResolver吗，根据那个配置，这个方法执行完成之后会渲染/pages/index.jsp，所以在WEB-INF的同级目录下创建pages目录（也就是WEB-INF的兄弟目录），再创建index.jsp，运行整个工程，访问"http://localhost:8080/demo4springmvc/"得到的就是index.jsp，因为json方法有一个@ResponseBody的annotation，它的返回值直接给客户端，所以访问"http://localhost:8080/demo4springmvc/json"得到的就是json串：
{"lisi":"world","zhangsan":"hello","wangwu":"nihao"}
这是springmvc的最基本的demo，详细的用法，我会各个框架整合在一起之后再写。
