2020-07-01

SSM-SSM整合

字数统计: 4.7k字 | 阅读时长: 24分

一、前言

由于在实际开发中，并不会只是单独使用SSM框架中的某一个，因此如何整合这三个框架是非常重要的。
本文主要总结如何对SSM框架进行整合。
整合说明：SSM整合可以使用多种方式，咱们会选择 XML + 注解的方式 。

二、整合的大致步骤

1、搭建整体项目环境
2、搭建spring环境
3、搭建springMVC环境
4、使用spring整合springMVC
5、搭建mybatis环境
6、使用spring整合mybatis

三、环境准备

本文使用一个和账户相关的项目，实现查询所有和添加账户的功能。

（一）创建数据库和表

create database ssm;
create table account(
    id int primary key auto_increment,
    name varchar(100),
    money double(7,2),
);

（二）创建maven工程

这个非常简单，省略。
注意一下如何解决创建maven项目较慢的情况:
在创建Maven项目时加上archetypeCatalog=internal参数，即添加如下键值对：

1 2	archetypeCatalog internal

（三）导入依赖坐标

<properties>
  <spring.version>5.0.2.RELEASE</spring.version>
  <slf4j.version>1.6.6</slf4j.version>
  <log4j.version>1.2.12</log4j.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>8.0.19</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>

（四）编写实体类

public class Account implements Serializable {

    private Integer id;
    private String name;
    private Double money;

    //setters and getters
}

（五）编写持久层接口

IAccountDao.java:

public interface IAccountDao {
    /**
    * 保存
    * @param account
    */
    void save(Account account);
    
    /**
    * 查询所有
    * @return
    */
    List<Account> findAll();
}

（六）编写业务层接口

IAccountService.java:

public interface IAccountService {
    /**
     * 查询所有账户
     * @return
     */
    List<Account> findAll();

    /**
     * 添加账户
     * @param account
     */
    void saveAccount(Account account);
}

四、搭建spring框架

（一）编写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">

    <!-- 配置 spring 创建容器时要扫描的包 -->
    <context:component-scan base-package="com.zuobiao">
       <!--制定扫包规则，不扫描@Controller 注解的 JAVA 类，其他的还是要扫描 -->
        <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
    </context:component-scan>

</beans>

（二）使用注解配置持久层和业务层

AccountDaoImpl.java:

@Repository("accountDao")
public class AccountDaoImpl implements IAccountDao {
    @Override
    public List<Account> findAllAccount() {
    	System.out.println("查询了所有账户");
    	return null;
    } 
    @Override
    public void saveAccount(Account account) {
    	System.out.println("保存了账户");
    }
}

AccountServiceImpl.java:

@Service("accountService")
public class AccountServiceImpl implements IAccountService {
    @Autowired
    private IAccountDao accountDao;
    
    @Override
    public List<Account> findAllAccount() {
    	return accountDao.findAllAccount();
    }
    
    @Override
    public void saveAccount(Account account) {
    	accountDao.saveAccount
    }
}

（三）测试spring环境能否正常运行

public class Test01Spring {
public static void main(String[] args) {
    ApplicationContext ac = new  ClassPathXmlApplicationContext("applicationContext.xml");
    IAccountService as = ac.getBean("accountService",IAccountService.class);
    as.findAllAccount();
    }
}

运行结果如下：
测试spring环境

五、搭建springMVC框架

（一）在web.xml中配置核心控制器

打开WEB-INF/web.xml文件，在该文件中配置核心控制器并且配置过滤器解决中文乱码问题，如下：

<!DOCTYPE web-app PUBLIC
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd" >

<web-app>
  <display-name>Archetype Created Web Application</display-name>

  <!--配置前端控制器-->
  <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>
    <!--服务器一启动就创建servlet对象-->
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>

  <!--解决中文乱码问题-->
  <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>
  </filter>
  <filter-mapping>
    <filter-name>characterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>
</web-app>

（二）编写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">

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

    <!--配置视图解析器-->
    <bean id="internalResourceViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/pages/"></property>
        <property name="suffix" value=".jsp"></property>
    </bean>

    <!--过滤静态资源-->
    <mvc:resources location="/css/" mapping="/css/**" />
    <mvc:resources location="/images/" mapping="/images/**" />
    <mvc:resources location="/js/" mapping="/js/**" />

    <!-- 将springmvc不能处理的请求交给tomcat -->
    <mvc:default-servlet-handler/>
    
    <!--开启springmvc注解的支持-->
    <mvc:annotation-driven/>
</beans>

（三）编写页面和controller

jsp代码：

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
    <head>
    	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    	<title>主页</title>
    </head>
    <body>
    	<a href="account/findAllAccount">访问查询账户</a>
    </body>
