学学MyBatis（一）

MyBatis是apache的一个开源项目，原名ibatis，它是如今流行的orm框架之一，都说它很优雅，现在我来一探究竟。

入门

使用mybatis只需将mybatis-x.x.x.jar文件引入就行，如果是maven，则添加依赖：

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

SqlSessionFactory

每个基于mybatis的应用都是以一个sqlsessionfactory的实例为中心的。SqlSessionFactory的实例当然可以由SqlSessionFactoryBuilder来获得。SqlSessionFactoryBuilder可以从XML配置文件或一个预先定制的Configuration的实例构建出SqlSessionFactory。

String resource = "org/mybatis/example/mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

XML配置文件包含了对MyBatis系统的核心设置，包含DataSource、TransactionManager。如下是一个简单的例子：

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

上文提及了如何获取SqlSessionFactory，我们可以从Sqlsessionfactory中获得SqlSession实例了：

SqlSession session = sqlSessionFactory.openSession();
try{
  Blog blog = (Blog)session.selectOne("org.mybatis.example.BlogMapper.selectBlog",101);
}finally{
session.close();
}

不过我更喜欢这种方式：

SqlSession session = sqlSessionFactory.openSession();
try{
BolgMapper mapper = session.getMapper(BlogMapper.class);
Blog blog = mapper.selectBlog(101);
}finally{
session.close();
}

前一种方式里的"org.mybatis.example.BlogMapper.selectBlog"是直接映射在Mapper类中的相匹配的方法名的，这样就可以调用这个对应Mapper接口的方法。而第二种方法不是基于字符串常量，会更安全。
也可以在Mapper接口里采用注解：

package org.mybatis.example;
public interface BlogMapper {
  @Select("SELECT * FROM blog WHERE id = #{id}")
  Blog selectBlog(int id);
}

但是稍微复杂的sql语句还是在xml里配置比较好。

下面说说SqlSessionFactoryBuilder、SqlSessionFactory、SqlSession、Mapper 实例的生命周期。

SqlSessionFactoryBuilder
这个类可以被实例化、使用和丢弃。一旦创建了SqlSessionFactory之后就不再需要它了。因此，它的实例的最佳范围是方法范围，也就是本地方法变量。

SqlSessionFactory
SqlSessionFactory一旦被创建就应该在应用的运行期间一直存在，并且不要重复创建，因此，使用单例模式或静态单例模式是很好的选择。

SqlSession
每个线程都有自己的SqlSession实例，因此它是线程不安全的。所以它的最佳范围是请求或方法范围。类似HTTP请求吧。每次收到一个HTTP请求就打开一个SqlSession，返回响应之后一定要关闭SqlSession，最好是使用finally块关闭SqlSession。

Mapper实例

映射器实例是创建用来绑定映射语句的接口。它是从SqlSession中获得的，因此，它的最大范围应该是和SqlSession相同的。