Spring集成MyBatis的使用-使用Mapper映射器 _MyBATIS

愿君学长松，慎勿作桃李。这篇文章主要讲述Spring集成MyBatis的使用-使用Mapper映射器相关的知识，希望能为你提供帮助。
Spring集成MyBatis使用
前面复习MyBatis时，发现在测试时，需要手动创建sqlSessionFactory，Spring将帮忙自动创建sqlSessionFactory，并且将自动扫描Mapper映射器
(1)集成步骤
step1 导包: spring-webmvc, mybatis, mybatis-spring, dbcp, ojdbc, spring-jdbc, junit, mysql相关等

< dependencies> < !--导入junit测试包--> < dependency> < groupId> junit< /groupId> < artifactId> junit< /artifactId> < version> 4.12< /version> < /dependency> < dependency> < groupId> junit< /groupId> < artifactId> junit< /artifactId> < version> 4.12< /version> < classifier> sources< /classifier> < /dependency> < dependency> < groupId> junit< /groupId> < artifactId> junit< /artifactId> < version> 4.12< /version> < classifier> javadoc< /classifier> < /dependency> < !-- 导入数据库包 --> < dependency> < groupId> commons-dbcp< /groupId> < artifactId> commons-dbcp< /artifactId> < version> 1.4< /version> < /dependency> < dependency> < groupId> com.oracle< /groupId> < artifactId> ojdbc6< /artifactId> < version> 11.2.0.1.0< /version> < /dependency> < !-- 导入mybatis的包 --> < dependency> < groupId> org.mybatis< /groupId> < artifactId> mybatis< /artifactId> < version> 3.4.0< /version> < /dependency> < dependency> < groupId> org.mybatis< /groupId> < artifactId> mybatis< /artifactId> < version> 3.2.8< /version> < classifier> sources< /classifier> < /dependency> < dependency> < groupId> org.mybatis< /groupId> < artifactId> mybatis< /artifactId> < version> 3.2.8< /version> < classifier> javadoc< /classifier> < /dependency> < !-- 针对mysql的导包 --> < dependency> < groupId> org.wisdom-framework< /groupId> < artifactId> mysql-connector-java< /artifactId> < version> 5.1.34_1< /version> < /dependency> < !-- 导入spring-webmvc的jar包 --> < dependency> < groupId> org.springframework< /groupId> < artifactId> spring-webmvc< /artifactId> < version> 4.2.3.RELEASE< /version> < /dependency> < dependency> < groupId> org.springframework< /groupId> < artifactId> spring-webmvc< /artifactId> < version> 4.2.3.RELEASE< /version> < classifier> sources< /classifier> < /dependency> < dependency> < groupId> org.springframework< /groupId> < artifactId> spring-webmvc< /artifactId> < version> 4.2.3.RELEASE< /version> < classifier> javadoc< /classifier> < /dependency> < !-- 针对spring JDBC导包 --> < dependency> < groupId> org.springframework< /groupId> < artifactId> spring-jdbc< /artifactId> < version> 4.2.3.RELEASE< /version> < /dependency> < dependency> < groupId> org.springframework< /groupId> < artifactId> spring-jdbc< /artifactId> < version> 4.2.3.RELEASE< /version> < classifier> sources< /classifier> < /dependency> < dependency> < groupId> org.springframework< /groupId> < artifactId> spring-jdbc< /artifactId> < version> 4.2.3.RELEASE< /version> < classifier> javadoc< /classifier> < /dependency> < !-- 关键：导入mybatis-spring --> < dependency> < groupId> org.mybatis< /groupId> < artifactId> mybatis-spring< /artifactId> < version> 1.3.2< /version> < /dependency> < dependency> < groupId> org.mybatis< /groupId> < artifactId> mybatis-spring< /artifactId> < version> 1.3.2< /version> < classifier> sources< /classifier> < /dependency> < dependency> < groupId> org.mybatis< /groupId> < artifactId> mybatis-spring< /artifactId> < version> 1.3.2< /version> < classifier> javadoc< /classifier> < /dependency> < /dependencies>

