MyBatis（1）入门

参考

• mybatis官网

虽然在项目中使用到了MyBatis，但只是会熟练的使用，从来也没有深入探究过，最近有了想深入学习的想法，就把学习的一些东西记录下来。按照学习的过程，本篇为demo，先把程序跑起来再说。

一、 项目搭建

1、项目结构

2、xml文件

<?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">

<!-- mybatis的核心配置文件，配置 数据源 和 事务管理 -->
<configuration>

    <!-- 加载数据库信息资源 -->
    <properties resource="jdbc.properties"/>

    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC">
            </transactionManager>
            <dataSource type="POOLED">
                <property name="driver" value="${jdbc.driver}" />
                <property name="url" value="${jdbc.url}" />
                <property name="username" value="${jdbc.username}" />
                <property name="password" value="${jdbc.password}" />
            </dataSource>
        </environment>
    </environments>

    <!-- 映射器（mappers） -->
    <mappers>
        <package name="cn.hhm.mybatisdemo.mapper"/>
    </mappers>
</configuration>

3、mapper.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.hhm.mybatisdemo.mapper.PersonMapper">

    <select id="personList" resultMap="cn.hhm.mybatisdemo.pojo.Person">
        select * from person where id = #{id}
    </select>

</mapper>

4、测试

@Test
    public void select() throws IOException {
        String resource = "sqlMapConfig-test.xml";
        InputStream in = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(in);
        SqlSession session = sqlSessionFactory.openSession();

        Person p = null;
        try {
            p = session.selectOne("cn.hhm.mybatisdemo.mapper.PersonMapper.selectPerson",1);
        } finally {
            session.close();
        }
        System.out.println(p);
    }

这样便完成了MyBatis的环境搭建，我们便可以在项目中使用MyBatis了。

二、MyBatis的基本构成

• SqlSessionFactoryBuilder：根据配置信息生成 SqlSessionFactory。
• SqlSessionFactory：生成 SqlSession 会话。
• SqlSession：包含了面向数据库执行 SQL 命令所需的所有方法。
• Mapper：由一个Java接口和XML文件（或注解）构成，需要给出对应的SQL和映射规则。它负责发送SQL去执行，并返回结果。

三、生命周期

SqlSessionFactoryBuilder

一旦创建了SqlSessionFactory，就不再需要它了，因此SqlSessionFactoryBuilder的作用域最好为方法作用域。

SqlSessionFactory

SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在，没有任何理由对它进行清除或重建。因此 SqlSessionFactory 的最佳作用域是应用作用域。有很多方法可以做到，最简单的就是使用单例模式或者静态单例模式。

SqlSession

SqlSession是线程不安全的，每个线程应该有自己的SqlSession，因此SqlSession的作用域为方法作用域，每次创建的SqlSession使用完都必须关闭它。

SqlSession session = sqlSessionFactory.openSession();
try {
  // do work
} finally {
  session.close();
}

Mapper

映射器是一个你创建来绑定你映射的语句的接口。映射器接口的实例是从 SqlSession 中获得的。因此从技术层面讲，任何映射器实例的最大作用域是和请求它们的 SqlSession 相同的。示例：

SqlSession session = sqlSessionFactory.openSession();
try {
  BlogMapper mapper = session.getMapper(BlogMapper.class);
  // do work
} finally {
  session.close();
}