</html>

controller代码：

@Controller
@RequestMapping("/account")
public class AccountController {
    @RequestMapping("/findAllAccount")
    public String findAllAccount() {
        System.out.println("执行了查询账户");
        return "success";
    }
}

运行结果如下：
测试springmvc环境

六、整合SpringMVC框架

首先，我们需要知道的是如何才算整合成功呢？
其实，因为我们是需要在表现层中调用业务层对象看，因此只要我们能够在我们的controller类的方法中通过业务层对象调用业务层的方法，那么就算整合成功。
但是，由于我们的业务层对象是在我们的spring配置文件中通过bean标签配置创建的，而该配置文件目前却没有被加载，所以业务层对象是不会被创建的，ioc的容器中更不会有业务层对象，从而导致我们不能再controller中通过注入的方式使用业务层对象。
因此，整合springMVC的关键就是如何让spring的配置文件在项目被启动之后就能够被加载。
通过思考，我们肯定就会想到使用监听器。其实，解决办法就是使用监听器。实现步骤如下：

（一）配置监听器实现启动服务创建容器

在WEB-INF/web.xml文件中配置监听器，配置后的文件如下：

<!DOCTYPE web-app PUBLIC
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd" >

<web-app>
  <display-name>Archetype Created Web Application</display-name>

  <!--配置spring的监听器，在项目启动的时候，就去加载applicationContext.xml的配置文件-->
  <listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
  </listener>
  <!-- 由于该监听器只能加载 WEB-INF 目录中名称为 applicationContext.xml 的配置文件 -->
  <!-- 所以需要手动指定 spring 配置文件位置 -->
  <context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>classpath:applicationContext.xml</param-value>
  </context-param>

  <!--配置前端控制器-->
  <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>
    <!--服务器一启动就创建servlet对象-->
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>

  <!--解决中文乱码问题-->
  <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>
  </filter>
  <filter-mapping>
    <filter-name>characterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>
</web-app>

（二）在controller中注入service对象

@Controller
@RequestMapping("/account")
public class AccountController {

    @Autowired
    private IAccountService accountService;

    /**
     * 查询所有
     * @return
     */
    @RequestMapping("/findAll")
    public String findALl(){
        accountService.findAll();
        return "list";	
    }
}

七、搭建mybatis框架

（一）为IAccountDao接口添加注解

IAccountDao.java:

public interface IAccountDao {

    /**
     * 查询所有账户
     * @return
     */
    @Select("select * from account")
    List<Account> findAll();

    /**
     * 添加账户
     * @param account
     */
    @Insert("insert into account(name, money) values(#{name}, #{money})")
    void saveAccount(Account account);
}

（二）编写 SqlMapConfig 配置文件

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">

<configuration>
    <environments default="mysql">
        <environment id="mysql">
            <transactionManager type="JDBC"></transactionManager>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/ssm?serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>

    <mappers>
        <package name="com.zuobiao.dao"/>
    </mappers>
</configuration>

（三）测试mybatis环境能否正常运行

/**
 * 测试mybatis的配置
 */
public class TestMybatis {

    /**
     * 测试查询操作
     * @throws IOException
     */
    @Test
    public void test() throws IOException {
        /**
         * 1、获取配置文件的输入流
         * 2、创建factory对象
         * 3、创建SqlSession对象
         * 4、创建代理对象
         * 5、使用代理对象调用方法
         * 6、释放资源
         */
        InputStream is = Resources.getResourceAsStream("SqlMapConfig.xml");

        SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);

        SqlSession session = factory.openSession();

        IAccountDao accountDao = session.getMapper(IAccountDao.class);

        List<Account> accounts = accountDao.findAll();
        for (Account account : accounts) {
            System.out.println(account);
        }

        session.close();
        is.close();
    }
}

八、整合mybatis框架

同样，如何才算整合成功呢？
因为我们的目的是能够在service中使用dao的代理对象，那么必须确保dao代理对象能够加入到ioc容器中。但是dao的代理对象其实是通过SqlSession对象创建的，而SqlSession又是通过SqlSessionFactory对象创建而来的，因此关键就是在创建dao代理对象之前，先创建SqlSessionFactory对象，然后在通过一系列的操作，创建dao的代理对象并加入到ioc容器中。
整合思路：
把 mybatis 配置文件（SqlMapConfig.xml）中内容配置到 spring 配置文件中
因此，可通过如下步骤进行整合：
#####（一）在spring的配置文件中添加代替mybatis配置的内容
添加后的配置文件（SqlMapConfig.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: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.zuobiao">
        <!--不需要扫描Controller注解-->
        <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
    </context:component-scan>

    <!--整合mybatis的操作-->
    <!--配置连接池-->
    <bean id="comboPooledDataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource">
        <property name="driverClass" value="com.mysql.cj.jdbc.Driver"/>
        <property name="jdbcUrl" value="jdbc:mysql:///ssm?serverTimezone=UTC"/>
        <property name="user" value="root"/>
        <property name="password" value="123456"/>
    </bean>
    <!--配置SqlSessionFactory工厂对象-->
    <!--工厂对象会创建SqlSession对象，然后SqlSession对象会创建代理对象，创建完代理对象之后会存入到ioc容器中-->
    <bean id="sqlSessionFactoryBean" class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="dataSource" ref="comboPooledDataSource"></property>
    </bean>
    <!--配置需要被扫描的包（其实就是每一个dao接口）-->
    <bean id="mapperScannerConfigurer" class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="com.zuobiao.dao"></property>
    </bean>
