SSM三大框架的整合

好好学习，天天向上

本文已收录至我的Github仓库DayDayUP：github.com/RobodLee/DayDayUP，欢迎Star，更多文章请前往：目录导航

在Java后端开发领域，Spring+SpringMVC+MyBatis三大框架的使用尤为频繁，很多朋友学了这三个框架却不知道怎么整合起来，本文将带着大家一步步的实现三大框架的整合。我也是初学者，写作本文的目的一方面是想让大家少走点弯路，还有一方面是为了加深自己对于这三大框架的理解。整合的思路是以Spring框架为核心去整合SpringMVC和MyBatis框架。首先我们需要创建一个项目并且准备好测试用的数据库。

一.准备工作

怎么创建Maven工程我相信大家都会，我就不再赘述了，不会的朋友请自行百度。

我创建了一个叫SSMTest的项目，然后使用MySQL创建了一个叫ssmtest的数据库并且创建了一张user表，为了节省大家的时间，我将sql语句粘贴在这里：

create database ssmtest;
use ssmtest;
create table user(
id int primary key auto_increment,
name varchar(20),
age int
);

然后就需要准备好所需的jar包和配置文件，我将我的整个pom文件的内容都粘贴在这里，大家自行参考。

<?xml version="1.0" encoding="UTF-8"?>

<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/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.playman</groupId>
  <artifactId>SSMTest</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>war</packaging>

  <name>SSM Maven Webapp</name>
  <!-- FIXME change it to the project's website -->
  <url>http://www.example.com</url>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <spring.version>5.0.2.RELEASE</spring.version>
    <slf4j.version>1.6.6</slf4j.version>
    <log4j.version>1.2.12</log4j.version>
    <mysql.version>5.1.6</mysql.version>
    <mybatis.version>3.4.5</mybatis.version>
  </properties>

  <dependencies>
    <!-- spring -->
    <dependency>
      <groupId>org.aspectj</groupId>
      <artifactId>aspectjweaver</artifactId>
      <version>1.6.8</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-aop</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-web</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-test</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-tx</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-jdbc</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.12</version>
      <scope>compile</scope>
    </dependency>
    <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>${mysql.version}</version>
    </dependency>
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>servlet-api</artifactId>
      <version>2.5</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>javax.servlet.jsp</groupId>
      <artifactId>jsp-api</artifactId>
      <version>2.0</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>jstl</groupId>
      <artifactId>jstl</artifactId>
      <version>1.2</version>
    </dependency>
    <!-- log start -->
    <dependency>
      <groupId>log4j</groupId>
      <artifactId>log4j</artifactId>
      <version>${log4j.version}</version>
    </dependency>
    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-api</artifactId>
      <version>${slf4j.version}</version>
    </dependency>
    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-log4j12</artifactId>
      <version>${slf4j.version}</version>
    </dependency>
    <!-- log end -->
    <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis</artifactId>
      <version>${mybatis.version}</version>
    </dependency>

    <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis-spring</artifactId>
      <version>1.3.0</version>
    </dependency>
    <dependency>
      <groupId>c3p0</groupId>
      <artifactId>c3p0</artifactId>
      <version>0.9.1.2</version>
      <type>jar</type>
      <scope>compile</scope>
    </dependency>
  </dependencies>

  <build>
    <finalName>SSMTest</finalName>
    <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
      <plugins>
        <plugin>
          <artifactId>maven-clean-plugin</artifactId>
          <version>3.1.0</version>
        </plugin>
        <!-- see http://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_war_packaging -->
        <plugin>
          <artifactId>maven-resources-plugin</artifactId>
          <version>3.0.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-compiler-plugin</artifactId>
          <version>3.8.0</version>
        </plugin>
        <plugin>
          <artifactId>maven-surefire-plugin</artifactId>
          <version>2.22.1</version>
        </plugin>
        <plugin>
          <artifactId>maven-war-plugin</artifactId>
          <version>3.2.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-install-plugin</artifactId>
          <version>2.5.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-deploy-plugin</artifactId>
          <version>2.8.2</version>
        </plugin>
        <!--jdk编译插件-->
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-compiler-plugin</artifactId>
          <configuration>
            <source>1.8</source>
            <target>1.8</target>
            <encoding>utf-8</encoding>
          </configuration>
        </plugin>
        <!--tomcat插件-->
        <plugin>
          <groupId>org.apache.tomcat.maven</groupId>
          <!-- tomcat7的插件， 不同tomcat版本这个也不一样 -->
          <artifactId>tomcat7-maven-plugin</artifactId>
          <version>2.1</version>
          <configuration>
            <!-- 通过maven tomcat7:run运行项目时，访问项目的端口号 -->
            <port>8080</port>
            <!-- 项目访问路径  本例：localhost:9090,  如果配置的aa， 则访问路径为localhost:9090/aa-->
            <path>/ssmtest</path>
            <!-- 解决中文乱码问题 -->
            <uriEncoding>UTF-8</uriEncoding>
          </configuration>
        </plugin>
      </plugins>
    </pluginManagement>
  </build>
