《经久不衰的Spring框架：Spring+SpringMVC+MyBatis 整合》

前言

　　主角即Spring、SpringMVC、MyBatis，即所谓的SSM框架，大家应该也都有所了解，概念性的东西就不写了，有万能的百度。之前没有记录SSM整合的过程，这次刚刚好基于自己的一个小项目重新搭建了一次，而且比项目搭建的要更好一些。以前解决问题的过程和方法并没有及时记录，以后在自己的小项目中遇到我再整理分享一下。个人认为使用框架并不是很难，关键要理解其思想，这对于我们提高编程水平很有帮助。　

　　工作环境：JDK 1.7、Mysql 5.6、Myeclipse 10、Tomcat 7、Maven

　　框架版本：Spring 4.2.6.RELEASE、SpringMVC 4.2.6.RELEASE、MyBatis 3.2.8

　　

一、整体文件结构设计

项目目录结构：

　　1、类文件和资源文件分开存放，类文件分为六层，其中common存放公共和框架部分，controller存放项目控制层，service存放项目业务逻辑层，model存放项目实体类，mapper存放数据层接口，test存放测试相关类。

　　注：若涉及到多业务模块的情况，分层可以在各层内部进行划分，当然对于大模块建议采用Maven多模块项目方式搭建。

　　2、前端在webapp下分出了common和project，common存放公共部分，project内部用于存放多个子模块，common以及各子模块内部分别新建images，js，css和view四个文件夹，用于归类不同资源。

二、项目入口web.xml

　　构建好整体结构后，接下来应该把目光看下web.xml文件，无论是何种JavaEE框架，入口总是在web.xml，认准这边就没错了。

　　web.xml 内容很多，SSM整合相关的关键部分就是加载Spring配置文件spring-config.xml，以及将SpringMVC核心调度器DispatcherServlet注册为servlet（配置文件为mvc-config.xml），其他部分有注释，选择性观看即可。

web.xml

