什么是MyBatis映射器?

MyBatis框架包括两种类型的XML文件,一类是配置文件,即mybatis-config.xml,另外一类是映射文件,例如XXXMapper.xml等。在 MyBatis的配置文件mybatis-config.xml 包含了<mappers></mappers>节点,这里就是MyBatis映射器。

1、MyBatis映射器发展历史简介

映射器是MyBatis中最核心的组件之一,在MyBatis 3之前,只支持XML映射器,所有的SQL语句都必须在XML文件中配置。而从MyBatis 3开始,开始支持接口映射器,其底层利用的是接口绑定技术(注:面试中经常会问到的一个知识点,见下文5.1项介绍)。另外,接口映射器允许通过注解定义SQL语句,用以替代XML文件配置SQL。

2、MyBatis映射器分类

MyBatis映射器分为三类,如下所示:

(1)纯xml映射器,利用SqlSession的各种方法实现增删改查。例如:

Person p = session.selectOne("cn.mybatis.mydemo.mapper.PersonMapper.selectPersonById", 1);

(2)xml映射器+接口映射器的混合类型

先定义接口映射器,然后再定义xml映射器,其中xml映射器的namespace应该对应接口映射器的类名。其用法如下:

PersonMapper pm = session.getMapper(PersonMapper.class);
// 直接调用接口的方法,查询id为1的Peson数据
Person p2 = pm.selectPersonById(1);

(3)注解+接口映射器的混合形式

此类形式,将原先xml里面的sql配置信息,变成Java注解的形式写到接口映射器,用法与上面的例子雷同。

3、引入映射器的三种方式

3.1、通过文件类路径引入XML映射器

<mappers>
 <mapper resource="cn/mybatis/mydemo/mapper/StudentMapper.xml"/>
</mappers>

3.2、通过包名引入映射器接口

<mappers>
    <package name="cn.mybatis.mydemo.mapper" />
</mappers>

3.3、用类注册引入映射器接口

<mappers>
    <mapper class="cn.mybatis.mydemo.mapper.StudentMapper"/>
</mappers>

3.4、更多介绍请查看官网文档

mybatis 映射器(mappers)的引入方式

官网文档提到了四种引入方式,其实最常用的就是本文所列的以上三种形式。

4、准备工作

先用以下SQL语句创建student表。

