MyBatis超详细介绍——入门

MyBatis入门

（本文作为学习笔记，了解更多请参考：MyBatis参考文档）

简单介绍

• MyBatis应用以SqlSessionFactory为中心，而SqlSessionFactory则是通过SqlSessionFactoryBuilder获得
• 依赖：建议使用maven来管理项目

<dependency>
  <groupId>org.mybatis</groupId>
  <artifactId>mybatis</artifactId>
  <version>x.x.x</version>
</dependency>

简单实例

• 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">
<configuration>
  <environments default="development">
    <environment id="development">
      <transactionManager type="JDBC"/>
      <dataSource type="POOLED">
        <property name="driver" value="${driver}"/>
        <property name="url" value="${url}"/>
        <property name="username" value="${username}"/>
        <property name="password" value="${password}"/>
      </dataSource>
    </environment>
  </environments>
  <mappers>
    <mapper resource="org/mybatis/example/BlogMapper.xml"/>
  </mappers>
</configuration>

• Java代码配置简单实例

DataSource dataSource = BlogDataSourceFactory.getBlogDataSource();
TransactionFactory transactionFactory = new JdbcTransactionFactory();
Environment environment = new Environment("development", transactionFactory, dataSource);
Configuration configuration = new Configuration(environment);
configuration.addMapper(BlogMapper.class);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(configuration);

作用域（scope）和生命周期

• Tip：依赖注入框架可以创建线程安全的、基于事务的 SqlSession 和映射器（mapper）并将它们直接注入到你的 bean 中，因此可以直接忽略它们的生命周期
• SqlSessionFactoryBuilder
  一旦创建了SqlSessionFactory，就不再需要它了。因此SqlSessionFactoryBuilder实例的最佳作用域是方法作用域（即局部方法变量）。
• SqlSessionFactory
  SqlSessionFactory一旦被创建就应该在应用的运行期间一直存在，因此SqlSessionFactory的最佳作用域应该是应用作用域，最简单的就是使用单例模式或者静态单例模式
• SqlSession
  SqlSession实例不是线程安全的，它不能够被线程共享，因此每个线程都该有自己的SqlSession实例。所以它的最佳作用域就是请求或者方法作用域。绝不能够将SqlSession实例的引用放在类的静态域或者类的实例变量。也绝不能将 SqlSession 实例的引用放在任何类型的管理作用域中，比如 Servlet 架构中的 HttpSession。如果你现在正在使用一种 Web 框架，要考虑 SqlSession 放在一个和 HTTP 请求对象相似的作用域中。换句话说，每次收到的 HTTP 请求，就可以打开一个 SqlSession，返回一个响应，就关闭它。你应该把这个关闭操作放到 finally 块中以确保每次都能执行关闭。
• 映射器实例（Mapper Instances）
  映射器是用来绑定映射语句的接口。映射器接口的实例是从SqlSession获得的。因此，任何映射器实例的最大作用域是和请求他们的SqlSession相同的。但是，为了更加便于管理资源，映射器实例的最佳作用域是方法作用域。用过之后即可丢弃，不需要显示的关闭映射器实例。

//映射器实例参考代码
SqlSession session = sqlSessionFactory.openSession();
try {
  //方法作用域
  BlogMapper mapper = session.getMapper(BlogMapper.class);
  // do work
} finally {
  session.close();
}