<?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" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" version="3.0">

    <!-- ================站台名称，站台描述，大小图标================ -->
    <display-name>SpringMVC</display-name>
    <description>柴可夫斯基模板</description>
      <icon>
         <small-icon>/common/images/favicon.ico</small-icon>
       <large-icon>/common/images/favicon.ico</large-icon>
    </icon>

    <!-- 支持分布式 -->
    <!-- <distributable/> -->

    <!-- 应用路径，如果不设置，缺省为"webapp.root"，当tomcat加载多个项目时，会发生名称冲突 -->
    <context-param>
        <param-name>webAppRootKey</param-name>
        <param-value>spring4.root</param-value>
    </context-param> 

    <!-- ================log4j配置开始================ -->
    <!-- log4j2不需要在这边做额外的配置 -->
    <!-- ================log4j配置结束================ --> 

    <!-- ================Spring配置开始================ -->
    <!-- 设置Spring容器加载所有的配置文件的路径 -->
    <context-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath*:spring-config.xml</param-value>
      <!-- <param-value>classpath:/spring-*.xml</param-value> -->
    </context-param>
    <!-- 配置Spring监听器，可以在容器启动时，加载contextConfigLocation的context-param节点的配置文件 -->
    <listener>
      <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>
    <!-- ================Spring配置结束================ -->

    <!-- 配置监听器，定义在服务器启动和关闭时，需要执行的方法 -->
    <listener>
      <listener-class>com.demo.common.startup.InitListener</listener-class>
    </listener>

    <!-- 防止Struts和Quartz等内存溢出监听器 -->
    <listener>
      <listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class>
    </listener>

    <!-- 监听HTTP请求事件，为Bean的request,session,globalsession等作用域提供支持 -->
    <listener>
        <listener-class>org.springframework.web.context.request.RequestContextListener</listener-class>
    </listener>

    <!-- Spring 字符编码配置 -->
    <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>

    <!-- 自定义登录过滤器，拦截JSP页面，不允许直接访问 -->
    <filter>
      <filter-name>loginFilter</filter-name>
      <filter-class>com.demo.common.filter.LoginFilterSpring</filter-class>
      <init-param>
        <param-name>charset</param-name>
        <param-value>UTF-8</param-value>
      </init-param>
      <init-param>
        <param-name>contentType</param-name>
        <param-value>text/html;charset=UTF-8</param-value>
      </init-param>
    </filter>
    <filter-mapping>
      <filter-name>loginFilter</filter-name>
      <url-pattern>*.jsp</url-pattern>
    </filter-mapping>

    <!--包装request过滤器-->
    <filter>
        <filter-name>wrapRequestFilter</filter-name>
        <filter-class>com.demo.common.filter.WrapParameterFilter</filter-class>
    </filter>
    <filter-mapping>
        <filter-name>wrapRequestFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

    <!-- 激活Tomcat的defaultServlet来处理静态文件（效率较高） -->
    <servlet-mapping>
      <servlet-name>default</servlet-name>
      <url-pattern>*.jpg</url-pattern>
      <url-pattern>*.gif</url-pattern>
      <url-pattern>*.png</url-pattern>
      <url-pattern>*.js</url-pattern>
      <url-pattern>*.css</url-pattern>
      <url-pattern>*.ico</url-pattern>
      <url-pattern>*.eot</url-pattern>
      <url-pattern>*.svg</url-pattern>
      <url-pattern>*.ttf</url-pattern>
      <url-pattern>*.woff</url-pattern>
      <url-pattern>*.mp3</url-pattern>
      <url-pattern>*.html</url-pattern>
    </servlet-mapping>

    <!-- ================配置SpringMVC核心调度器================ -->
    <!-- 不指定具体文件的话，默认为"/WEB-INF/<servlet name>-servlet.xml" -->
    <!-- load-on-startup代表启动顺序，设置为大于等于0表示容器在应用启动时就加载并初始化这个servlet -->
    <!-- 推荐拦截/，风格优雅 -->
    <servlet>
      <servlet-name>SpringMVC</servlet-name>
      <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
      <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath*:mvc-config.xml</param-value>
      </init-param>
      <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
      <servlet-name>SpringMVC</servlet-name>
      <url-pattern>/</url-pattern>
    </servlet-mapping>

    <!-- 随服务器启动的servlet -->
    <servlet>
      <servlet-name>initServlet</servlet-name>
      <servlet-class>com.demo.common.startup.InitServlet</servlet-class>
      <load-on-startup>0</load-on-startup>
    </servlet>

    <!-- 阿里巴巴数据源配置启用Web监控统计功能 -->
    <!-- 通过 http://ip:port/druid/ 地址访问即可 -->
    <servlet>
      <servlet-name>DruidStatView</servlet-name>
      <servlet-class>com.alibaba.druid.support.http.StatViewServlet</servlet-class>
      <init-param>
            <param-name>allow</param-name>
            <param-value>127.0.0.1</param-value>
        </init-param>
    </servlet>
    <servlet-mapping>
      <servlet-name>DruidStatView</servlet-name>
      <url-pattern>/druid/*</url-pattern>
    </servlet-mapping>

    <!-- CXF服务发布配置 -->
    <servlet>
        <servlet-name>CXFService</servlet-name>
        <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>CXFService</servlet-name>
        <url-pattern>/webservice/*</url-pattern>
    </servlet-mapping>

    <!-- 设置session过期时间为60分钟 -->
    <session-config>
      <session-timeout>60</session-timeout>
    </session-config>

    <!-- 指定错误404和500的处理页面 -->
    <error-page>
      <error-code>404</error-code>
      <location>/common/view/404.jsp</location>
    </error-page>
    <error-page>
      <error-code>500</error-code>
      <location>/common/view/500.jsp</location>
    </error-page>

    <!-- 欢迎页面 -->
    <welcome-file-list>
      <welcome-file>common/view/index.jsp</welcome-file>
    </welcome-file-list>

</web-app>

三、Spring 框架配置

这块涉及内容也很多，从何说起呢，先上一下文件内容好了：

spring-config.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:tx="http://www.springframework.org/schema/tx"
    xmlns:context="http://www.springframework.org/schema/context"
    xmlns:aop="http://www.springframework.org/schema/aop"
    xmlns:mvc="http://www.springframework.org/schema/mvc"
    xmlns:task="http://www.springframework.org/schema/task"
    xsi:schemaLocation="http://www.springframework.org/schema/beans
    http://www.springframework.org/schema/beans/spring-beans-3.1.xsd
    http://www.springframework.org/schema/mvc
    http://www.springframework.org/schema/mvc/spring-mvc-3.1.xsd
    http://www.springframework.org/schema/context
    http://www.springframework.org/schema/context/spring-context-3.1.xsd
    http://www.springframework.org/schema/task http://www.springframework.org/schema/task/spring-task.xsd
    http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.1.xsd
    http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.1.xsd">

    <!-- 加载配置属性文件 -->
    <context:property-placeholder ignore-unresolvable="true" location="classpath:constant.properties"/>

    <!-- 开启异步任务（同时开启定时器注解扫描） -->
    <task:annotation-driven />

    <!-- 使用@AspectJ风格的切面声明 -->
    <!-- <aop:aspectj-autoproxy/> -->

    <!-- 使用Annotation自动注册Bean -->
    <!-- 在主容器中不扫描@Controller注解，在SpringMvc中只扫描@Controller注解 -->
    <context:component-scan base-package="com.demo"><!-- base-package 如果多个，用“,”分隔 -->
        <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller" />
    </context:component-scan>  

    <!-- 引入Mybatis配置 -->
    <import resource="spring-mybatis.xml"/>

    <!-- 引入Socket配置 -->
    <import resource="spring-socket.xml"/>

    <!-- 引入MongoDB配置 -->
    <import resource="test/mongo-config.xml"/>

    <!-- 引入定时器任务配置 -->
    <!-- <import resource="classpath*:com/demo/config/spring-job.xml"/> -->

    <!-- 引入hibernate4配置 -->
    <!-- <import resource="spring-hibernate.xml"/> -->

    <!-- 引入缓存配置 -->
    <!-- <import resource="spring-cache.xml"/> -->

    <!-- 引入CXF配置 -->
    <import resource="test/spring-cxf.xml"/>

    <!-- 引入Redis配置（无需如此配置，直接使用RedisUtil即可） -->
    <!-- <import resource="test/spring-jedis.xml"/> -->
</beans>

上面内容很多，但是并不全是SSM框架的，需要关注的点只有下面几个：

1、context:component-scan 包扫描

　　这个注解不用多说了，要注意的就是主容器中不扫描@Controller注解，因为@Controller将会在SpringMVC扫描。

2、import 标签和多文件配置

　　在团队开发时候，每个人都常去改动Spring配置文件，不科学，使用这个技巧方便，每个都有各自的配置文件了。项目较大，有较多的bean时，可以将其分散到子文件中。虽然Spring还有自动扫描的功能，但我感觉也不怎么好，需要去扫描，影响性能；而且各个Bean分散在不同包中，不好配置。

　　多文件配置通常有两种做法：

　　2.1 在 web.xml配置中的contextConfigLocation节点配置多个值。

具体代码如下：

<context-param>
   <param-name>contextConfigLocation</param-name>
   <param-value>
      /WEB-INF/classes/context1.xml,
       /WEB-INF/classes/context2.xml,
       /WEB-INF/classes/context3.xml
    </param-value>
</context-param> 

　　其中分隔符可以是","也可以是" "等，也可以用通配符application-*，这样配置的要求是，你的Spring配置文件必须是applicationContext-*****.xml这样的形式存在，*号代表通配符,具体就不说了。

　   2.2 在一个application.xml中配置多个import标签引入其他文件。

　　个人喜欢这种方式，清晰明了，总得有一个主入口吧（估计受了webpack和SeaJS的影响）。

　　从这边也不难看到Spring框架在其中扮演的角色：管理容器，有效地组织你的中间层对象（无节操得集成其他框架）。

3、引入mybatis配置：spring-mybatis.xml

　　这个文件就是用来完成spring和mybatis的整合的。这里面也没多少行配置，主要的就是自动扫描，自动注入，配置数据库。注释也很详细，大家看看就明白了。

spring-mybatis.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:tx="http://www.springframework.org/schema/tx"
    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.1.xsd
    http://www.springframework.org/schema/context
    http://www.springframework.org/schema/context/spring-context-3.1.xsd
    http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.1.xsd">

    <!-- 1. 数据源配置 -->
    <context:property-placeholder ignore-unresolvable="true" location="classpath:jdbc.properties" />

    <!-- Druid方式配置数据源 -->
    <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">  

        <!-- 基本属性 url、user、password -->
        <property name="driverClassName" value="${jdbc.driverClassName}" />
        <property name="url" value="${jdbc.url}" />
        <property name="username" value="${jdbc.username}" />
        <property name="password" value="${jdbc.password}" />

        <!-- 配置初始化大小、最小、最大 -->
        <property name="initialSize" value="10" />
        <property name="minIdle" value="20" />
        <property name="maxActive" value="100" />  

        <!-- 配置获取连接等待超时的时间 -->
        <property name="maxWait" value="60000" />  

        <!-- 配置间隔多久才进行一次检测，检测需要关闭的空闲连接，单位是毫秒 -->
        <property name="timeBetweenEvictionRunsMillis" value="6000" />  

        <!-- 配置一个连接在池中最小生存的时间，单位是毫秒 -->
        <property name="minEvictableIdleTimeMillis" value="300000" />  

        <!-- 验证是否回收 -->
        <property name="validationQuery" value="SELECT 'x' FROM DUAL" />
        <property name="testWhileIdle" value="true" />
        <property name="testOnBorrow" value="false" />
        <property name="testOnReturn" value="false" /> 

        <!-- 开启Druid的监控统计功能 -->
        <property name="filters" value="stat" />
    </bean> 

    <!-- 2. 创建SqlSession的工厂 -->
    <!-- dataSource:引用数据源，统一加载配置-->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">  

        <property name="dataSource" ref="dataSource" ></property>    

        <!-- 自动配置别名-作用类似mybatis-config.xml的别名 -->
        <property name="typeAliasesPackage" value="com.demo.model" />

        <!-- 设置别名的类加上父类限定 -->
        <property name="typeAliasesSuperType" value="com.demo.common.base.BaseEntity"/>

        <!-- 当mybatis的xml文件和mapper接口不在相同包下时，需要用mapperLocations属性指定xml文件的路径 -->
        <!-- *是个通配符，代表所有的文件，**代表所有目录下 -->
        <property name="mapperLocations" value="classpath*:mappings/**/*.xml"/>

        <!-- 指定mybatis核心配置文件 -->
        <property name="configLocation" value="classpath:mybatis-config.xml"></property>
    </bean>  

    <!-- 3. 自动扫描加载Sql映射文件/接口 -->
    <bean id="mapperScannerConfigurer"  class="org.mybatis.spring.mapper.MapperScannerConfigurer">

        <!-- sqlSessionFactoryBeanName：代表延迟加载-->
        <!-- 这个配置的前提条件是：映射接口类文件(.java)和映射XML文件(.xml)需要放在相同的包下（com.demo.mapper）-->
        <!-- <property name="sqlSessionFactory" ref="sqlSessionFactory"></property> -->
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory" />

        <!-- basePackage:指定sql映射文件/接口所在的包（自动扫描）-->
        <property name="basePackage" value="com.demo.mapper"></property>

        <!-- 扫描basePackage下所有以@MyBatisDao注解的接口 -->
        <property name="annotationClass" value="com.demo.common.persistence.annotation.MyBatisDao"/>
    </bean>

    <!-- 4. 事务管理 -->
    <!-- dataSource:引用上面定义的数据源 -->
    <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource"/>
    </bean>

    <!-- 5. 使用声明式事务 -->
    <!-- transaction-manager：引用上面定义的事务管理器 -->
    <!-- 配置 Annotation 驱动，扫描@Transactional注解的类定义事务  -->
    <tx:annotation-driven transaction-manager="transactionManager" proxy-target-class="true"/>

    <!-- 定义JdbcTemplate的Bean -->
    <bean id="jdbcTemplate" class="org.springframework.jdbc.core.JdbcTemplate" p:dataSource-ref="dataSource"></bean>