注意：导包可能出现版本不兼容的问题，可以参考博客建议，暂时没找着链接
step2 添加spring配置文件，不再需要MyBatis的配置文件

< ?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:util="http://www.springframework.org/schema/util" xmlns:jee="http://www.springframework.org /schema/jee" xmlns:tx="http://www.springframework.org/schema/tx" xmlns:jpa="http://www.springframework.org/schema/data/jpa" 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.2.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.2.xsd http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-3.2.xsd http://www.springframework.org/schema/jee http://www.springframework.org/schema/jee/spring-jee-3.2.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.2.xsd http://www.springframework.org/schema/data/jpa http://www.springframework.org/schema/data/jpa/spring-jpa-1.3.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd"> < !-- 配置连接池 --> < !-- 读取属性文件 --> < util:properties id="db" location="classpath:config.properties"> < /util:properties> < !-- 配置连接池,可以参考DBUtil的方法，这里采用spring创建连接池--> < !-- destroy-method方法作用是：当spring容器关闭后，会将连接释放回到连接池，避免资源浪费 --> < bean id="ds" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close"> < property name="driverClassName" value="https://www.songbingjia.com/android/#{db.driver}"/> < property name="url" value="https://www.songbingjia.com/android/#{db.url}" /> < property name="username" value="https://www.songbingjia.com/android/#{db.user}" /> < property name="password" value="https://www.songbingjia.com/android/#{db.pwd}" /> < /bean> < !-- 配置SqlSessionFactoryBean --> < bean id="ssfb" class="org.mybatis.spring.SqlSessionFactoryBean"> < !-- 指定连接资源 --> < property name="dataSource" ref="ds"/> < !-- 指定映射文件:entity包下的所有后缀xml的映射文件 --> < property name="mapperLocations" value="https://www.songbingjia.com/android/classpath:entity/*.xml"/> < /bean> < !-- 配置MapperScannerConfigurer --> < bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> < !-- 注入映射器所在的包名 --> < property name="basePackage" value="https://www.songbingjia.com/android/dao"/> < !-- 只扫描有特定注解的接口 --> < property name="annotationClass" value="https://www.songbingjia.com/android/annotations.MyBatisRepository" /> < /bean> < /beans>

可以在spring配置文件中，添加SqlSessionFactoryBean来代替单独使用MyBatis时，需要加载sqlMapConfig.xml。MyBatis创建sqlSessionFactory时，会加载这个配置文件，完成初始化连接池，以及读取映射文件后将sql预编译后存入一个Map集合两项工作，配置sqlSessionFactoryBean也完成了上述两项工作，其主要交给Spring来自动完成。
step3 写实体类，属性名和表格的字段名一样