</beans>

（二）声明事务

将事务声明添加后的配置文件（SqlMapConfig.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: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.zuobiao">
        <!--不需要扫描Controller注解-->
        <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
    </context:component-scan>

    <!--整合mybatis的操作-->
    <!--配置连接池-->
    <bean id="comboPooledDataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource">
        <property name="driverClass" value="com.mysql.cj.jdbc.Driver"/>
        <property name="jdbcUrl" value="jdbc:mysql:///ssm?serverTimezone=UTC"/>
        <property name="user" value="root"/>
        <property name="password" value="123456"/>
    </bean>
    <!--配置SqlSessionFactory工厂对象-->
    <!--工厂对象会创建SqlSession对象，然后SqlSession对象会创建代理对象，创建完代理对象之后会存入到ioc容器中-->
    <bean id="sqlSessionFactoryBean" class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="dataSource" ref="comboPooledDataSource"></property>
    </bean>
    <!--配置需要被扫描的包（其实就是每一个dao接口）-->
    <bean id="mapperScannerConfigurer" class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="com.zuobiao.dao"></property>
    </bean>

    <!--配置spring框架声明式事务管理-->
    <!--配置事务管理器-->
    <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <!--对数据源进行控制-->
        <property name="dataSource" ref="comboPooledDataSource"/>
    </bean>
    <!--配置事务通知-->
    <tx:advice id="txAdvice" transaction-manager="transactionManager">
        <tx:attributes>
            <tx:method name="find*" read-only="true"/>
            <tx:method name="*" read-only="false" isolation="DEFAULT"/>
        </tx:attributes>
    </tx:advice>
    <!--配置aop增强-->
    <aop:config>
        <aop:advisor advice-ref="txAdvice" pointcut="execution(* com.zuobiao.service.impl.*.*(..))"/>
    </aop:config>
</beans>

九、测试整合效果

（一）整合后的项目结构如下：

项目结构

（二）测试

1、index.jsp

在webapp目录下，有一个index.jsp：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
    <a href="account/findAll">查询所有</a>

    <br/><br/>

    <form method="post" action="account/saveAccount">
        姓 名：<input type="text" name="name"><br/>
        金 额：<input type="text" name="money"><br/>
        <input type="submit" value="保存">
    </form>
</body>
</html>

2、AccountController.java

对AccountController类中的代码进行如下调整：

@Controller
@RequestMapping("/account")
public class AccountController {

    @Autowired
    private IAccountService accountService;

    /**
     * 查询所有
     * @param model
     * @return
     */
    @RequestMapping("/findAll")
    public String findALl(Model model){
        System.out.println("视图层：查询所有...");
        List<Account> accounts = accountService.findAll();
        //存入到request域中
        model.addAttribute("accounts",accounts);
        return "list";
    }

    /**
     * 保存账户
     */
    @RequestMapping("/saveAccount")
    public void saveAccount(Account account, HttpServletRequest request, HttpServletResponse response){
        accountService.saveAccount(account);
        try {
            response.sendRedirect(request.getContextPath() + "/account/findAll");
        } catch (IOException e) {
            e.printStackTrace();
        }
        return;
    }
}

3、AccountServiceImpl.java

对AccountServiceImpl类中的代码进行如下调整：

@Service("accountService")
public class AccountServiceImpl implements IAccountService {

    @Autowired
    private IAccountDao accountDao;

    @Override
    public List<Account> findAll() {
        System.out.println("业务层：查询所有...");
        return accountDao.findAll();
    }

    @Override
    public void saveAccount(Account account) {
        System.out.println("业务层：保存账户...");
        accountDao.saveAccount(account);
    }
}

4、list.jsp

代码如下：

<%@ page contentType="text/html;charset=UTF-8" language="java" isELIgnored="false" %>
<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
    <c:forEach items="${accounts}" var="account">
        ${account.name }
    </c:forEach>
</body>
</html>