</project>

现在就可以将一些所需要的目录以及文件先创建好:

OK！准备工作完成了，我们就可以进行下一步了。

二．搭建 Spring框架

我这次搭建Spring框架采用了注解的方式，因为本次涉及的内容不多，所以采用注解的方式较为简单。首先我们在resources目录下新建一个applicationContext.xml文件作为Spring的配置文件，内容如下：

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

    <!-- 开启注解的扫描-->
    <context:component-scan base-package="com.robod">
        <!-- 配置哪些注解不扫描-->
        <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
    </context:component-scan>

</beans>

然后在UserServiceImpl.java中实现UserService接口中的方法，并且为其加上注解。

@Service("userService")
public class UserServiceImpl implements UserService {

    @Override
    public List<User> findAll() {
        System.out.println("现在调用了UserService中的findAll()方法");
        return null;
    }

    @Override
    public void save(List<User> users) {

    }
}

准备工作完成啦，现在我们就可以测试Spring框架搭建的有没有问题了。我们在test包下使用Junit进行单元测试，

public class TEST {

    @Test
    public void testSpring(){
		ApplicationContext ac = new ClassPathXmlApplicationContext("applicationContext.xml");
        UserService userService = ac.getBean("userService",UserService.class);
        userService.findAll();
    }
}

运行一下，看有没有结果

运行结果出现了，说明我们的Spring框架搭建的没有问题，现在就可以进行SpringMVC框架的搭建了。

三．搭建SpringMVC框架

配置SpringMVC框架首先我们需要准备好SpringMVC的配置文件，在resources目录下新建一个SpringMVC.xml文件，内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<beans  xmlns="http://www.springframework.org/schema/beans"
        xmlns:mvc="http://www.springframework.org/schema/mvc"
        xmlns:context="http://www.springframework.org/schema/context"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd">

    <!-- 1.开启注解扫描，只扫描Controller注解-->
    <context:component-scan base-package="com.robod.controller">
        <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
    </context:component-scan>

    <!-- 2.开启SpringMVC注解的支持-->
    <mvc:annotation-driven/>
</beans>

光准备好配置文件可不够，tomcat服务器在启动的时候可不会去自动加载SpringMVC.xml文件，所以我们接下来的工作就是要让tomcat在启动的时候就加载配置文件。打开webapp目录下的WEB-INF文件夹，里面有个web.xml文件，在里面配置一个前端控制器，代码如下：

  <!-- 配置前端控制器-->
  <servlet>
    <servlet-name>dispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!-- 加载SpringMVC.xml配置文件-->
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:SpringMVC.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup> <!-- 启动服务器时创建该Servlet-->
  </servlet>
  <servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>

现在就该配置路径了，打开我们在controller目录下创建的UserController.java文件

@Controller
@RequestMapping("/user")
public class UserController {

    @RequestMapping("/findAll")
    public void findAll() {
        System.out.println("UserController中的findAll()方法执行了");
    }
}

现在访问http://localhost:8080/ssmtest/user/findAll路径就可以执行findAll()方法了，启动tomcat后在浏览器中输入该路径后按回车，看一下控制台的打印：

OK，方法正常执行了，说明我们的SpringMVC框架搭建成功了，现在就可以进行Spring和SpringMVC框架的整合了。

四．Spring和SpringMVC框架的整合

终于可以开始两个框架的整合了。话不多说，让我们开始吧！

如果我们可以在controller中成功调用到service中的方法就说明我们的框架整合没有问题，之前我们在单独使用Spring的时候是手动加载Spring容器，放在这里显然不太合适，所以我们需要在tomcat一启动的时候就自动加载Spring容器，怎么办呢？我们需要在web.xml中配置监听器实现启动时加载，添加以下内容：

  <!-- Spring整合SpringMVC-->
  <!-- 配置Spring的监听器，默认只加载WEB-INF目录下的applicationContext.xml配置文件，所以需要配置文件路径 -->
  <listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
  </listener>
  <!-- 设置配置文件的路径 -->
  <context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>classpath:applicationContext.xml</param-value>
  </context-param>

现在修改UserController，在里面加入UserService，并调用UserService中的方法：

@Controller
@RequestMapping("/user")
public class UserController {

    @Autowired
    UserService userService;

    @RequestMapping("/findAll")
    public void findAll() {
        System.out.println("UserController中的findAll()方法执行了");
        userService.findAll();
    }

}

现在启动tomcat服务器，访问http://localhost:8080/ssmtest/user/findAll，看看执行结果。

很显然，我们的Spring框架和SpringMVC框架整合成功了，接下来我们就可以准备MyBatis框架了。