public class Employee { private int id; private String name; private int age; public int getId() { return id; } public void setId(int id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public int getAge() { return age; } public void setAge(int age) { this.age = age; }@Override public String toString() { return "Employee [id=" + id + ", name=" + name + ", age=" + age + "]"; } }

step4 写了具体sql的xml映射文件，跟MyBatis写法一样，要注意的是namespace是mapper映射器的包名+类名

< ?xml version="1.0" encoding="UTF-8"?> < !DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> < mapper namespace="dao.EmployeeDAO"> < !-- id要求唯一 parameterType:填写实体类的完整名字 --> < !-- 插入语句 --> < insert id="save" parameterType="entity.Employee"> INSERT INTO T_TABLE VALUES(6,#{name},#{age}) < /insert> < !-- 根据id查询语句 --> < select id="findByID" parameterType="int" resultType="entity.Employee"> SELECT * FROM T_TABLE WHERE ID=#{id} < /select> < !-- 查询所有结果,不需要参数类型 --> < select id="findAll" resultType="entity.Employee"> SELECT * FROM T_TABLE < /select> < !-- 修改操作 --> < update id="modify" parameterType="entity.Employee"> UPDATE T_TABLE SET NAME=#{name},AGE=#{age} WHERE ID=#{id} < /update> < !-- 删除操作 --> < delete id="delete" parameterType="int"> DELETE FROM T_TABLE WHERE ID=#{ididid} < /delete> < !-- 返回map类型的结果 --> < !-- 也可以将返回结果简写成map，map即为java.util.Map --> < select id="findOne" parameterType="int" resultType="java.util.Map"> SELECT * FROM T_TABLE WHERE ID=#{id} < /select> < !-- 使用resultMap解决表的字段名和实体类的属性名不一致的情况 --> < resultMap id="resultMapID" type="entity.NewEmployee"> < result property="empID" column="id" /> < result property="empName" column="name" /> < result property="empAge" column="age" /> < /resultMap> < select id="findOneByNewEmp" parameterType="int" resultMap="resultMapID"> SELECT * FROM T_TABLE WHERE ID=#{id} < /select> < /mapper>

step5 Mapper映射器：一个接口，里面写好了方法，跟MyBatis配置时一样，主要目的为调用方法时能依据命名空间和其他约束条件找到对应的sql

import java.util.List; import java.util.Map; import org.springframework.stereotype.Repository; import annotations.MyBatisRepository; import entity.Employee; import entity.NewEmployee; /** * Mapper映射器 * @author clyang */ @Repository("empDAO") @MyBatisRepository public interface EmployeeDAO {//将一条数据插入数据库 public void save(Employee e); //查询所有结果 public List< Employee> findAll(); //根据id来查找结果 public Employee findByID(int id); //修改操作 public void modify(Employee e); //删除操作 public void delete(int id); //返回类型为map的查询，根据id来查询 public Map findOne(int id); //当表的字段名和实体类的属性名不一致时，根据id来查询 public NewEmployee findOneByNewEmp(int id); }

step6 配置MapperScannerConfigurer
配置参考上上图
该bean会扫描指定包及其子包下面的所有mapper映射器(即接口)，并调用session.getMapper()方法获得映射器的具体实现，比如MyBatis例子中的EmployeeDAO dao=session.getMapper(EmployeeDAO.class)，并且将这些实现后的对象添加到spring容器中，对应的bean id为接口首字母小写，可以使用repository("别名")来，重命名bean id，方便业务层调用。
测试代码：

import java.util.List; import org.junit.Test; import org.springframework.context.ApplicationContext; import org.springframework.context.support.ClassPathXmlApplicationContext; import dao.EmployeeDAO; import entity.Employee; public class testCase { @Test public void test1() { //启动spring容器 String config="spring-mybatis.xml"; ApplicationContext ac=new ClassPathXmlApplicationContext(config); //调用mapper映射器实现类对象 EmployeeDAO dao=ac.getBean("empDAO",EmployeeDAO.class); //调用查询方法 List< Employee> list=dao.findAll(); System.out.println(list); //不需要手动关闭连接 }//下面略去 }

测试时只要启动Spring容器，Spring会根据配置自动完成MyBatis中需要手动完成的工作，如得到一个sqlSession，创建一个Mapper映射器具体实现对象。
Spring容器实现Mapper映射器具体实现，采用了接口指向对象，这为Java多态的使用，根据接口具体实现方法的不同，实现方法动态调度
测试结果：

文章图片

（2）只扫描特定的接口
为什么只扫描特定的接口，因为dao下的Mapper映射器接口，有些可能不是采用MyBatis来实现连接，可能采用其它的连接方式，如果是JDBC实现的dao类，也会被MapperScannerConfigure扫描到，但是扫描到后无法使用，会导致程序报错，为了解决这个问题，需要做到只扫描特定的接口
方法：
step1 开发一个注解，注解只是一个标识，代表只扫描它，其他的的不扫描