Mybatis官方文档：简介和入门

简介

什么是 MyBatis？

Mybatis是一款优秀的持久层框架，它支持定制化SQL、存储过程以及高级映射。Mybatis避免了几乎所有的JDBC代码和手动设置参数以及获取结果集。Mybatis可以使用简单的XML或注解来配置和映射原生信息，将接口和Java的POJOs(Plain Old Java Objects，普通的Java对象)映射成数据库中的记录。

入门

安装

要使用Mybatis，只需将mybatis-x.x.x.jar文件置于classpath中即可。

如果使用Mavan来构建项目，则需要将下面的dependency代码置于pom.xml文件中：

<dependency>

    <groupId>org.mybatis</groupId>

    <artifactId>mybatis</artifactId>

    <version>x.x.x</version>

</dependency>

从XML中构建SqlSessionFactory

每个基于Mybatis的应用都是以一个SqlSessionFactory的实例为中心的。SqlSessionFactory的实例可以通过SqlSessionFactoryBuilder获得。而SqlSessionFactoryBuilder则可以从XML配置文件或一个预先定制的Configuration的实例构建出SqlSessionFactory的实例。

从XML文件中构建SqlSessionFactory的实例非常简单，建议使用类路径下的资源文件进行配置。但是也可以使用任意的输入流(InputStream)实例，包括字符串形式的文件路径或者file://的URL形式的文件路径来配置。Mybatis包含一个名叫Resources的工具类，它包含一些实用方法，可使从classpath或其他位置加载资源文件更加容易。

String resources = "org/mybatis/example/mybatis-config.xml";

InputStream inputStream =  Resources.getResourceAsStream(resource);

SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

XML配置文件(configuration XML)中包含了对Mybatis系统的核心设置，包含获取数据库连接实例的数据源(DataSource)和决定事务作用域和控制方式的事务管理器(TransactionManager)。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>

当然，还有很多可以在XML 文件中进行配置，上面的示例指出的则是最关键的部分。要注意 XML 头部的声明，用来验证 XML 文档正确性。environment 元素体中包含了事务管理和连接池的配置。mappers 元素则是包含一组 mapper 映射器（这些 mapper 的 XML 文件包含了 SQL 代码和映射定义信息）。

不使用 XML 构建 SqlSessionFactory

如果你更愿意直接从 Java 程序而不是 XML 文件中创建 configuration，或者创建你自己的 configuration 构建器，MyBatis 也提供了完整的配置类，提供所有和 XML 文件相同功能的配置项。

DataSource dataSource = BlogDataSourceFactory.getBlogDataSource();
TransactionFactory transactionFactory = new JdbcTransactionFactory();