</beans>

四、SpringMVC 框架配置

　　这块配置里面的注释也很详细，在此就不说了，主要是自动扫描控制器，视图模式，注解的启动这三个。

mvc-config.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:tx="http://www.springframework.org/schema/tx"
    xmlns:context="http://www.springframework.org/schema/context"
    xmlns:aop="http://www.springframework.org/schema/aop"
    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.1.xsd
    http://www.springframework.org/schema/mvc
    http://www.springframework.org/schema/mvc/spring-mvc-3.1.xsd
    http://www.springframework.org/schema/context
    http://www.springframework.org/schema/context/spring-context-3.1.xsd
    http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.1.xsd
    http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.1.xsd">

    <!-- 打开使用注解自动检测功能自动注册Bean，只扫描@Controller -->
    <context:component-scan base-package="com.demo"  use-default-filters="false">
        <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller" />
    </context:component-scan>  

    <!-- 文件上传表单的视图解析器 -->
    <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        <property name="defaultEncoding" value="utf-8"></property>
        <property name="maxUploadSize" value="2097152"></property><!--限制文件上传2M内  -->
        <property name="maxInMemorySize" value="40960"></property>
    </bean>  

    <!-- 默认的注解映射的支持 - 增加String类型中文解析 -->
    <mvc:annotation-driven>
        <mvc:message-converters>
            <bean class="org.springframework.http.converter.StringHttpMessageConverter">
                <constructor-arg value="UTF-8" />
            </bean>
        </mvc:message-converters>
    </mvc:annotation-driven>

    <!-- 使用自定义Spring拦截器 -->
    <mvc:interceptors>
      <mvc:interceptor>
            <mvc:mapping path="/**" />
            <bean class="com.demo.common.core.SpringMVCInterceptor"></bean>
        </mvc:interceptor>
    </mvc:interceptors>    

    <!-- 视图配置 -->
    <!-- 对转向页面的路径解析,指定输出视图的前后缀，controller返回的视图直接加上此前后缀 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"
        p:prefix="/project/" p:suffix=".jsp" />

</beans>

　　这部分内容也可以参考上一篇博文：《经久不衰的Spring框架：SpringMVC 统括》

五、部署与测试

　　到此，已经完成了SSM三大框架的整合了，接下来测试一下，如果成功了，那么恭喜你，如果失败了，继续调试吧，作为程序员就是不停的与BUG做斗争！

　   测试的话，无非就是新建对应的view、controller、service、mapper ，测试一下SpringMVC和Mybatis的功能，很简单，就不罗嗦了。

　　部署的话，就干到tomcat里面去，启动，访问localhost即可，也不赘述了。

　　至此，SSM三大框架的整合就完成了，在此基础上可再添加其他功能。

编后语

　　由于这只是SSM整合的文章，所以上面很多文件内容没有面面俱到，比如日志处理、socket、ws、bean定制等等，后续觉得有用得会继续放上来，请继续关注山人行博客。