CREATE TABLE `student` (
    `id` bigint(20) NOT NULL,
    `name` varchar(20) DEFAULT NULL,
    `address` varchar(20) DEFAULT NULL,
    PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

然后,定义一个 POJO,如下所示。

public class Student {
    private Long id;
    private String name;
    private String address;
    
    /**setter and getter**/
}

5、XML映射器+接口映射器

用XML定义映射器分为两个部分:接口定义和XML配置。先定义一个映射器接口,如下所示。

public interface StudentMapper {
    public Student getStudent(Long id);
}

注意:映射器只是一个接口,而不是一个实现类。初学者可能会产生一个很大的疑问:接口不是不能运行吗?的确,接口不能直接运行,但是MyBatis内部运用了动态代理技术,生成接口的实现类,从而完成接口的相关功能。只要明白 MyBatis 会为这个接口生成一个代理对象,代理对象会去处理映射器接口相关的逻辑即可。

然后,用XML方式创建映射器,如下所示:

<?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="cn.mybatis.mydemo.mapper.StudentMapper">
    <select id="getStudent" parameterType="long" resultType="student">
        SELECT id,name,address FROM Student WHERE id =#{id}
    </select>
</mapper>

有了这两个文件,就完成了一个映射器的定义。关于XML文件内容介绍,如下所示:

(1)<mapper> 元素中的属性 namespace 所对应的是一个接口的全限定名,于是 MyBatis 上下文就可以通过它找到对应的接口。

(2)<select> 元素表明这是一条查询语句,而属性 id 标识了这条 SQL,属性 parameterType="long" 说明传递给 SQL 的是一个 long 型的参数,而 resultType="student" 表示返回的是一个 Student 类型的返回值。而 student是配置文件 mybatis-config.xml 配置的别名,指代的是 com.mybatis.domain.Student。这条 SQL 中的 #{id} 表示传递进去的参数。

注意:我们并没有配置 SQL 执行后和 Student 的对应关系,它是如何映射的呢?其实,这里采用的是一种被称为自动映射的功能,MyBatis在默认情况下提供自动映射,只要SQL返回的列名能和POJO的属性对应起来即可。

最后,在MyBatis的配置文件里面引入这个XML映射器文件:

<mapper resource="cn/mybatis/mydemo/mapper/StudentMapper.xml" />

5.1、接口绑定

接口绑定,就是在MyBatis中任意定义接口,然后把接口里面的方法和SQL语句绑定,我们直接调用接口方法就可以,这样比起原来了SqlSession提供的方法,可以有更加灵活的选择和设置。

接口绑定有两种实现方式,一种是通过注解绑定,就是在接口的方法上面加上 @Select、@Update等注解,里面包含Sql语句来绑定;另外一种就是通过xml里面写SQL来绑定,在这种情况下,要指定xml映射文件里面的namespace必须为接口的全路径名。

当Sql语句比较简单时候,用注解绑定,当SQL语句比较复杂时候,用xml绑定。一般情况下,用xml绑定的比较多。

使用MyBatis的mapper接口调用时要注意的事项有:

(1)Mapper接口方法名和mapper.xml中定义的每个sql的id相同;

(2)Mapper接口方法的输入参数类型和mapper.xml中定义的每个sql 的parameterType的类型相同;

(3)Mapper接口方法的输出参数类型和mapper.xml中定义的每个sql的resultType的类型相同;

(4)Mapper.xml文件中的namespace即是mapper接口的类路径。

5.2、参考

MyBatis常见面试题9:什么是MyBatis的接口绑定?有哪些实现方式?

6、注解+接口映射器

除 XML方式定义映射器外,还可以采用注解方式定义映射器,它只需要一个接口就可以通过 MyBatis 的注解来注入 SQL,如下所示。

public interface StudentMapper2 {
    @Select("select id,name,address from student where id=#{id}")
    public Student getStudent(Long id);
}

注解方式完全等同于XML方式创建映射器,但是使用注解的方式比XML方式要简单得多。如果注解方式和XML方式同时定义时,XML 方式将覆盖掉注解方式,一般情况下,MyBatis官方推荐使用的是XML方式,因为XML映射器能完成更复杂的SQL功能。

这个接口可以在 XML 中定义,如下所示:

<mappers>
    <mapper class="cn.mybatis.mydemo.mapper.StudentMapper"/>
</mappers>

7、映射器的使用方法

映射器的使用有两种方式,一种方式是直接利用SqlSession进行数据库操作,另外一种方式是SqlSession返回映射器Mapper,利用映射器来执行数据库操作。如下所示:

public class App
{
    public static void main(String[] args) throws Exception
    {
        // 读取mybatis-config.xml文件
        InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");

        // 初始化mybatis,创建SqlSessionFactory类的实例
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

        // 创建Session实例
        SqlSession session = sqlSessionFactory.openSession();

        // 操作数据库方法一:获得xml映射文件中定义的操作语句
        Student s = session.selectOne("cn.mybatis.mydemo.mapper.StudentMapper.getStudent", 1);
        // 打印Student对象
        System.out.println(s);

        // 操作数据库方法二:获得mapper接口的代理对象
        StudentMapper sm = session.getMapper(StudentMapper.class);
        // 直接调用接口的方法,查询id为1的Student数据
        Student s2 = sm.getStudent(1);
        // 打印Peson对象
        System.out.println(s2);

        // 提交事务
        session.commit();
        // 关闭Session
        session.close();
    }
}

添加新评论