五．Spring框架整合MyBatis框架

本来我准备先搭建MyBatis框架，测一下有没有问题再进行整合，但是单独使用MyBatis框架需要准备配置文件，整合的时候又用不到，所以就跳过单独测试MyBatis框架，直接一边搭建一边整合。

使用过MyBatis框架的朋友们都应该知道我们在配置文件中配置了什么，无非就是配置dataSource和引入映射配置文件两件事情而已，然后在使用的时候就是创建SqlSession去初始化dao的实例。这些我们都可以将其配置到Spring的容器中去，这样就实现了Spring框架整合MyBatis框架。在applicationContext.xml文件中添加以下内容：

    <!-- Spring整合MyBatis框架 -->
    <!-- 配置连接池 -->
    <bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource">
        <property name="driverClass" value="com.mysql.jdbc.Driver"/>
        <property name="jdbcUrl" value="jdbc:mysql://127.0.0.1:3306/ssmtest"/>
        <property name="user" value="root"/>
        <property name="password" value="123456"/>
    </bean>
    <!-- 配置SqlSessionFactory工厂 -->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="dataSource" ref="dataSource" />
    </bean>
    <!-- 配置AccountDao接口所在包 -->
    <bean id="mapperScannerConfigurer" class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="com.robod.dao"/>
</bean>

这样我们就可以将其加载进Spring容器中了，接下来我们就在UserDao中加上相应的注解，并在UserServiceImpl中调用UseDao中的相应方法，然后在UserController中打印结果：

UserDao：

@Repository("userDao")
public interface UserDao {

    @Select("select * from user")
    public List<User> findAll();

    @Update("insert into user(name , age) values (#{name},#{age})")
    public void save(User user);

}

UserController：

    @RequestMapping("/findAll")
    public void findAll() {
        System.out.println("UserController中的findAll()方法执行了");
        List<User> users = userService.findAll();
        for (User user : users) {
            System.out.println(user.toString());
        }
    }

这时候我们的数据库中还没有数据，我们先随便添加几条数据，然后再启动tomcat服务器，看一下结果:

没有问题，至此我们的三大框架就整合完成啦！

六．Spring声明式事务管理

Spring中有个非常强大的功能就是声明式事务管理，我们当然不能忘了。配置Spring声明式事务管理有三个步骤，我在代码里加了注释，大家自己看，在applicationContext.xml中添加以下内容：

    <!-- 配置Spring框架声明式事务管理 -->
    <!-- (1)配置事务管理器 -->
    <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource"/>
    </bean>
    <!-- (2)配置事务通知 -->
    <tx:advice id="txAdvice" transaction-manager="transactionManager">
        <tx:attributes>
            <tx:method name="find*" read-only="true"/>
            <tx:method name="*" isolation="DEFAULT"/>
        </tx:attributes>
    </tx:advice>
    <!-- (3)配置AOP增强 -->
    <aop:config>
        <aop:advisor advice-ref="txAdvice" pointcut="execution(* com.playman.service.impl.*ServiceImpl.*(..))"/>
    </aop:config>

OK，现在我们可以来测试一下了，我在前面写了一个save方法还没用，就是准备测试声明式事务管理的。

在UserController中添加一个save方法：

    @RequestMapping("/save")
    public void saveAccounts() {
        User user1 = new User();
        user1.setId(1);
        user1.setName("li");
        user1.setAge(20);
        User user2 = new User();
        user2.setId(2);
        user2.setName("j");
        user2.setAge(25);
        List<User> accounts = new ArrayList<>();
        accounts.add(user1);
        accounts.add(user2);
        userService.save(accounts);
    }

然后将UserServiceImpl的save方法补充完整：

@Override
public void save(List<User> users) {
    User user1 = users.get(0);
    User user2 = users.get(1);
    userDao.save(user1);
    userDao.save(user2);
}

我们启动tomcat，访问http://localhost:8080/ssmtest/user/save

打开数据库可以看到，我们的save方法是没有问题的。现在为了能够看到我们的声明式事务管理是否可以正常运行，我们人为地加一点异常 ，修改UserServiceImpl的save方法：

    @Override
    public void save(List<User> users) {
        User user1 = users.get(0);
        User user2 = users.get(1);
        userDao.save(user1);
        int i = 1/0;    //如果事务没有回滚，那么应该可以正常添加一条数据
        userDao.save(user2);
    }

为了看到对比的效果，我们先把声明式事务管理的配置删除掉，再删掉数据库中我们刚才添加的数据，运行一下：

可以看到，数据库中添加了一条数据，说明再没配置事务管理前出现异常是不会回滚的，现在我们将刚才删掉的配置代码再加上，删除数据库中的信息，再运行一下：

可以看到，数据库中一条数据都没有添加，说明真的回滚了，我们的声明式事务管理就配置成功了。到现在，所有的操作就全部完成啦！

点击下载源码